‘n Webhook is ‘n HTTP-versoek wat ‘n diens na ‘n URL stuur wat jy registreer wanneer ‘n spesifieke gebeurtenis plaasvind. Dit laat jou stelsel toe om data te ontvang soos dit gebeur, in plaas daarvan om ‘n API te pols deur dit weer en weer aan te roep om te sien of daar iets nuuts beskikbaar is. In ‘n datastroom beteken dit dat ‘n taak kan reageer op ‘n gebeurtenis sodra die bron dit rapporteer.
Betalingsplatform Stripe, byvoorbeeld, stuur webhook-gebeurtenisse na jou eindpunt oor HTTPS as ‘n JSON-lading. Jou eindpunt moet POST-versoeke aanvaar en die gebeurtenisdata wat dit ontvang, verwerk.
Hoe Webhook Aflewering Werk
Stripe se dokumentasie toon die hoofmeganika:
- Registrasie: Jy registreer ‘n eindpunt-URL. In lewende modus vereis Stripe ‘n publiek toeganklike HTTPS-URL.
- Vinige erkenning: Die eindpunt moet vinnig ‘n 2xx-statuskode teruggee, voordat enige komplekse logika wat ‘n tydsduur kan veroorsaak, uitgevoer word.
- Hernuwing: As aflewering misluk, probeer Stripe tot drie dae lank met eksponensiële terugval in lewende modus.
- Bestelling: Stripe waarborg nie dat gebeurtenisse in die volgorde waarin hulle geskep is, aankom nie.
Sekuriteit van ‘n Webhook Eindpunt
- Verifieer handtekeninge: Stripe teken elke gebeurtenis met ‘n HMAC met SHA-256 en plaas die handtekening in die
Stripe-Signaturekop. - Blok herhalings: Die ondertekende las bevat ‘n tydstempel, sodat jy gebeurtenisse wat te oud is, kan verwerp.
- Hanteer duplikate: ‘n Eindpunt kan dieselfde gebeurtenis meer as een keer ontvang. Log verwerkte gebeurtenis-ID's en sla herhalings oor.
- Toelaatbare senders: Stripe stuur webhooks vanaf ‘n gepubliseerde lys van IP-adresse waartoe jy jou vuurmuur kan beperk.
Algemene Webhook Gebruik
- Kode en implementering: GitHub stuur ‘n HTTP POST-lading na jou URL vir die repository-gebeurtenisse waaraan jy inteken. Sy dokumentasie lys gebruike soos om CI-bouwerk te begin, ‘n eksterne probleemopsporingsinstrument op te dateer, ‘n rugsteunspieël te verfris en na ‘n produksieserver te implementeer.
- Betalings: Stripe-webhooks laat jou toe om te reageer op asynchrone gebeurtenisse, soos ‘n bank wat ‘n betaling bevestig, ‘n klant wat ‘n heffing betwis of ‘n herhalende betaling wat slaag.
- Inteken net op wat jy nodig het: Stripe raai aan om nie na ekstra of alle gebeurtenisse te luister nie, omdat dit onnodige druk op jou bediener plaas.