멱등성 (Idempotency)

같은 요청을 여러 번 수행해도 결과가 같게 되는 성질


멱등성은 같은 요청을 여러 번 수행해도 최종 상태가 같게 되는 성질입니다. 네트워크 재시도(retry)가 흔한 환경에서 중요합니다.

예시

  • GET /users/1은 보통 멱등
  • DELETE /users/1도 “삭제된 상태”라는 최종 결과 관점에서 멱등
  • POST /payments는 설계에 따라 멱등이 아닐 수 있음(중복 결제 위험)

실무 포인트

  • 결제/주문처럼 “중복 수행이 치명적”인 요청은 멱등 키(Idempotency-Key) 를 도입하기도 합니다.

관련 문서