Platform ng Developer ng Mariner GPS Tools

Mga limitasyon at pagpapatunay

May rate limit ang mga pampublikong API at MCP call. Bineberipika ang input bago magkalkula, kabilang ang mga sinusuportahang unit ng bilis, may-hangganang numerong halaga, at mga saklaw ng latitude o longitude.

Mga limitasyon ng kahilingan

Ang mga katawan ng kahilingan ng JSON ay limitado sa16 KiB. Ang mga input ay pinapatunayan bago ang pagkalkula, kabilang ang mga sinusuportahang unit, may hangganan na mga halaga ng numero, hindi inaasahang mga field, at wastong latitude at longitude na hanay.

Pampublikong API index

GET /api/v1ay magagamit nang walang pagpapatotoo at nagbibigay ng pangunahing impormasyon ng API. Nangangailangan ng wastong API key ang pagtuklas ng tool, mga kalkulasyon, at MCP.

Mga pagkakamali

Ang mga error na REST ay nagbabalik ng isang matatag na code na nababasa ng makina kasama ng isang mensaheng nababasa ng tao. Ang MCP transport error ay gumagamit ng JSON-RPC formatting at kasama ang Mariner GPS Tools error code saerror.data.code.

REST errorjson

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

400invalid_requestAng nilalaman ng kahilingan o isa sa mga field nito ay hindi wasto.

401unauthorizedAng API key ay nawawala, mali ang pagkakabuo, binawi, o hindi nakilala.

403forbiddenAng API key ay walang kinakailangang saklaw.

404not_foundAng hiniling na endpoint ay wala.

413payload_too_largeAng katawan ng kahilingan ay lumampas sa 16 KiB.

415unsupported_media_typeAng endpoint ay nangangailangan ng isang application/json kahilingan.

429rate_limitedNaabot na ang limitasyon sa kahilingan. Subukan muli sa ilang sandali.

500internal_errorHindi makumpleto ng serbisyo ang kahilingan.