Idempotency Key는 어떤 API에서 중요하고 왜 필요한가요?

Idempotency Key는 동일한 요청을 여러 번 보내도 서버가 한 번만 처리하도록 식별하는 키입니다. 결제, 주문 생성, 송금처럼 중복 처리되면 큰 문제가 되는 API에서 중요하며, 서버는 키와 요청 결과를 저장해 재시도 시 같은 응답을 반환합니다.

핵심 개념

핵심 기준은 중복 요청을 한 번의 처리로 보장입니다. 이 개념은 단순히 용어를 외우는 것보다, 어떤 문제를 줄이기 위해 등장했는지와 실제 코드나 운영 환경에서 어떤 trade-off를 만드는지 함께 이해하는 것이 중요합니다.

네트워크 재시도로 같은 요청이 두 번 처리되는 상황을 생각해보세요.

동작 흐름

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

실제 예시

사용자가 결제 버튼을 누른 뒤 네트워크 오류로 재시도했는데 서버가 두 번 결제하면 심각한 장애가 됩니다.

실무에서 적용하는 방법

클라이언트가 요청마다 고유 키를 보내고 서버는 키, 요청 해시, 처리 결과를 일정 시간 보관합니다.

실무에서 주의할 점

• 키만 같고 요청 내용이 다르면 충돌로 처리해야 안전합니다.
• 개념을 적용하기 전에 현재 시스템의 규모, 병목, 장애 영향도를 함께 확인해야 합니다.
• 팀 규칙이나 프레임워크 기본 동작과 충돌하지 않는지도 점검하는 것이 좋습니다.

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

백엔드, IdempotencyKey, API, 결제

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

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

정리

한 줄로 정리하면, Idempotency Key는 동일한 요청을 여러 번 보내도 서버가 한 번만 처리하도록 식별하는 키입니다입니다. 실무에서는 개념을 적용하는 조건과 적용하지 않았을 때 생기는 문제까지 함께 이해하는 것이 중요합니다.