Wiederholungen & Fehlerbehebung

Erfahren Sie mehr über Webhook-Wiederholungszeitpläne, Timeouts und automatische Deaktivierungsregeln.

Wenn Parsurai versucht, ein Webhook-Ereignis bereitzustellen, und Ihr Server nicht erfolgreich antwortet, folgen wir einem strengen Wiederholungszeitplan, um eine Zustellung sicherzustellen.

Wiederholungszeitplan (Leiter)

Wenn Ihr Server mit einem wiederholbaren Fehler antwortet oder die Anfrage ein Timeout auslöst, wiederholen wir die Zustellung mit exponentiellem Backoff (30 Sekunden Basisverzögerung, Faktor 4x, begrenzt auf 6 Stunden, mit bis zu ±50 % Jitter). Wir stellen die Wiederholungsversuche ein — je nachdem, was zuerst eintritt — nach 8 Versuchen oder 24 Stunden seit dem Ereigniszeitpunkt.

Versuch	Ungefähre Verzögerung seit letztem Versuch	Ungefähre kumulierte Zeit
1. (Erster Versuch)	Sofort	0
2.	~30 Sekunden	~30 Sekunden
3.	~2 Minuten	~2,5 Minuten
4.	~8 Minuten	~10,5 Minuten
5.	~32 Minuten	~43 Minuten
6.	~2 Stunden 8 Minuten	~2 Stunden 51 Minuten
7.	~6 Stunden (Obergrenze)	~8 Stunden 51 Minuten
8. (Letzter Versuch)	~6 Stunden (Obergrenze)	~14 Stunden 51 Minuten

Die tatsächlichen Verzögerungen variieren durch Jitter um bis zu ±50 %, und der Zeitplan endet vorzeitig, sobald das Ereignis 24 Stunden alt ist.

Auslöser für Fehlversuche

In folgenden Fällen leiten wir einen Wiederholungsversuch ein:

Wiederholbare HTTP-Statuscodes: 408, 409, 425, 429 oder ein beliebiger 5xx-Status.
Verbindungs-Timeout: Das Herstellen der Verbindung zu Ihrem Server dauert länger als 5 Sekunden.
Lese-Timeout: Das Senden der Anfrage und Lesen der Antwort dauert länger als 10 Sekunden.
Netzwerkfehler: Fehler bei der DNS-Auflösung, Verbindungsabbrüche oder SSL/TLS-Handshake-Fehler.

Jeder andere Nicht-2xx-Statuscode (einschließlich 410 Gone und anderer 4xx-Antworten) gilt als endgültiger Fehlschlag — es erfolgt keine Wiederholung, und der Endpunkt wird nicht automatisch gelöscht oder soft-deleted.

Richtlinie zur automatischen Pausierung

Ein Webhook-Endpunkt wird automatisch pausiert, um unnötigen Datenverkehr zu vermeiden, sobald eine der folgenden Bedingungen zutrifft:

Der Endpunkt hat 20 aufeinanderfolgende endgültig fehlgeschlagene Zustellungen, oder
Es sind 72 Stunden seit der letzten erfolgreichen Zustellung des Endpunkts vergangen (bzw. seit seiner Erstellung, falls er noch nie erfolgreich war), während er 5 oder mehr aufeinanderfolgende Fehlschläge angesammelt hat.
Der Endpunkt-Status ändert sich in Ihrem Entwickler-Dashboard zu PAUSED.
Eine E-Mail-Benachrichtigung wird an die Kontoadministratoren gesendet.
Für diesen Endpunkt werden keine neuen Webhook-Zustellungen mehr in die Warteschlange gestellt, solange er pausiert ist.
Sobald das Problem behoben ist, können Sie den Endpunkt manuell über die Benutzeroberfläche der Entwicklereinstellungen wieder aktivieren.

Webhooks erneut senden (Replay)

Sie können jede historische Webhook-Zustellung der letzten 30 Tage (Pro-Plan) oder 90 Tage (Business-Plan) manuell über die Entwicklereinstellungen erneut senden. Replays erstellen einen neuen Zustellungsdatensatz, der sich auf das ursprüngliche Ereignis bezieht, sodass Sie verlorene Daten ohne Änderung der Webhook-Payloads erneut erfassen können.