Idempotency - null | AI Insight Note

멱등성(Idempotency)은 동일한 요청을 여러 번 보내도 결과가 항상 같은 성질이다. 네트워크 오류로 인한 재시도 시 데이터 중복을 방지하는 API 설계의 핵심 원칙이다.

HTTP 메서드별 멱등성

메서드	멱등성	안전성	설명
GET	✓	✓	조회만, 상태 변경 없음
HEAD	✓	✓	GET과 유사
PUT	✓	✗	동일 데이터로 덮어쓰기
DELETE	✓	✗	이미 삭제된 것을 삭제해도 같은 결과
POST	✗	✗	호출마다 새 리소스 생성
PATCH	✗	✗	조건에 따라 다를 수 있음

POST를 멱등하게 만들기

python

# Idempotency Key 패턴
POST /payments
Idempotency-Key: "unique-key-abc123"

def create_payment(idempotency_key, amount):
    # 이미 처리된 키인지 확인
    if redis.get(f"payment:{idempotency_key}"):
        return get_existing_result(idempotency_key)

    result = process_payment(amount)
    redis.setex(f"payment:{idempotency_key}", 86400, result.id)
    return result

참고문헌

•RFC 7231 — Hypertext Transfer Protocol Semantics

Idempotency멱등성

HTTP 메서드별 멱등성

POST를 멱등하게 만들기

관련 개념

참고문헌