Güvenli yeniden deneme
Bağlantı koptuğunda siparişinizin ulaşıp ulaşmadığını bilemezsiniz. Bu yüzden yeniden gönderin: 7 gün boyunca aynı Idempotency-Key aynı sipariş anlamına gelir ve bir kez ücretlendirilir.
Nasıl çalışır
POST /orders bir Idempotency-Key başlığı gerektirir: boşluk içermeyen en fazla 200 ASCII karakter. Bunu kendiniz belirler ve siparişle ilgili kendi kaydınızda saklarsınız. UUID iyi bir seçimdir. Yeni bir sipariş için yeni bir Idempotency-Key kullanın.
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"]}'Ne yanıt alırsınız
201 ve yeni sipariş.200, aynı sipariş ve Idempotent-Replay: true. Fiyat o zamandan beri değişmiş olsa bile başka ücret alınmaz.order_status_unknown veya rate_limited gibi bir ret yanıtını alırsınız.409 idempotency_conflict. Sipariş verilmez.insufficient_balance gibi bir retten sonra aynı Idempotency-Key409 price_changed alırsınız ve yeni bir Idempotency-Key yeni fiyattan sipariş verir.Bilmediğinizde
Kaybolan her yanıt, order_status_unknown ve bir ağ geçidinin 502 veya 504 yanıtı gibi JSON olmayan bir yanıt aynı anlama gelir: gerçek durumu öğrenmek için isteği aynı Idempotency-Key ile tekrarlayın. Bu asla iki kez ücret alınmasına yol açmaz. Bir istek zaman aşımına uğradı veya başarısız oldu diye asla yeni bir Idempotency-Key oluşturmayın: bu yeni bir sipariştir ve ücretlendirilir.
Tekrarlar arasında bir dakika bekleyin. Birkaç dakika sonra hâlâ order_status_unknown yanıtı alıyorsanız durun ve request_id ile desteğe başvurun. Yeni bir Idempotency-Key oluşturmayın.
Idempotency-Key ne kadar geçerlidir
Bir Idempotency-Key ilk gönderildiği andan itibaren 7 gün hatırlanır. Bundan sonra aynı Idempotency-Key yeni bir sipariş verir; bu yüzden birkaç gün içinde yeniden deneyin ve her yeni sipariş için yeni bir Idempotency-Key kullanın.