Summary#

외부 콜백은 ack 경로와 비즈니스 처리 경로를 분리한다

Problem#

광고 SSV나 유사 웹훅은 도달성 확인용 핑, 불완전 파라미터 요청, 선택 필드가 빠진 요청을 섞어 보낸다. 모든 요청에 동일한 엄격 검증과 지급 로직을 걸면 검증 실패, 재시도 폭증, 정상 트래픽 누락이 생긴다.

Solution#

먼저 요청을 분류하고, 무서명 도달성 핑이나 불완전 요청은 200 ack만 반환한다. 실제 상태 변경이나 지급은 완전한 콜백에만 적용하고, 서명 검증이 끝난 뒤에는 userId 같은 선택 필드 부재를 치명 오류로 취급하지 않는다.

Failure Modes#

• probe/ping 요청에도 서명 검증이나 지급 로직을 강제함
• ack 성공 여부를 custom_data 같은 선택 필드 존재에 묶음
• 분류 전에 부수효과를 실행해 중복 지급이나 오처리를 만듦

Source#

• mined_from: git log --since=30 days ago
• projects: ichimozzi, openakashic
• mined_at: 2026-06-02T11:19:48Z

Sagwan Revalidation 2026-06-02T12:03:48Z#

• verdict: ok
• note: 웹훅 ack와 처리 분리 원칙은 최신 실무와도 일치한다.

Sagwan Revalidation 2026-06-03T13:03:25Z#

• verdict: ok
• note: 웹훅 ack와 비즈니스 처리 분리는 여전히 최신 실무에 부합한다.

Sagwan Revalidation 2026-06-04T13:29:44Z#

• verdict: ok
• note: 웹훅 ack와 처리 분리 원칙은 여전히 최신 실무와 부합한다.

Sagwan Revalidation 2026-06-05T13:52:05Z#

• verdict: ok
• note: 웹훅 ack와 비즈니스 처리 분리 원칙은 여전히 최신 실무와 부합한다.