Idempotency 4장 카드뉴스

Idempotency는 같은 요청을 여러 번 보내도 서버에 남는 결과가 한 번 보낸 것과 같아지는 성질입니다. RFC 9110은 같은 요청을 여러 번 반복했을 때 서버에 의도된 효과가 한 번 보낸 것과 같으면 멱등하다고 정의하고 GET·HEAD·PUT·DELETE를 멱등 메서드로 분류합니다. 결제처럼 중복 실행이 치명적인 POST에는 요청마다 고유한 멱등키를 붙여 재시도해도 한 번만 처리되게 만듭니다. 응답 코드까지 같아진다는 뜻은 아닙니다.

멱등성은 여러 번 눌러도 결과가 같은 버튼입니다. 엘리베이터 호출 버튼을 열 번 눌러도 엘리베이터는 한 번만 옵니다. 네트워크가 끊기면 요청이 갔는지 몰라 다시 보내야 하는데, 멱등키가 붙어 있으면 서버가 아까 그 요청임을 알아보고 중복 결제를 막아요.

케이스 1: 토스페이먼츠 — 결제 API 멱등키 토스페이먼츠는 모든 POST API에서 멱등키 헤더를 받습니다. 멱등성은 키와 API 키, API 주소, HTTP 메서드의 조합으로 구분되므로 같은 키라도 다른 엔드포인트면 별개로 봅니다. 키 값은 UUID 같은 무작위 문자열을 권장합니다. 도입효과: 멱등키 유효기간 최초 요청일로부터 15일, 키 최대 길이 300자, 처리 중 중복 요청 시 H