네트워크 오류로 응답을 못 받았을 때 같은 요청을 다시 보내도 두 번 처리되지 않게 하는 헤더입니다.
Idempotency-Key: 8f14e45f-ceea-4e7a-9c1d-0b5d7a3c2e11동작
- 같은 프로젝트에서 24시간 안에 같은 키로 다시 호출하면, 서버는 처리를 다시 하지 않고 처음 요청의 HTTP 상태와 응답 본문을 그대로 돌려줍니다.
- 키는 요청마다 새로 만드세요(UUID 권장). 재시도할 때만 같은 키를 씁니다.
- 키를 보내지 않으면 매번 새 요청으로 처리합니다.
주의
- 키는 경로나 본문과 묶이지 않습니다. 다른 API 호출에 같은 키를 쓰면 앞선 호출의 응답이 돌아올 수 있습니다.
- 주문서 생성(
POST /v1/orders/prepare)처럼 구매자 단위로 멱등을 따로 처리하는 API 는 위 공통 규칙 대신 해당 문서에 적힌 규칙(보관 기간·요청 불일치 시 409 등)을 따릅니다. 주문 문서를 봅니다.

