Geschatte leestijd: 3 min · Gepubliceerd op 1 oktober 2026
Schrijf het evenementencontract
Documenteer de producent, verwachte gebeurtenistypen, verplichte velden en geactiveerde bewerking. Beschrijf de resultaten voor creatie, verandering en verwijdering, waar van toepassing. Een melding mag niet impliciet elke mogelijke actie autoriseren.
Kies een tracking-ID en een gezaghebbende bron om te raadplegen als deze onzeker is. Beschrijf hoe storingen bij de producent of ontvanger worden gedetecteerd. Integratiedocumentatie bevat regels en eigenaren; Geheimen horen thuis in het beveiligde mechanisme van het project.
Controleer voordat u een bewerking start
GitHub Documenten levering handtekening validatie met behulp van het geconfigureerde geheime en ontvangen payload. Volg het gedocumenteerde mechanisme van de werkelijke provider; Headers, algoritmen en formaten mogen niet naar analogie van een andere dienst worden gekopieerd.
Afzonderlijke oorsprongsverificatie, schemavalidatie en bewerkingsautorisatie. Test gewijzigde inhoud, een onverwacht gebeurtenistype en een ontbrekend veld. Zakelijke verwerking mag pas beginnen na de controles die nodig zijn voor de use-case.
Plan herhalingen en onderbrekingen
Definieer idempotent afhandeling: een erkende herhaalde levering mag geen twee bestellingen of twee definitieve meldingen maken. Test herhaling voor, tijdens en na verwerking en een onderbreking tussen stappen. Het mechanisme is afhankelijk van de werking en opslag die betrokken zijn.
Controleer de bestel- en herleveringsgaranties van de provider in plaats van een onmiddellijke, eenmalige aankomst uit te gaan. Houd een wachtrij van werk dat moet worden beoordeeld en een manier om het te verzoenen met de bron. Een positieve technische reactie moet overeenkomen met een gedefinieerde verwerkingsstatus.
monitoring en herstel regelen
Neem een gebeurtenis-ID, status en nuttige fout op bij het minimaliseren van gegevens. Definieer wie storingen bewaakt, hoe geautoriseerde gebeurtenissen opnieuw worden getest en hoe nieuwe pogingen worden vermeden om voltooid werk te voorkomen.
onderbreek de ontvanger in een testomgeving en herstel deze. Controleer de inhaalslag en verzoen de verwachte bedrijfsresultaten. Lever een evenementcontract, testbatch, verwerkingsgeschiedenis en herstelprocedure die het team kan gebruiken.
Primaire documentatie: GitHub — Valideren van webhook-leveringen.
Referentiedocumenten
Inhoud bijgewerkt 1 oktober 2026