Geschatte leestijd : 6 min · Gepubliceerd
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.
In n8n hebben test- en productie-URL’s voor webhooks verschillende doelen. Luisteren naar een testgebeurtenis regelt geen doorlopende ontvangst: de productie-URL wordt bij publicatie van de workflow geregistreerd. Controleer de URL bij de afzender en bekijk productieruns in Executions.
De antwoordmodus bepaalt wat een ontvangstbevestiging betekent. Immediately meldt de start van de workflow, niet dat de bestelling of klantregistratie is bijgewerkt. Koppel gebeurtenis-ID, uitvoering en eindstatus in de bestemming voordat u zakelijk succes meldt.
Schuif de tabel horizontaal om alle kolommen te lezen. Zet met het toetsenbord de focus op de tabel en gebruik de pijltjestoetsen.
| Controlepunt | Mogelijke waarneming | Verwacht bewijs |
|---|---|---|
| Test-URL | Gebeurtenis zichtbaar tijdens luisteren voor een test | Gebruikte URL en testomgeving |
| Productie-URL | Gepubliceerde workflow en geregistreerde uitvoering | Uitvoerings-ID gekoppeld aan ontvangen gebeurtenis |
| Immediately-antwoord | De workflow is gestart | Eindstatus en bedoelde handeling in de bestemmingsdienst |
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.
Fictief voorbeeld: DEMO-E41 veroorzaakt één zakelijke schrijfactie in een database. De afspraken voegen die actie en het markeren van de gebeurtenis als verwerkt samen in één transactie; een unieke sleutel met producent en identificatie begrenst gelijktijdige verwerking. Test onderbreking vóór en na COMMIT. Herstel na vastlegging vindt het uitgevoerde werk terug in plaats van een tweede effect toe te voegen. ‘Ontvangen’ vastleggen in een apart logboek biedt die garantie niet.
Bij GitHub behoudt een herlevering de waarde X-GitHub-Delivery; een nieuwe poging is dus niet om die reden een nieuwe gebeurtenis. Controleer andere producenten afzonderlijk. DEMO-E42 toont een andere grens: een aanroep naar een externe dienst verloopt zonder antwoord. Een lokale transactie bewijst niet of die dienst iets heeft uitgevoerd; stem de referentie en gedocumenteerde herhaalgaranties af voordat de actie opnieuw wordt gedaan.
Schuif de tabel horizontaal om alle kolommen te lezen. Zet met het toetsenbord de focus op de tabel en gebruik de pijltjestoetsen.
| Testgeval | Vastgesteld zakelijk effect | Verwacht herstel |
|---|---|---|
| DEMO-E41 vóór COMMIT, transactie teruggedraaid | 0 vastgelegde effecten | Herstel volgens de transactieregistratie |
| DEMO-E41 na COMMIT | 1 effect en gebeurtenis als verwerkt gemarkeerd | Reeds vastgelegd resultaat ophalen |
| DEMO-E41 opnieuw geleverd | Nog steeds 1 effect in totaal | Sleutel herkennen; schrijfhandeling niet herhalen |
| DEMO-E42: externe aanroep zonder antwoord | Uitkomst onbekend: 0 of 1 effect mogelijk | Afstemmen met de dienst; geen blinde herhaling |
- GitHub : Webhook Best Practices
GitHub, geraadpleegd op 22 oktober 2026: identificatie blijft behouden bij herlevering. DEMO-E41 en DEMO-E42 zijn verkorte fictieve gebeurtenissen.
- PostgreSQL : Transactions
PostgreSQL, geraadpleegd op 22 oktober 2026: databasetransacties; geen algemene garantie voor externe aanroepen.
Referentiedocumenten
- Stripe : Webhooks · Bron geraadpleegd
- n8n : Webhook node · Bron geraadpleegd
- GitHub : Valideren van webhook-leveringen
Inhoud bijgewerkt
Gedocumenteerde referenties voor dit onderwerp
| Referentie | Waarde of syntaxis | Toepassingsgebied |
|---|---|---|
| RFC 8259 · JSON | application/json · UTF-8 | Standaard-JSON staat geen commentaar of afsluitende komma toe; tekenreeksen gebruiken dubbele aanhalingstekens. |
| RFC 3339 · Date-time | 2026-10-22T09:00:00+02:00 | Het expliciete tijdsverschil koppelt lokale tijd aan UTC; dit voorbeeld is geen afspraak. |
De datums geven aan wanneer de bronnen zijn geraadpleegd. Deze gegevens vormen geen site-audit of algemene conformiteitsverklaring.
