Afleveringslogboeken en testen
Het instellingenpaneel voor webhooks bevat een ingebouwd afleverlog per eindpunt. Gebruik het om te verifiëren dat gebeurtenissen je server bereiken, fouten te onderzoeken en een nieuw voorbeeldbericht te sturen zonder echte activiteit te veroorzaken.
Bezorglogboeken bekijken
1
Instellingen → Webhooks openen
Ga naar
Dashboard → Settings → Webhooks.2
Klap een webhookrij uit
Klik op de Afleveringslogboeken knop op elke webhookkaart. De laatste 50 pogingen staan van nieuw naar oud.
3
Elke vermelding inspecteren
Elke rij toont het gebeurtenistype, de HTTP-statuscode, de responstijd, het tijdstip en eventuele foutmeldingen.
Logboekvelden
| Veld | Beschrijving |
|---|---|
| Gebeurtenis | Het geactiveerde gebeurtenistype (bijv. post.saved) |
| Status | HTTP-status die je endpoint terugstuurt. null bij time-out of geweigerde verbinding. |
| Reactietijd | Rondreistijd in milliseconden vanaf verzending tot de laatste antwoordbyte. |
| Gelukt | Groen vinkje = HTTP 2xx. Rood kruis = elke andere uitkomst. |
| Fout | Leesbare foutmelding voor mislukte afleveringen (bijv. Request timed out (10s)). |
| Afgeleverd op | UTC-tijdstempel van de bezorgpoging. |
Een testgebeurtenis versturen
1
Klap de webhookkaart uit
In
Settings → Webhooks, zoek je webhook en klik op Testgebeurtenis versturen.2
Controleer het afleverlogboek
De testlevering verschijnt binnen enkele seconden bovenaan de bezorglogboeken. Controleer of je het volgende ziet:
200 status.Testgebeurtenissen zijn echte HTTP-verzoeken
Het testevent doorloopt precies dezelfde verwerking als een echt event, inclusief HMAC-ondertekening. Je code voor handtekeningcontrole wordt dus volledig getest.
Geen automatische nieuwe poging
Elke aflevering wordt eenmaal geprobeerd. Het logboek is alleen bedoeld voor diagnose; er is geen knop om een mislukte live gebeurtenis opnieuw af te spelen. Gebruik na het herstellen van een endpoint Testen om de reparatie te controleren.
Veelvoorkomende oorzaken van mislukking
| Fout / status | Waarschijnlijke oorzaak | Herstellen |
|---|---|---|
Request timed out (10s) | De server deed er langer dan 10 s over om te reageren | Terug 200 direct, en verwerk daarna asynchroon |
401 | Handtekeningverificatie mislukt | Lees de onbewerkte body voordat je JSON verwerkt |
404 | Het URL-pad van het endpoint bestaat niet | Controleer de URL nogmaals in de webhooks-instellingen van Savebase |
500 | Onverwerkte fout in je ontvanger | Controleer je serverlogboeken op de uitzondering |
| Verbinding geweigerd / null-status | De server is offline of de URL is onjuist | Controleer of de server draait en openbaar bereikbaar is |