Nouvelles tentatives sûres
Quand une connexion est coupée, vous ne pouvez pas savoir si votre commande a abouti. Renvoyez-la donc : pendant 7 jours, la même clé d’idempotence désigne la même commande, et elle n’est débitée qu’une seule fois.
Comment ça marche
POST /orders exige un en-tête Idempotency-Key : jusqu’à 200 caractères ASCII sans espaces, que vous inventez et conservez avec votre propre enregistrement de la commande. Un UUID convient bien. Utilisez une nouvelle clé d’idempotence pour une nouvelle commande.
curl -X POST "https://api.talismanleads.io/v1/orders" \
-H "Authorization: Bearer tl_live_your_key_here" \
-H "Idempotency-Key: crm-export-2026-11-05" \
-H "Content-Type: application/json" \
-d '{"checker":"whatsapp_status_detection","entries":["+14155550142","+12125550187"]}'Ce que vous recevez
201 et la nouvelle commande.200, la même commande et Idempotent-Replay: true. Rien de plus n’est débité, même si le prix a changé entre-temps.order_status_unknown ou rate_limited.409 idempotency_conflict. Aucune commande n’est passée.insufficient_balance409 price_changed, et une nouvelle clé d’idempotence passe la commande au nouveau prix.Quand vous ne savez pas
Toute réponse perdue, order_status_unknown et une réponse qui n’est pas du JSON, comme un 502 ou un 504 d’une passerelle, signifient toutes la même chose : répétez la requête avec la même clé d’idempotence pour connaître l’état réel. Cela ne débite jamais deux fois. Ne créez jamais de nouvelle clé d’idempotence parce qu’une requête a dépassé le délai d’attente ou a échoué : c’est une nouvelle commande, et elle est débitée.
Attendez une minute entre deux répétitions. Si la réponse est toujours order_status_unknown après quelques minutes, arrêtez et contactez l’assistance en indiquant le request_id. Ne créez pas de nouvelle clé d’idempotence.
Durée de vie d’une clé d’idempotence
Une clé d’idempotence est mémorisée pendant 7 jours à partir de son premier envoi. Passé ce délai, la même clé passe une nouvelle commande : renvoyez donc dans les quelques jours et utilisez une nouvelle clé d’idempotence pour chaque nouvelle commande.