Veilig opnieuw proberen
Als een verbinding wegvalt, kun je niet weten of je bestelling is doorgekomen. Stuur hem dus opnieuw: 7 dagen lang betekent dezelfde idempotentiesleutel dezelfde bestelling, en die wordt één keer afgeschreven.
Hoe het werkt
POST /orders vereist een Idempotency-Key-header: maximaal 200 ASCII-tekens zonder spaties, die je zelf bedenkt en bewaart bij je eigen gegevens van de bestelling. Een UUID werkt goed. Gebruik een nieuwe idempotentiesleutel voor een nieuwe bestelling.
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"]}'Wat je terugkrijgt
201 en de nieuwe bestelling.200, dezelfde bestelling en Idempotent-Replay: true. Er wordt niets meer afgeschreven, ook niet als de prijs sindsdien is gewijzigd.order_status_unknown of rate_limited.409 idempotency_conflict. Er wordt niets geplaatst.insufficient_balance409 price_changed, en met een nieuwe idempotentiesleutel bestel je tegen de nieuwe prijs.Als je het niet weet
Elk antwoord dat verloren gaat, order_status_unknown en een antwoord dat geen JSON is, zoals een 502 of 504 van een gateway, betekenen allemaal hetzelfde: herhaal het verzoek met dezelfde idempotentiesleutel om de werkelijke status te weten te komen. Dat schrijft nooit twee keer af. Maak nooit een nieuwe idempotentiesleutel omdat een verzoek een time-out kreeg of mislukte: dat is een nieuwe bestelling, en die wordt afgeschreven.
Wacht een minuut tussen herhalingen. Als het antwoord na een paar minuten nog steeds order_status_unknown is, stop dan en neem contact op met support met de request_id. Maak geen nieuwe idempotentiesleutel.
Hoe lang een idempotentiesleutel geldt
Een idempotentiesleutel wordt 7 dagen onthouden, gerekend vanaf de eerste keer dat hij is verstuurd. Daarna plaatst dezelfde sleutel een nieuwe bestelling, dus probeer het binnen een paar dagen opnieuw en gebruik een nieuwe idempotentiesleutel voor elke nieuwe bestelling.