Webhook
웹훅
Webhook은 이벤트가 생기면 보내는 HTTP 콜백이야. 다른 시스템에게 반응하라고 알려줘.
다른 예시
결제 서비스가 결제 완료 이벤트를 서명해서 주문 서비스로 보내요.
주요 부분
- 01Originating request
- 02Resolution or processing hop
- 03Response, timing, and failure
사용할 때
각 페이로드에 서명하세요. 처리 과정은 멱등적(idempotent)으로 만들고, 실패한 전송은 재시도하며, 내구성 있는 이벤트 기록을 유지하세요.
다음 경우에는 사용하지 마세요
이벤트가 순서대로 오거나 단 한 번만 온다고 가정하지 마세요. 확인하지 않은 발신자를 절대 믿지 마세요.
코드에서 사용된 이름
POST callback + signature 출시하기 전에
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome:Complete the task with 웹훅 (Webhook)。 User context:결제 서비스가 결제 완료 이벤트를 서명해서 주문 서비스로 보내요. Technical concept or control:웹훅 (Webhook)。 Why it fits:각 페이로드에 서명하세요. 처리 과정은 멱등적(idempotent)으로 만들고, 실패한 전송은 재시도하며, 내구성 있는 이벤트 기록을 유지하세요. Do not use it when:이벤트가 순서대로 오거나 단 한 번만 온다고 가정하지 마세요. 확인하지 않은 발신자를 절대 믿지 마세요. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary):하나의 공식 표준이 전체 용어를 통제하지 않음. 의미는 팀, 플랫폼 또는 프레임워크마다 달라질 수 있음. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
이 요청을 확인하세요
Review how 웹훅 (Webhook) is used now. Definition: Webhook은 이벤트가 생기면 보내는 HTTP 콜백이야. 다른 시스템에게 반응하라고 알려줘. Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.