Mariner GPS Tools-ontwikkelaarsplatform

Limieten en validatie

Voor openbare API- en MCP-aanroepen geldt een snelheidslimiet. Invoer wordt vóór de berekening gevalideerd, waaronder ondersteunde snelheidseenheden, eindige numerieke waarden en bereiken voor breedte- en lengtegraad.

Limieten aanvragen

JSON-verzoekinstanties zijn beperkt tot16 KiB. Invoer wordt vóór de berekening gevalideerd, inclusief ondersteunde eenheden, eindige numerieke waarden, onverwachte velden en geldige lengte- en breedtegraden.

Openbare API-index

GET /api/v1is beschikbaar zonder authenticatie en biedt basis API-informatie. Voor het ontdekken van gereedschappen, berekeningen en MCP-aanvragen is een geldige API-sleutel vereist.

Fouten

REST-fouten retourneren een stabiele, machinaal leesbare code naast een voor mensen leesbaar bericht. MCP-transportfouten gebruiken de JSON-RPC-opmaak en bevatten de Mariner GPS Tools-foutcode inerror.data.code.

REST-foutjson

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

400invalid_requestDe aanvraagtekst of een van de velden ervan is ongeldig.

401unauthorizedDe API-sleutel ontbreekt, is verkeerd ingedeeld, ingetrokken of wordt niet herkend.

403forbiddenDe sleutel API heeft niet het vereiste bereik.

404not_foundHet aangevraagde eindpunt bestaat niet.

413payload_too_largeDe aanvraagtekst overschrijdt 16 KiB.

415unsupported_media_typeHet eindpunt vereist een application/json verzoek.

429rate_limitedDe verzoeklimiet is bereikt. Probeer het binnenkort opnieuw.

500internal_errorDe service kon het verzoek niet voltooien.