Platform Agen & API Road User Tools

Batas dan validasi

Road User Tools memvalidasi permintaan sebelum perhitungan dan mengembalikan kesalahan yang konsisten dan dapat dibaca mesin saat permintaan tidak dapat diselesaikan.

Batasan permintaan

Badan permintaan JSON terbatas pada16 KiB. Input divalidasi sebelum perhitungan, termasuk satuan yang didukung, nilai numerik terbatas, bidang yang tidak terduga, dan rentang nilai seperti jarak yang tidak negatif.

Indeks API publik

GET /api/v1tersedia tanpa otentikasi dan memberikan informasi dasar API. Penemuan alat, penghitungan, dan permintaan MCP memerlukan kunci API yang valid.

Kesalahan

Kesalahan REST mengembalikan kode stabil yang dapat dibaca mesin bersama dengan pesan yang dapat dibaca manusia. Kesalahan transportasi MCP menggunakan format JSON-RPC dan menyertakan kode kesalahan Road User Tools dierror.data.code.

Kesalahan RESTjson

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

400invalid_requestBadan permintaan atau salah satu bidangnya tidak valid.

401unauthorizedKunci API hilang, salah format, dicabut, atau tidak dikenali.

403forbiddenKunci API tidak memiliki cakupan yang diperlukan.

404not_foundTitik akhir yang diminta tidak ada.

413payload_too_largeBadan permintaan melebihi 16 KiB.

415unsupported_media_typeTitik akhir memerlukan application/json permintaan.

429rate_limitedBatas permintaan telah tercapai. Coba lagi sebentar lagi.

500internal_errorLayanan tidak dapat menyelesaikan permintaan.