Platform Pengembang Mariner GPS Tools

Batas dan validasi

Panggilan API publik dan MCP dibatasi lajunya. Input divalidasi sebelum perhitungan, termasuk satuan kecepatan yang didukung, nilai numerik terbatas, serta rentang lintang atau bujur.

Batasan permintaan

Badan permintaan JSON terbatas pada16 KiB. Input divalidasi sebelum perhitungan, termasuk unit yang didukung, nilai numerik terbatas, bidang tak terduga, dan rentang lintang dan bujur yang valid.

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 Mariner GPS 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.