개발·연동
멱등성이란? 다시 요청해도 같은 작업을 중복하지 않는 성질
Idempotency · 멱등 키
멱등성은 같은 작업을 다시 요청해도 결과가 중복해서 생기지 않도록 하는 성질이에요. 발송 응답을 못 받았을 때 안전하게 재시도하는 데 도움이 돼요.
같은 작업에는 같은 키를 써요
주문 안내 한 건을 다시 요청한다면 같은 키로 원래 작업을 찾게 해요. 다른 주문이나 새로운 안내에는 다른 키가 필요해요.
웹훅 중복 처리와는 별개예요
발송 요청 중복을 막아도 결과 웹훅은 다시 올 수 있어요. 요청의 멱등 처리와 받은 이벤트의 중복 처리를 각각 준비해요.
한국AI통신(ClawOps)에서는 지원하는 API에 키를 보내요
이메일과 Verify 등 idempotencyKey가 있는 기능에서 사용해요. 키의 유효 범위와 다른 내용으로 재사용했을 때의 동작을 기능별로 확인해요.