Express Kurier. Direkt.
Auch Overnight.
x25pronto Schweiz bringt Ware direkt ans Ziel. Für kleine Ware fährt ein Auto. Für mehr Platz gibt es Transporter oder XL. Direkt, Express und Overnight fahren von Montag bis Sonntag. Freie Zeiten stehen im Kalender.
Webhook‑Replay API: Design und Governance für manuelle Nachverarbeitung
Eine Replay‑API erlaubt das kontrollierte Neuversenden von Webhook‑Events. Dieser Leitfaden erklärt Authentifizierung, Filter, Audit‑Logs und Governance für sichere manuelle Nachverarbeitung.
Kurzantwort
Eine Replay‑API macht es möglich, fehlerhafte oder fehlgeleitete Webhook‑Events gezielt erneut an Empfänger zu senden. Kernanforderungen sind strikte Authentifizierung, präzise Filter zum Eingrenzen der Events, lückenlose Audit‑Logs und klare Governance‑Prozesse. In der Praxis kombiniert man Token‑basierte Auth mit Rollen, Zeitfenster‑Filter, Event‑IDs und unveränderliche Audit‑Logs, um Sicherheit und Rückverfolgbarkeit zu gewährleisten.
Warum eine Replay‑API nötig ist
Webhook‑Empfänger fallen aus, verarbeiten Events falsch oder entwickeln Bugs. Eine Replay‑API erlaubt es, genau betroffene Events erneut zu senden, statt ganze Systeme neu zu starten oder Kunden manuell zu informieren. Für Dienstleister in Zürich, Basel oder Genf reduziert das gezielte Replaying Aufwand und Ausfallzeiten.
Grundlegende Sicherheitsanforderungen
Sicherheit steht an erster Stelle. Verwenden Sie starke Authentifizierung (OAuth2 mit client‑credentials oder JWT mit kurzen Lebenszeiten). Beschränken Sie Replay‑Berechtigungen per Rolle. Verschlüsseln Sie Transport (TLS) und prüfen Sie Signaturen der Origin‑Events vor dem Replay, damit Empfänger Replay‑Fälschungen ablehnen können.
Authentifizierung und Autorisierung
Differenzieren Sie zwischen System‑ und Operatorzugang. Maschinen nutzen OAuth2‑Clients mit begrenzten Scopes (z. B. replay:read, replay:write). Menschen arbeiten über eine Webkonsole mit 2FA und zeitlich limitierten Sessions. Rollen (Viewer, Operator, Auditor, Admin) bestimmen, welche Filter, Zeiträume und Zielendpunkte ein Nutzer verwenden darf.
Filterung und Auswahl der Events
Bieten Sie Filter, die reproduzierbar und präzise sind: Event‑ID, Typ, Zeitfenster, Status (failed, delivered), Payload‑Attribute und Empfänger‑ID. Kombinieren Sie Filter mit Vorschau‑Funktion: Zeigen Sie eine Zusammenfassung von Payloads und Hashes, bevor ein Replay initiiert wird. Beschränken Sie die maximale Anzahl Events pro Replay‑Aufruf und erlauben Sie Batch‑Jobs mit Pagination.
Audit‑Logs und Nachvollziehbarkeit
Jede Replay‑Aktion muss auditierbar sein. Protokollieren Sie: wer (User/Client), wann, welche Event‑IDs, Zielendpunkte, Anzahl versendeter Versuche und Ergebniscodes. Speichern Sie unveränderliche Hashes der Payloads und Signaturen, damit Integritätsprüfungen möglich sind. Logs sollten revisionssicher und suchbar sein (z. B. über ELK oder ein SIEM).
Governance und Betriebsregeln
Definieren Sie Prozesse: Genehmigungspflichtige Replays ab X Events, Escalation für wiederholtes Fehlschlagen, und Aufbewahrungsfristen für Replay‑Logs. Legen Sie SLAs für Review‑Zeiten fest, kommunizieren Sie Limits gegenüber Kunden in der Schweiz und prüfen Sie Datenschutz‑Konformität (z. B. personenbezogene Daten maskieren oder ausschliessen).
Häufige Fragen
Wie verhindere ich Missbrauch der Replay‑API?
Kombinieren Sie knappe Token‑Laufzeiten, rollenbasierte Scopes, Rate‑Limits und Genehmigungsworkflows. Audit‑Logs und Alerts bei ungewöhnlichen Replay‑Mustern unterstützen die Früherkennung.
Welche Filter sind am wichtigsten?
Event‑ID, Zeitfenster, Status (failed/delivered), Empfänger‑ID und Payload‑Attribute. Diese Filter erlauben zielgenaue Replays ohne Seiteneffekte.
Wie lange sollte ich Replay‑Logs aufbewahren?
Praktisch sind mindestens 90 Tage für operative Fehleranalyse. Rechtliche oder Compliance‑Anforderungen können längere Fristen erfordern. Maskieren Sie personenbezogene Daten, wenn möglich.
Kann ein Replay die Empfänger‑Logik stören?
Ja. Deshalb bieten Sie Vorschauen, idempotente Headers oder Replay‑Markers an, und arbeiten Sie mit Empfängern an defensiver Logik, damit wiederholte Events korrekt gehandhabt werden.