REST API에서 idempotency가 중요한 이유는 무엇인가요?

idempotency는 같은 요청을 여러 번 보내도 최종 결과가 한 번 보낸 것과 같아야 한다는 성질입니다. 네트워크 재시도, 타임아웃, 중복 클릭이 발생할 수 있는 환경에서 중복 생성이나 중복 결제를 막는 데 중요합니다.

핵심 개념

핵심 기준은 재시도해도 최종 상태가 중복 변경되지 않게 하기입니다. 이 개념은 단순히 용어를 외우는 것보다, 어떤 문제를 줄이기 위해 등장했는지와 실제 코드나 운영 환경에서 어떤 trade-off를 만드는지 함께 이해하는 것이 중요합니다.

같은 요청이 네트워크 재시도로 여러 번 도착할 때 결과가 어떻게 되어야 하는지 생각해보세요.

동작 흐름

1. 먼저 문제가 발생하는 조건과 입력을 확인합니다.
2. 관련된 런타임, 브라우저, 서버, 데이터 저장소의 책임을 나눠 봅니다.
3. 가장 작은 범위에서 안전한 해결책을 적용합니다.
4. 로그, 테스트, 모니터링으로 실제로 문제가 줄었는지 확인합니다.

실제 예시

PUT /users/1은 같은 데이터를 여러 번 보내도 결과가 같지만, POST /orders는 멱등키 없이 재시도하면 주문이 중복 생성될 수 있습니다.

실무에서 적용하는 방법

생성·결제 요청에는 Idempotency-Key를 받아 처리 결과를 저장하고 같은 키의 재요청에는 기존 결과를 반환합니다.

실무에서 주의할 점

• HTTP 메서드의 일반적 의미와 실제 구현이 항상 일치하는 것은 아닙니다.
• 멱등키의 저장 기간과 충돌 정책을 명확히 정해야 합니다.
• 개념을 적용하기 전에 현재 시스템의 규모, 병목, 장애 영향도를 함께 확인해야 합니다.
• 팀 규칙이나 프레임워크 기본 동작과 충돌하지 않는지도 점검하는 것이 좋습니다.

함께 연결해서 보면 좋은 키워드

API, REST, 멱등성, 신뢰성

면접에서 짚으면 좋은 포인트

• 정의만 말하기보다 어떤 문제를 줄이기 위한 개념인지 먼저 설명하면 좋습니다.
• 장점과 함께 비용, 한계, 적용하지 않아도 되는 상황을 같이 말하면 실무 이해도가 드러납니다.

정리

한 줄로 정리하면, idempotency는 같은 요청을 여러 번 보내도 최종 결과가 한 번 보낸 것과 같아야 한다는 성질입니다. 네트워크 재시도, 타임아웃, 중복 클릭이 발생할 수 있는 환경에서 중복 생성이나 중복 결제를 막는 데 중요합니다. 실무에서는 개념을 적용하는 조건과 적용하지 않았을 때 생기는 문제까지 함께 이해하는 것이 중요합니다.