Platform ng Agent at API ng Road User Tools

Mga limitasyon at pagpapatunay

Bineberipika ng Road User Tools ang mga request bago magkalkula at nagbabalik ng pare-pareho at machine-readable na mga error kapag hindi makumpleto ang request.

Mga limitasyon ng kahilingan

Ang mga katawan ng kahilingan ng JSON ay limitado sa16 KiB. Ang mga input ay pinapatunayan bago ang pagkalkula, kabilang ang mga sinusuportahang unit, may hangganan na mga numeric na halaga, hindi inaasahang mga field, at mga hanay ng halaga tulad ng mga hindi negatibong distansya.

Pampublikong API index

GET /api/v1ay magagamit nang walang pagpapatotoo at nagbibigay ng pangunahing impormasyon ng API. Nangangailangan ng wastong API key ang pagtuklas ng tool, mga kalkulasyon, at MCP.

Mga pagkakamali

Ang mga error na REST ay nagbabalik ng isang matatag na code na nababasa ng makina kasama ng isang mensaheng nababasa ng tao. Ang MCP transport error ay gumagamit ng JSON-RPC formatting at kasama ang Road User Tools error code saerror.data.code.

REST errorjson

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

400invalid_requestAng nilalaman ng kahilingan o isa sa mga field nito ay hindi wasto.

401unauthorizedAng API key ay nawawala, mali ang pagkakabuo, binawi, o hindi nakilala.

403forbiddenAng API key ay walang kinakailangang saklaw.

404not_foundAng hiniling na endpoint ay wala.

413payload_too_largeAng katawan ng kahilingan ay lumampas sa 16 KiB.

415unsupported_media_typeAng endpoint ay nangangailangan ng isang application/json kahilingan.

429rate_limitedNaabot na ang limitasyon sa kahilingan. Subukan muli sa ilang sandali.

500internal_errorHindi makumpleto ng serbisyo ang kahilingan.