Piattaforma per agenti e API Road User Tools

Limiti e convalida

Road User Tools convalida le richieste prima del calcolo e restituisce errori coerenti e leggibili dalle macchine quando una richiesta non può essere completata.

Limiti della richiesta

Gli enti richiedenti JSON sono limitati a16 KiB. Gli input vengono convalidati prima del calcolo, incluse le unità supportate, i valori numerici finiti, i campi imprevisti e gli intervalli di valori come le distanze non negative.

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 Road User 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.