Les erreurs de l’API et leur signification
Chaque erreur a un code fixe pour votre logiciel et une phrase en allemand pour votre journal. Les requêtes en erreur ne comptent jamais dans le quota.
{
"error": {
"code": "unknown_make",
"message": "Die Marke «Ferari» kennen wir nicht.",
"suggestions": [
"Ferrari"
]
}
}{
"error": {
"code": "quota_exceeded",
"message": "Das Kontingent von 2000 Bewertungen ist für diesen Monat aufgebraucht.",
"resetsAt": "2026-10-31T23:00:00.000Z"
}
}À quoi ressemble une erreur ?
Chaque erreur arrive en JSON avec l’objet error. error.code est un code anglais fixe auquel votre logiciel réagit. error.message est une phrase en allemand pour votre journal. Certaines erreurs apportent davantage : error.field, error.suggestions ou error.resetsAt. Une erreur ne compte jamais dans le quota.
Quelles erreurs existe-t-il ?
400 signifie qu’un champ manque ou est erroné. 401 et 403 concernent la clé. 404 signifie que la marque ou le modèle ne figure pas dans le catalogue. 422 signifie qu’il n’y a pas de valeur fiable. 429 signifie trop rapide ou quota épuisé. 503 signifie que l’API est brièvement en pause.
| Champ | Type | Signification |
|---|---|---|
400 | invalid_request | Un champ manque ou est erroné ; error.field l’indique. |
401 | unauthorized | La clé manque, est erronée ou révoquée, ou l’accès est en pause. |
403 | forbidden | Requête depuis une adresse de serveur qui n’est pas autorisée pour la clé. |
404 | unknown_make · unknown_model | Absent du catalogue ; error.suggestions indique des noms similaires. |
422 | too_few_comparables · too_old | Pas de valeur fiable : trop peu de comparaisons ou plus de 25 ans. |
429 | rate_limited · quota_exceeded | Trop rapide, ou le quota est épuisé ; Retry-After ou error.resetsAt indique quand cela reprend. |
503 | unavailable | L’API est brièvement en pause. Réessayer après quelques minutes. |
Que faire en cas d’erreur 429 ?
Vérifiez error.code. Avec rate_limited, vous avez envoyé plus de 60 requêtes en une minute ; attendez les secondes indiquées dans l’en-tête Retry-After. Avec quota_exceeded, le quota du mois est épuisé ; cela reprend à la date de error.resetsAt, ou immédiatement avec un forfait plus grand. Si error.resetsAt manque, il n’y a pas de forfait ou son paiement est en suspens ; error.message indique ce qui aide.
Forfaits et limites : Limites et forfaits.
Quand mon logiciel doit-il réessayer ?
Seulement avec 429 rate_limited et avec 503, et seulement après le délai indiqué dans l’en-tête Retry-After. Toutes les autres erreurs reviennent pour la même requête : avec 400, corrigez le champ, avec 404 le nom, et avec 422, affichez une remarque au lieu d’une valeur.
Vous n’avez pas trouvé ce que vous cherchez ?Écrivez à info@prisradar.ch ou via le formulaire de contact.