Platforma agentów i API Mariner GPS Tools

Limity i walidacja

Mariner GPS Tools sprawdza żądania przed obliczeniem i zwraca spójne, czytelne maszynowo błędy, gdy żądania nie można zrealizować.

Limity żądań

Treści żądania JSON są ograniczone do16 KiB. Przed obliczeniem sprawdzane są dane wejściowe, obejmujące obsługiwane jednostki, skończone wartości liczbowe, nieoczekiwane pola oraz prawidłowe zakresy szerokości i długości geograficznej.

Indeks publiczny API

GET /api/v1jest dostępny bez uwierzytelniania i dostarcza podstawowych informacji o API. Wykrywanie narzędzi, obliczenia i żądania MCP wymagają ważnego klucza API.

Błędy

Błędy REST zwracają stabilny kod czytelny dla maszyny wraz z komunikatem czytelnym dla człowieka. Błędy transportu MCP wykorzystują formatowanie JSON-RPC i zawierają kod błędu Mariner GPS Tools werror.data.code.

Błąd RESTjson

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

400invalid_requestTreść żądania lub jedno z jego pól jest nieprawidłowe.

401unauthorizedBrak klucza API, jest on zniekształcony, unieważniony lub nie został rozpoznany.

403forbiddenKlucz API nie ma wymaganego zakresu.

404not_foundŻądany punkt końcowy nie istnieje.

413payload_too_largeTreść żądania przekracza wartość 16 KiB.

415unsupported_media_typePunkt końcowy wymaga application/json prośba.

429rate_limitedOsiągnięto limit żądań. Spróbuj ponownie wkrótce.

500internal_errorUsługa nie mogła zrealizować żądania.