Webhook
Webhook
Un webhook è una chiamata HTTP inviata quando si verifica un evento. Dice a un altro sistema di reagire.
Un altro esempio
Un servizio di pagamenti invia un evento payment.succeeded firmato al servizio degli ordini.
Parti principali
- 01Originating request
- 02Resolution or processing hop
- 03Response, timing, and failure
Usalo quando
Firma ogni payload. Gestisci in modo idempotente, ritenta gli invii falliti e conserva registri di eventi duraturi.
Non usarlo quando
Non dare mai per scontato che gli eventi arrivino in ordine o una sola volta. Non fidarti mai di un mittente che non hai verificato.
Nome usato nel codice
POST callback + signature Prima di spedire
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 (Webhook). User context: Un servizio di pagamenti invia un evento payment.succeeded firmato al servizio degli ordini. Technical concept or control: Webhook (Webhook). Why it fits: Firma ogni payload. Gestisci in modo idempotente, ritenta gli invii falliti e conserva registri di eventi duraturi. Do not use it when: Non dare mai per scontato che gli eventi arrivino in ordine o una sola volta. Non fidarti mai di un mittente che non hai verificato. 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): Nessun singolo standard ufficiale controlla l'intero termine. Il suo significato può cambiare tra team, piattaforme o framework. 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.
Controlla questa richiesta
Review how Webhook (Webhook) is used now. Definition: Un webhook è una chiamata HTTP inviata quando si verifica un evento. Dice a un altro sistema di reagire. 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.