Gérer les erreurs API, les nouvelles tentatives et l'idempotence

Concevez votre intégration en prévoyant les échecs, et pas seulement le scénario idéal. Le cas le plus dangereux est un cas ambigu : une requête qui a peut-être réussi avant que la connexion ne soit coupée.

Utilisez une clé d'idempotence sur les requêtes de commande afin qu'une nouvelle tentative sûre après un délai d'attente retourne la commande existante au lieu de créer une facturation en double. Relancez les erreurs transitoires (limites de débit, 5xx temporaires) avec un délai croissant et un plafond.

Échouez rapidement sur les erreurs permanentes comme une requête incorrecte ou un solde insuffisant, et signalez-les à un humain : les relancer ne fait que perdre du temps. Journalisez chaque requête et réponse avec son identifiant de commande afin de pouvoir les rapprocher plus tard.