Road User Tools Aracı ve API Platformu

Sınırlar ve doğrulama

Road User Tools istekleri hesaplamadan önce doğrular ve bir istek tamamlanamadığında tutarlı, makine tarafından okunabilir hatalar döndürür.

İstek sınırları

JSON istek gövdeleri aşağıdakilerle sınırlıdır:16 KiB. Girdiler hesaplamadan önce doğrulanır; buna desteklenen birimler, sonlu sayısal değerler, beklenmeyen alanlar ve negatif olmayan mesafeler gibi değer aralıkları dâhildir.

Genel API endeksi

GET /api/v1kimlik doğrulaması olmadan kullanılabilir ve temel API bilgilerini sağlar. Takım keşfi, hesaplamalar ve MCP istekleri geçerli bir API anahtarı gerektirir.

Hatalar

REST hataları, insan tarafından okunabilen bir mesajın yanı sıra makine tarafından okunabilen kararlı bir kod döndürür. MCP aktarım hataları JSON-RPC biçimini kullanır ve Road User Tools hata kodunu şu alanda içerir:error.data.code.

REST hatasıjson

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

400invalid_requestİstek gövdesi veya alanlarından biri geçersiz.

401unauthorizedAPI anahtarı eksik, hatalı biçimlendirilmiş, iptal edilmiş veya tanınmıyor.

403forbiddenAPI anahtarı gerekli kapsama sahip değil.

404not_foundİstenen uç nokta mevcut değil.

413payload_too_largeİstek gövdesi 16 KiB'yi aşıyor.

415unsupported_media_typeSon nokta bir gerektirir application/json istek.

429rate_limitedİstek sınırına ulaşıldı. Kısa süre sonra tekrar deneyin.

500internal_errorHizmet isteği tamamlayamadı.