Mengulang dengan aman
Saat koneksi terputus, Anda tidak bisa tahu apakah pesanan Anda sudah masuk. Jadi kirim lagi: selama 7 hari, Idempotency-Key yang sama berarti pesanan yang sama, dan pesanan itu ditagih satu kali.
Cara kerjanya
POST /orders memerlukan header Idempotency-Key: hingga 200 karakter ASCII tanpa spasi, yang Anda buat sendiri dan simpan bersama catatan pesanan Anda. UUID cocok untuk ini. Gunakan Idempotency-Key baru untuk pesanan baru.
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"]}'Yang Anda terima
201 dan pesanan baru.200, pesanan yang sama, dan Idempotent-Replay: true. Tidak ada tagihan tambahan, meskipun harganya telah berubah sejak itu.order_status_unknown atau rate_limited.409 idempotency_conflict. Tidak ada pesanan yang dibuat.insufficient_balance409 price_changed, dan Idempotency-Key baru membuat pesanan dengan harga baru.Saat Anda tidak tahu
Respons apa pun yang hilang, order_status_unknown, dan respons yang bukan JSON, seperti 502 atau 504 dari gateway, semuanya berarti hal yang sama: ulangi permintaan dengan Idempotency-Key yang sama untuk mengetahui keadaan sebenarnya. Ini tidak pernah menagih dua kali. Jangan pernah membuat Idempotency-Key baru karena permintaan timeout atau gagal: itu adalah pesanan baru, dan akan ditagih.
Tunggu satu menit di antara pengulangan. Jika responsnya masih order_status_unknown setelah beberapa menit, berhenti dan hubungi dukungan dengan request_id. Jangan membuat Idempotency-Key baru.
Berapa lama Idempotency-Key berlaku
Idempotency-Key diingat selama 7 hari sejak pertama kali dikirim. Setelah itu, Idempotency-Key yang sama membuat pesanan baru, jadi ulangi dalam beberapa hari dan simpan Idempotency-Key baru untuk setiap pesanan baru.