Premiers pas

Erreurs

Traitez les erreurs selon le statut HTTP et ne relancez jamais aveuglément chaque requête échouée. Envoyez toujours Accept: application/json.

StatutQue faire

400Paramètre invalide ou limite de taille de page. Corrigez la requête ; ne la relancez pas à l’identique.

401 / 403Clé absente, invalide, expirée ou inactive, ou accès à la source refusé. Vérifiez la réponse et l’abonnement ; ne relancez pas à l’identique.

404Véhicule ou lot introuvable. Affichez un résultat vide ; n’inventez pas de prix.

429Limite de requêtes atteinte. Respectez Retry-After s’il est fourni ; utilisez un backoff limité et tenez compte du quota de votre formule.

5xx / timeoutNe relancez que les lectures sûres, avec un nombre limité de tentatives. Conservez le dernier point de reprise réussi et évitez de journaliser les clés ou les réponses complètes.

Erreurs d’authentification

403{ "error": "please add auth key in x-api-key header" }
403{ "error": "wrong api key" }
403{ "error": "your api subscription has expired" }
403{ "error": "your api subscription is not active" }

Lire la réponse en toute sécurité

Les contrôles applicatifs renvoient normalement un objet avec error ; les erreurs du framework et de la passerelle utilisent message.
Une passerelle, un proxy ou un serveur web peut renvoyer du HTML, du texte brut ou un corps vide même si du JSON était demandé.
Ne relancez que les requêtes GET sûres, avec un nombre limité de tentatives et des délais croissants. Conservez votre dernier point de reprise réussi.