멱등성

타임아웃 뒤에도 중복 생성과 과금 없이 안전하게 재시도하는 방법.

createTask와 retry는 Idempotency-Key 헤더를 지원합니다. createTask는 계정의 논리적 요청에, retry는 원본 작업과 재시도 조합에 키를 귀속시켜 중복 생성과 중복 과금을 방지합니다.

API

POST /api/v1/jobs/createTask
Idempotency-Key: order-8814-render-1

POST /api/v1/jobs/retry
Idempotency-Key: retry-order-8814-1

24시간 유효 기간

키는 24시간 동안 유효합니다. 논리 요청마다 하나를 만들고 네트워크 타임아웃을 포함한 모든 재시도에서 같은 값을 사용하세요. 최대 길이는 128자입니다.

멱등성 지문에는 model, 정규화된 input, callBackUrl이 포함됩니다. 같은 키를 다른 payload에 사용하면 HTTP 409입니다. JSON 키 순서나 공백만 다른 경우는 같은 요청으로 봅니다.

같은 키가 동시에 도착해도 데이터베이스 고유 제약으로 하나만 생성됩니다. 드문 409 경합은 수백 밀리초 기다렸다 같은 키로 재시도하세요. 최신 상태는 반환된 taskId를 recordInfo로 조회합니다.