Mariner GPS Tools 開発者プラットフォーム

制限と検証

公開 API と MCP の呼び出しにはレート制限があります。対応する速度単位、有限の数値、緯度・経度の範囲など、入力は計算前に検証されます。

リクエスト制限

JSON リクエストボディは以下に限定されます16 KiB. サポートされている単位、有限の数値、予期しないフィールド、有効な緯度と経度の範囲などの入力は、計算前に検証されます。

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

REST エラーは、人が読めるメッセージとともに、機械が読める安定したコードを返します。MCP トランスポートエラーは JSON-RPC 形式を使用し、Mariner GPS 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サービスはリクエストを完了できませんでした。