Prisradar
Principes

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.

Mis à jour le 21.10.2026L’équipe Prisradar

Sur cette page
Réponse 404
{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}
Réponse 429
{
  "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.

ChampTypeSignification
400invalid_requestUn champ manque ou est erroné ; error.field l’indique.
401unauthorizedLa clé manque, est erronée ou révoquée, ou l’accès est en pause.
403forbiddenRequête depuis une adresse de serveur qui n’est pas autorisée pour la clé.
404unknown_make · unknown_modelAbsent du catalogue ; error.suggestions indique des noms similaires.
422too_few_comparables · too_oldPas de valeur fiable : trop peu de comparaisons ou plus de 25 ans.
429rate_limited · quota_exceededTrop rapide, ou le quota est épuisé ; Retry-After ou error.resetsAt indique quand cela reprend.
503unavailableL’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.

Tapez ce que vous cherchez : une fonction, une question ou un code d’erreur.

↑ ↓ sélectionner↵ ouvrirEsc fermer