Zustellung & Wiederholung
Zustellung, Wiederholungen & automatische Pausierung
Eine fehlgeschlagene Zustellung (Antwort ungleich 2xx, Zeitüberschreitung oder Netzwerkfehler) wird mit exponentiellem Backoff wiederholt: 5 s, 30 s, 2 Min, 10 Min, 1 Std, 4 Std, dann ein letzter Versuch etwa 24 Stunden nach dem ersten. Schlägt ein Endpunkt 72 Stunden durchgehend fehl, wird er automatisch pausiert, und der Ersteller wird per E-Mail benachrichtigt — bis zur Behebung und Fortsetzung werden keine weiteren Ereignisse zugestellt.
Zustellprobleme beheben
Häufige Antwortergebnisse und wie Sie jedes davon beheben.
Keine Verbindung möglich | Stellen Sie sicher, dass Ihr Host öffentlich erreichbar und nicht durch eine Firewall blockiert ist. |
3xx-Weiterleitung | Weiterleitungen gelten als Fehler. Richten Sie den Endpunkt direkt auf die endgültige URL. |
4xx-Clientfehler | Ihr Server hat die Anfrage abgelehnt. Prüfen Sie, ob die URL korrekt ist und keine von uns nicht gesendete Authentifizierung erfordert. |
5xx-Serverfehler | Ihr Server hat beim Verarbeiten der Anfrage einen Fehler gemeldet. Prüfen Sie Ihre Anwendungsprotokolle. |
Zeitüberschreitung | Ihr Endpunkt hat zu lange gebraucht. Geben Sie sofort 2xx zurück und verarbeiten Sie das Ereignis asynchron. |
Die Reihenfolge der Ereignisse ist nicht garantiert
Ereignisse können in falscher Reihenfolge eintreffen, und Wiederholungen bedeuten, dass dasselbe Ereignis mehr als einmal zugestellt werden kann. Verlassen Sie sich nicht auf die Zustellreihenfolge, und entfernen Sie Duplikate anhand der id des Umschlags — niemals anhand von created_at, da sich zwei Ereignisse einen Zeitstempel teilen können.
Wiederholung
Jede einzelne Zustellung — erfolgreich oder fehlgeschlagen — kann jederzeit über den Zustellverlauf unter Einstellungen → Entwickler → Webhooks erneut ausgelöst werden. Eine Wiederholung durchläuft dieselbe Zustell-Pipeline mit einem neuen Wiederholungszyklus; sie sendet nicht automatisch etwas rückwirkend erneut.
Ihren Endpunkt testen
Nutzen Sie „Testereignis senden“ unter Einstellungen → Entwickler → Webhooks, um ein synthetisches ping.sent-Ereignis über die echte Zustell-Pipeline auszulösen — signiert wie jedes andere Ereignis —, damit Sie Ihren Endpunkt testen können, ohne auf ein echtes Ereignis zu warten.