Road User Tools -agentti- ja API-alusta

Rajoitukset ja validointi

Road User Tools tarkistaa pyynnöt ennen laskentaa ja palauttaa johdonmukaisia, koneellisesti luettavia virheitä, kun pyyntöä ei voida suorittaa.

Pyyntörajat

JSON-pyyntöelimet ovat rajoitettuja16 KiB. Syötteet tarkistetaan ennen laskentaa, mukaan lukien tuetut yksiköt, äärelliset numeeriset arvot, odottamattomat kentät ja arvoalueet, kuten ei-negatiiviset etäisyydet.

Julkinen API-indeksi

GET /api/v1on saatavana ilman todennusta ja tarjoaa API-perustiedot. Työkalun etsintä, laskelmat ja MCP-pyynnöt vaativat kelvollisen API-avaimen.

Virheet

REST-virheet palauttavat vakaan koneellisesti luettavan koodin ihmisen luettavan viestin rinnalle. MCP-siirtovirheet käyttävät JSON-RPC-muotoilua ja sisältävät Road User Tools -virhekoodin kentässäerror.data.code.

REST virhejson

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

400invalid_requestPyynnön runko tai jokin sen kentistä on virheellinen.

401unauthorizedAPI-avain puuttuu, on virheellisesti muotoiltu, peruutettu tai sitä ei tunnisteta.

403forbiddenAPI-avaimella ei ole vaadittua kaukosäädintä.

404not_foundPyydettyä päätepistettä ei ole olemassa.

413payload_too_largePyynnön runko on suurempi kuin 16 KiB.

415unsupported_media_typePäätepiste vaatii an application/json pyytää.

429rate_limitedPyyntöraja on saavutettu. Yritä hetken kuluttua uudelleen.

500internal_errorPalvelu ei voinut suorittaa pyyntöä loppuun.