Lire le statut d’abord
400 : corriger la saisie. 401 : vérifier la clé. 403 : accès refusé. 404 : dossier absent. 429 : ralentir ou vérifier le quota. 5xx : défaillance du service, nouvelles tentatives bornées.
Pas toujours du JSON
La validation utilise Problem Details. Une réponse 404 ou de limitation peut être vide. Lisez le statut avant de parser. Ne supposez pas quota_exceeded ou Retry-After s’ils ne sont pas présents.
Des limites distinctes
Volume, débit et simultanéité sont distincts. L’API applique une fenêtre fixe d’une minute par client. Des clés supplémentaires n’augmentent pas cette limite.
Réessayer raisonnablement
Respectez Retry-After si fourni. Sinon, utilisez un délai exponentiel avec aléa et un nombre maximal d’essais. Ne répétez pas sans fin une entrée ou une clé invalide. Chaque nouvelle réponse facturable compte.
