Road User Tools エージェント & API プラットフォーム

制限と検証

Road User Tools は計算前にリクエストを検証し、リクエストを完了できない場合は一貫した機械可読エラーを返します。

リクエスト制限

JSON リクエストボディは以下に限定されます16 KiB. 対応する単位、有限の数値、想定外のフィールド、0以上の距離などの値の範囲を含め、入力は計算前に検証されます。

GET /api/v1は認証なしで利用でき、基本的な API 情報を提供します。ツールの検出、計算、および MCP リクエストには、有効な API キーが必要です。

REST エラーは、人が読めるメッセージとともに、機械が読める安定したコードを返します。MCP トランスポートエラーは JSON-RPC 形式を使用し、Road User Tools のエラーコードは次のフィールドに含まれます:error.data.code.

RESTエラーjson

{
  "ok": false,
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again shortly."
  }
}

400invalid_requestリクエストの本文またはそのフィールドの 1 つが無効です。

401unauthorizedAPI キーが見つからないか、形式が不正であるか、取り消されているか、認識されません。

403forbiddenAPI キーには必要なスコープがありません。

404not_found要求されたエンドポイントは存在しません。

413payload_too_largeリクエストボディが16 KiBを超えています。

415unsupported_media_typeエンドポイントには、 application/json リクエスト。

429rate_limitedリクエストの制限に達しました。しばらくしてからもう一度お試しください。

500internal_errorサービスはリクエストを完了できませんでした。