Platforma programistyczna Mariner GPS Tools

Limity i walidacja

Publiczne wywołania API i MCP podlegają limitom częstotliwości. Dane wejściowe są sprawdzane przed obliczeniem, w tym obsługiwane jednostki prędkości, skończone wartości liczbowe oraz zakresy szerokości i długości geograficznej.

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.