Zustellprotokolle und Tests
Die Webhook-Einstellungen bieten ein Zustellprotokoll pro Endpunkt. Prüfe damit eingehende Ereignisse, untersuche Fehler und sende ein frisches Datenbeispiel ohne echte Aktivität auszulösen.
Zustellprotokolle ansehen
1
Einstellungen → Webhooks öffnen
Navigiere zu
Dashboard → Settings → Webhooks.2
Eine Webhook-Zeile aufklappen
Klicke auf Zustellprotokolle auf einer Webhook-Karte. Die letzten 50 Zustellversuche erscheinen mit dem neuesten zuerst.
3
Jeden Eintrag prüfen
Jede Zeile zeigt den Ereignistyp, den HTTP-Statuscode, die Antwortzeit, den Zeitstempel und gegebenenfalls eine Fehlermeldung.
Protokollfelder
| Feld | Beschreibung |
|---|---|
| Ereignis | Der ausgelöste Ereignistyp (z. B. post.saved) |
| Status | Von deinem Endpunkt zurückgegebener HTTP-Status. null bei Zeitüberschreitung oder abgelehnter Verbindung. |
| Antwortzeit | Gesamtzeit in Millisekunden vom Senden bis zum letzten Antwortbyte. |
| Erfolgreich | Grünes Häkchen = HTTP 2xx. Rotes Kreuz = jedes andere Ergebnis. |
| Fehler | Menschenlesbare Fehlermeldung bei fehlgeschlagenen Zustellungen (z. B. Request timed out (10s)). |
| Zugestellt am | UTC-Zeitstempel des Zustellversuchs. |
Ein Testereignis senden
1
Die Webhook-Karte aufklappen
In
Settings → Webhooks, suche deinen Webhook und klicke auf Testereignis senden.2
Zustellprotokoll prüfen
Die Testzustellung erscheint innerhalb weniger Sekunden oben im Zustellprotokoll. Prüfe, ob du Folgendes siehst:
200 Status.Testereignisse sind echte HTTP-Anfragen
Das Testereignis durchläuft dieselbe Pipeline wie ein echtes Ereignis, einschließlich HMAC-Signierung. Dein Signaturprüfcode wird vollständig getestet.
Kein automatischer Neuversuch
Jede Zustellung wird einmal versucht. Das Protokoll dient nur der Diagnose; für ein fehlgeschlagenes Live-Ereignis gibt es keine Schaltfläche zum erneuten Senden. Prüfe nach der Reparatur eines Endpunkts mit „Test“, ob sie erfolgreich war.
Häufige Fehlerursachen
| Fehler / Status | Wahrscheinliche Ursache | Lösung |
|---|---|---|
Request timed out (10s) | Der Server brauchte länger als 10 s für eine Antwort | Zurück 200 sofort, dann asynchron verarbeiten |
401 | Signaturprüfung fehlgeschlagen | Lies den unverarbeiteten Body unbedingt vor dem JSON-Parsing |
404 | Der URL-Pfad des Endpunkts existiert nicht | Prüfe die URL in den Savebase-Webhook-Einstellungen noch einmal |
500 | Unbehandelter Fehler in deinem Empfänger | Prüfe deine Serverprotokolle auf die Ausnahme |
| Verbindung abgelehnt / Status null | Server nicht erreichbar oder URL falsch | Prüfe, ob der Server läuft und öffentlich erreichbar ist |