安全重试
连接中断时，您无法知道订单是否已提交成功。所以请再次发送：7 天内，相同的幂等键代表同一个订单，只扣费一次。
工作原理
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。不会再次扣费，即使价格此后已变动。相同的幂等键在同一时刻发送
一个订单，一次扣费。您会收到该订单，或者一个拒绝响应，其含义是请使用相同的幂等键再次发送，例如
order_status_unknown 或 rate_limited。相同的幂等键配不同的请求
409 idempotency_conflict。未创建任何订单。在
insufficient_balance 等拒绝之后使用相同的幂等键无法确定时
任何丢失的响应、order_status_unknown，以及非 JSON 的响应（例如网关返回的 502 或 504），含义都相同：使用相同的幂等键重复请求，以了解真实状态。这绝不会重复扣费。绝不要因为请求超时或失败而生成新的幂等键：那是一个新订单，会被扣费。
每次重复之间请等待一分钟。如果几分钟后仍返回 order_status_unknown，请停止重试，并携带 request_id 联系客服。不要生成新的幂等键。
幂等键的有效期
幂等键从首次发送起保留 7 天。此后相同的幂等键会创建新订单，因此请在几天内重试，并为每个新订单使用新的幂等键。