Mariner GPS Tools Entwicklerplattform

Grenzwerte und Validierung

Öffentliche API- und MCP-Aufrufe sind ratenbegrenzt. Eingaben werden vor der Berechnung validiert, darunter unterstützte Geschwindigkeitseinheiten, endliche Zahlenwerte sowie Breiten- und Längengradbereiche.

Limits anfordern

JSON-Anforderungskörper sind beschränkt auf16 KiB. Eingaben werden vor der Berechnung validiert, einschließlich unterstützter Einheiten, endlicher numerischer Werte, unerwarteter Felder und gültiger Breiten- und Längengrade.

Öffentlicher API-Index

GET /api/v1ist ohne Authentifizierung verfügbar und stellt grundlegende API-Informationen bereit. Werkzeugerkennung, Berechnungen und MCP-Anfragen erfordern einen gültigen API-Schlüssel.

Fehler

REST-Fehler geben neben einer für Menschen lesbaren Nachricht einen stabilen maschinenlesbaren Code zurück. MCP-Transportfehler verwenden die JSON-RPC-Formatierung und enthalten den Mariner GPS Tools-Fehlercodeerror.data.code.

REST-Fehlerjson

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

400invalid_requestDer Anfragetext oder eines seiner Felder ist ungültig.

401unauthorizedDer Schlüssel API fehlt, ist fehlerhaft, widerrufen oder wird nicht erkannt.

403forbiddenDer Schlüssel API verfügt nicht über den erforderlichen Bereich.

404not_foundDer angeforderte Endpunkt existiert nicht.

413payload_too_largeDer Anforderungstext überschreitet 16 KiB.

415unsupported_media_typeDer Endpunkt erfordert eine application/json Anfrage.

429rate_limitedDas Anforderungslimit wurde erreicht. Versuchen Sie es in Kürze noch einmal.

500internal_errorDer Dienst konnte die Anfrage nicht abschließen.