Mariner GPS Tools Geliştirici Platformu

Sınırlar ve doğrulama

Herkese açık API ve MCP çağrıları hız sınırlamasına tabidir. Desteklenen hız birimleri, sonlu sayısal değerler ve enlem ya da boylam aralıkları dâhil olmak üzere girdiler hesaplamadan önce doğrulanır.

İstek sınırları

JSON istek gövdeleri aşağıdakilerle sınırlıdır:16 KiB. Desteklenen birimler, sonlu sayısal değerler, beklenmeyen alanlar ve geçerli enlem ve boylam aralıkları dahil olmak üzere girdiler, hesaplamadan önce doğrulanır.

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