Plateforme de développement Mariner GPS Tools

Limites et validation

Les appels publics à l’API et à MCP sont soumis à une limite de débit. Les entrées sont validées avant le calcul, notamment les unités de vitesse prises en charge, les valeurs numériques finies et les plages de latitude ou de longitude.

Limites des demandes

Les corps de requête JSON sont limités à16 KiB. Les entrées sont validées avant le calcul, y compris les unités prises en charge, les valeurs numériques finies, les champs inattendus et les plages de latitude et de longitude valides.

Indice public API

GET /api/v1est disponible sans authentification et fournit des informations de base sur API. La découverte d'outils, les calculs et les requêtes MCP nécessitent une clé API valide.

Erreurs

Les erreurs REST renvoient un code stable lisible par machine ainsi qu'un message lisible par l'homme. Les erreurs de transport MCP utilisent le formatage JSON-RPC et incluent le code d'erreur Mariner GPS Tools danserror.data.code.

Erreur RESTjson

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

400invalid_requestLe corps de la requête ou l'un de ses champs n'est pas valide.

401unauthorizedLa clé API est manquante, mal formée, révoquée ou non reconnue.

403forbiddenLa clé API n'a pas la portée requise.

404not_foundLe point de terminaison demandé n’existe pas.

413payload_too_largeLe corps de la demande dépasse 16 KiB.

415unsupported_media_typeLe point final nécessite un application/json demande.

429rate_limitedLa limite de requêtes a été atteinte. Réessayez sous peu.

500internal_errorLe service n'a pas pu finaliser la demande.