Piattaforma per sviluppatori Mariner GPS Tools

Limiti e convalida

Le chiamate API pubbliche e MCP sono soggette a limiti di frequenza. Gli input vengono convalidati prima del calcolo, incluse le unità di velocità supportate, i valori numerici finiti e gli intervalli di latitudine o longitudine.

Limiti della richiesta

Gli enti richiedenti JSON sono limitati a16 KiB. Gli input vengono convalidati prima del calcolo, comprese le unità supportate, i valori numerici finiti, i campi imprevisti e gli intervalli validi di latitudine e longitudine.

Indice pubblico API

GET /api/v1è disponibile senza autenticazione e fornisce informazioni API di base. Il rilevamento degli strumenti, i calcoli e le richieste MCP richiedono una chiave API valida.

Errori

Gli errori REST restituiscono un codice stabile leggibile dalla macchina insieme a un messaggio leggibile dall'uomo. Gli errori di trasporto MCP utilizzano la formattazione JSON-RPC e includono il codice di errore Mariner GPS Tools inerror.data.code.

Errore RESTjson

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

400invalid_requestIl corpo della richiesta o uno dei suoi campi non è valido.

401unauthorizedLa chiave API è mancante, non valida, revocata o non riconosciuta.

403forbiddenLa chiave API non ha l'ambito richiesto.

404not_foundL'endpoint richiesto non esiste.

413payload_too_largeIl corpo della richiesta supera 16 KiB.

415unsupported_media_typeL'endpoint richiede un file application/json richiesta.

429rate_limitedÈ stato raggiunto il limite di richieste. Riprova a breve.

500internal_errorIl servizio non è riuscito a completare la richiesta.