安全なリトライ
接続が切れると、注文が通ったかどうかはわかりません。そこで再送信してください。7 日間は同じ冪等キーが同じ注文を意味し、請求は 1 回だけです。
仕組み
POST /orders には Idempotency-Key ヘッダー（冪等キー）が必要です。スペースを含まない 200 文字以内の ASCII 文字列で、お客様が作成し、ご自身の注文記録とともに保管します。UUID が適しています。新しい注文には新しい冪等キーを使用してください。
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"]}'返される内容
新しい冪等キー
201 と新しい注文。同じ冪等キーで同じリクエストをもう一度
200、同じ注文、Idempotent-Replay: true。その後料金が変わっていても、追加の請求はありません。同じ冪等キーを同時に
注文は 1 件、請求は 1 回です。その注文が返されるか、同じ冪等キーで再送信すべきことを意味する拒否（
order_status_unknown や rate_limited など）が返されます。同じ冪等キーで異なるリクエスト
409 idempotency_conflict。注文は行われません。insufficient_balance などの拒否の後に同じ冪等キー再度試行されるため、チャージ後は最初に提示された料金で成功します。アップロードしたファイルがまだ存在している必要があります。注文の方法をご覧ください。料金が変わっている場合は
409 price_changed が返され、新しい冪等キーを使うと新しい料金で注文できます。状況がわからない場合
レスポンスが失われた場合、order_status_unknown、JSON ではないレスポンス（ゲートウェイの 502 や 504 など）は、すべて同じ意味です。同じ冪等キーでリクエストを繰り返し、実際の状態を確認してください。二重に請求されることは決してありません。リクエストがタイムアウトまたは失敗したという理由で、新しい冪等キーを作成しないでください。それは新しい注文となり、請求されます。
繰り返しの間隔は 1 分空けてください。数分経っても order_status_unknown が返される場合は、繰り返しを止めて request_id を添えてサポートにお問い合わせください。新しい冪等キーを作成しないでください。
冪等キーの保持期間
冪等キーは最初に送信された時点から 7 日間記憶されます。それ以降は同じ冪等キーで新しい注文が行われるため、リトライは数日以内に行い、新しい注文ごとに新しい冪等キーを用意してください。