Sichere Wiederholungen
Wenn eine Verbindung abbricht, können Sie nicht wissen, ob Ihr Auftrag angekommen ist. Senden Sie ihn also erneut: 7 Tage lang bedeutet derselbe Idempotency-Key denselben Auftrag, und er wird einmal berechnet.
So funktioniert es
POST /orders benötigt einen Idempotency-Key-Header: bis zu 200 ASCII-Zeichen ohne Leerzeichen, die Sie selbst festlegen und bei Ihrem eigenen Datensatz zum Auftrag aufbewahren. Eine UUID eignet sich gut. Verwenden Sie für einen neuen Auftrag einen neuen Idempotency-Key.
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"]}'Was Sie zurückbekommen
201 und der neue Auftrag.200, derselbe Auftrag und Idempotent-Replay: true. Es wird nichts weiter berechnet, auch wenn sich der Preis inzwischen geändert hat.order_status_unknown oder rate_limited.409 idempotency_conflict. Es wird kein Auftrag erteilt.insufficient_balance409 price_changed, und ein neuer Idempotency-Key erteilt den Auftrag zum neuen Preis.Wenn Sie es nicht wissen
Jede verlorene Antwort, order_status_unknown und eine Antwort, die kein JSON ist, zum Beispiel ein 502 oder 504 eines Gateways, bedeuten alle dasselbe: Wiederholen Sie die Anfrage mit demselben Idempotency-Key, um den tatsächlichen Stand zu erfahren. Das wird nie doppelt berechnet. Erstellen Sie nie einen neuen Idempotency-Key, weil eine Anfrage in ein Timeout gelaufen oder fehlgeschlagen ist: Das ist ein neuer Auftrag, und er wird berechnet.
Warten Sie zwischen den Wiederholungen eine Minute. Wenn nach einigen Minuten immer noch order_status_unknown zurückkommt, hören Sie auf und wenden Sie sich mit der request_id an den Support. Erstellen Sie keinen neuen Idempotency-Key.
Wie lange ein Idempotency-Key gilt
Ein Idempotency-Key wird 7 Tage ab dem ersten Senden gespeichert. Danach erteilt derselbe Idempotency-Key einen neuen Auftrag. Wiederholen Sie also innerhalb weniger Tage, und verwenden Sie für jeden neuen Auftrag einen neuen Idempotency-Key.