Erreurs
Toutes les erreurs renvoient du JSON avec un code et un message lisible.
Example
{
"error": "insufficient_stops",
"message": "Solde de stops insuffisant : achetez un pack.",
"required": 12,
"balance": 3
}Codes HTTP
| Status | error | Signification |
|---|---|---|
| 400 | invalid_request | Corps invalide (le message précise le champ). |
| 400 | sandbox_limit | Trop d'arrêts pour le sandbox (max 10). |
| 400 | sandbox_addresses_unsupported | Adresses texte non supportées en sandbox. |
| 401 | unauthorized | Clé absente, invalide ou révoquée. |
| 402 | insufficient_stops | Solde insuffisant (`required` et `balance` fournis). |
| 422 | geocoding_failed | Une adresse n'a pas pu être géocodée. |
| 429 | sandbox_rate_limited | Plafond sandbox atteint (en-tête `Retry-After`). |
| 502 | optimization_failed | Échec du calcul — aucun stop débité. |
| 503 | sandbox_unavailable | Sandbox momentanément indisponible. |
429 · Retry-After
Quand les plafonds sandbox sont atteints, respectez l'en-tête Retry-After (secondes) avant de réessayer.