Platform ng Agent at API ng Mariner GPS Tools

Mga limitasyon at pagpapatunay

Bineberipika ng Mariner GPS Tools ang mga kahilingan bago magkalkula at nagbabalik ng pare-pareho at machine-readable na mga error kapag hindi makumpleto ang isang kahilingan.

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.