Platfform Asiantau ac API Road User Tools

Terfynau a dilysu

Mae Road User Tools yn dilysu ceisiadau cyn cyfrifo ac yn dychwelyd gwallau cyson a darllenadwy gan beiriant pan na ellir cwblhau cais.

Terfynau cais

Mae cyrff cais JSON wedi'u cyfyngu i16 KiB. Mae mewnbynnau'n cael eu dilysu cyn eu cyfrifo, gan gynnwys unedau â chymorth, gwerthoedd rhifol cyfyngedig, meysydd annisgwyl, ac ystodau gwerth megis pellteroedd nad ydynt yn negyddol.

Mynegai cyhoeddus API

GET /api/v1ar gael heb ddilysu ac mae'n darparu gwybodaeth API sylfaenol. Mae darganfod offer, cyfrifiadau a cheisiadau MCP yn gofyn am API key dilys.

Gwallau

Mae gwallau REST yn dychwelyd cod sefydlog y gall peiriant ei ddarllen, ynghyd â neges glir i bobl. Mae gwallau cludiant MCP yn defnyddio fformat JSON-RPC ac yn cynnwys cod gwall Road User Tools ynerror.data.code.

Gwall RESTjson

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

400invalid_requestMae corff y cais neu un o'i feysydd yn annilys.

401unauthorizedMae’r API key ar goll, wedi ei fomateiddio’n anghywir, wedi cael ei ddiddymu, neu nid yw’n cael ei adnabod.

403forbiddenNid oes gan y API key y cwmpas gofynnol.

404not_foundNid yw’r pwynt terfyn a ofynnwyd yn bodoli.

413payload_too_largeMae corff y cais yn fwy na 16 KiB.

415unsupported_media_typeMae’r pwynt terfyn yn gofyn am application/json gais.

429rate_limitedMae terfyn y cais wedi cael ei gyrraedd. Ceisiwch eto yn fuan.

500internal_errorNi all y gwasanaeth gwblhau’r cais.