안전한 재시도
연결이 끊기면 주문이 접수되었는지 알 수 없습니다. 그러니 다시 보내세요. 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 같은 거부 후 같은 멱등 키다시 시도되므로, 충전한 후에는 처음 제시된 가격으로 성공합니다. 업로드한 파일이 아직 있어야 합니다. 주문하기를 참고하세요. 가격이 바뀐 경우
409 price_changed를 받으며, 새 멱등 키를 쓰면 새 가격으로 주문됩니다.상태를 모를 때
응답을 받지 못한 경우, order_status_unknown, 그리고 게이트웨이의 502나 504처럼 JSON이 아닌 응답은 모두 같은 뜻입니다. 같은 멱등 키로 요청을 반복해 실제 상태를 확인하세요. 절대 두 번 청구되지 않습니다. 요청이 시간 초과되거나 실패했다는 이유로 절대 새 멱등 키를 만들지 마세요. 그것은 새 주문이 되며 요금이 청구됩니다.
반복 사이에 1분을 기다리세요. 몇 분이 지나도 order_status_unknown을 응답하면 중단하고 request_id와 함께 고객 지원팀에 문의하세요. 새 멱등 키를 만들지 마세요.
멱등 키 유지 기간
멱등 키는 처음 보낸 때부터 7일 동안 기억됩니다. 그 후에는 같은 멱등 키가 새 주문을 넣으므로, 며칠 안에 재시도하고 새 주문마다 새 멱등 키를 사용하세요.