아이덴포턴시 키: 중복 결제와 더 큰 문제를 막는 API 패턴

이 글은 멱등성 키(idempotency key) 패턴을 통해 비멱등 API 요청을 안전하게 재시도하는 방법을 설명한다.

클라이언트는 재시도마다 같은 고유 키를 사용하고, 서버는 최초 응답을 저장해 중복 요청에는 같은 응답을 돌려준다.

구현에는 동시 재처리를 막는 락과 TTL이 사용되어, 재시도 결과를 일관되게 유지한다.

이 방식은 결제처럼 중복 청구나 되돌릴 수 없는 부작용을 피해야 하는 API에서 특히 중요하다.