시작하기
읽기
편집 전에 리소스를 읽고 문서에 따라 expected_version 을 제공하세요.
쓰기
지원되는 리소스 생성에는 POST, 부분 업데이트에는 PATCH, 삭제에는 DELETE 를 사용하세요.
응답
성공한 작업을 반복하면 변경을 다시 적용하지 않고 저장된 결과를 반환합니다.
헤더
- Idempotency-Key
- 모든 리소스 쓰기에는 Idempotency-Key 가 필요합니다. 논리 작업마다 하나의 키를 생성하고 같은 작업의 재시도에는 키, 메서드, 대상, 내용을 동일하게 유지하세요.
- expected_version
- 가격 변경에는 상품, 가격, 옵션 상품 가격 또는 가격표 버전도 필요할 수 있습니다. 버전이 변경되면 다시 조회해 변경 내용을 조정하고 오래된 데이터를 강제로 적용하지 마세요.
재시도 정책
- 다른 요청에 같은 키를 쓰면 idempotency.key_reused 가 발생합니다.
- 모든 예제는 합성 데이터입니다.
- 실행하기 전에 식별자를 자신의 스토어에서 얻은 값으로 바꾸세요.