Plateforme d'agents et d'API Road User Tools

Limites et validation

Road User Tools valide les requêtes avant le calcul et renvoie des erreurs cohérentes et lisibles par machine lorsqu’une requête ne peut pas aboutir.

Limites des demandes

Les corps de requête JSON sont limités à16 KiB. Les entrées sont validées avant le calcul, notamment les unités prises en charge, les valeurs numériques finies, les champs inattendus et les plages de valeurs telles que des distances non négatives.

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 Road User 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.