Road User Tools agent- en API-platform

Limieten en validatie

Road User Tools valideert verzoeken vóór de berekening en geeft consistente, machineleesbare fouten terug wanneer een verzoek niet kan worden voltooid.

Limieten aanvragen

JSON-verzoekinstanties zijn beperkt tot16 KiB. Invoer wordt vóór de berekening gevalideerd, waaronder ondersteunde eenheden, eindige numerieke waarden, onverwachte velden en waardebereiken zoals niet-negatieve afstanden.

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