Prozessintegration / 11
Webhooks empfangen. Geschäftsvorgänge zuverlässig ausführen.
Ein Ereignis trifft ein und soll im nächsten System eine Aktion auslösen. Mehrfachzustellung, Verzögerung oder eine ausgefallene Ziel-API machen daraus einen Betriebsprozess. Wir entwickeln diesen Ablauf mit eindeutigen Ereignissen und überprüfbaren Effekten.
Die Ausgangslage
HTTP 200 allein beweist keinen ausgeführten Geschäftsprozess.
Ein Shop sendet ein Bestellereignis. Das ERP ist vorübergehend nicht erreichbar. Wird die gesamte Arbeit im Webhook-Request ausgeführt, kann ein Timeout erneute Zustellungen auslösen; wird sofort bestätigt, kann der Auftrag verloren gehen.
Wir trennen verifizierte Annahme und anschließende Verarbeitung. Der Sender bestimmt Signaturformat und Zustellregeln. Die Integration definiert Deduplizierung, Aufbewahrung und die Bedeutung einer erfolgreichen Bestätigung.
Was DataSource übernimmt
Empfang, Persistenz und Zielaktion trennen.
Eingang absichern
Signatur nach Senderdokumentation über die originalen Request-Bytes prüfen. Größe, Content-Type und unterstützte Ereignistypen begrenzen.
Dauerhaft annehmen
Ereignis in einem vereinbarten geschützten Speicher oder einer Queue sichern. Erst nach erfolgreicher Annahme den passenden HTTP-Erfolg zurückgeben.
Verarbeiten
Eindeutige IDs nutzen, Effekte idempotent gestalten und Zielantworten prüfen. Dauerhafte Fehler gesondert behandeln und kontrollierten Replay ermöglichen.
Technisches Szenario / Illustratives Beispiel
Annahme bestätigen, Verarbeitung getrennt verfolgen.
Illustrativer Payload. eventId und orderId sind verschiedene Identitäten. Eine wiederholte Zustellung muss nicht eine neue Bestellung erzeugen; Verarbeitungserfolg ist ein eigener Zustand.
Beispieldaten und vorgeschlagene Regeln. Die konkreten Schnittstellen und Geschäftsregeln werden für Ihr Projekt geprüft.
{
"eventId": "evt-1042",
"type": "order.approved",
"orderId": "ORD-8421",
"version": 3
}
verified → persisted → accepted
worker → effect checked → processedFehlerbehandlung, Sicherheit und Betrieb
Doppelte Zustellung und Teilfehler.
Duplikate und Absturz
Eine Ereignis-ID allein reicht nicht, wenn der Worker zwischen Zielaktion und Bestätigung ausfällt. Auch der Geschäftseffekt braucht Wiederholungsschutz oder einen Zielabgleich.
Reihenfolge
Nicht jeder Sender garantiert Reihenfolge. Versionen oder aktueller Zielstand verhindern, dass ein verspätetes Ereignis einen neueren Zustand zurücksetzt.
Replay
Fehlerzustand, Korrektur und erneute Ausführung nachvollziehbar führen. Payloads können personenbezogene Daten enthalten; Speicherung und Zugriff werden bewusst begrenzt.
Fachliche Fragen
Details, die vor der Umsetzung zählen.
Webhooks · HMAC · Queue · Deduplizierung · Replay · Betriebszustand
Ist Exactly-once garantiert?
Über mehrere Systeme ist das keine allgemeine Zusage. Wir planen mit wiederholter Zustellung und einer Verarbeitung, deren fachlicher Effekt sicher abgeglichen werden kann.
Müssen wir immer den ganzen Datensatz speichern?
Nur die für Verarbeitung und vereinbarten Fehlerbezug notwendigen Daten. Retention und Zugriff sind Teil des Betriebskonzepts.
Was tun, wenn der Sender keine Ereignis-ID liefert?
Ein belastbarer Schlüssel kann sich aus Ressource, Version und Ereignistyp ergeben. Ein einfacher Payload-Hash ist nicht automatisch ein fachlich eindeutiges Ereignis.
Für die technische Klärung
Mit Ihrem konkreten Ablauf beginnen.
Senderdokumentation zu Signatur, Retries und Ereignissen, anonymisierte Payloads sowie gewünschte Zielaktionen mitbringen. Bekannte Mehrfachzustellungen helfen beim Fehlerkonzept.
Im ersten Gespräch klären wir die verfügbaren Zugänge, Datenverantwortung und einen begrenzten ersten Datenfluss. Danach stimmen wir Umfang, Zuständigkeiten und Konditionen ab.
Anonymisierte Beispiele genügen für den Einstieg. Bitte keine Passwörter, Tokens oder personenbezogenen Produktivdaten in der ersten Anfrage senden.
Verwandte Aufgaben
Die nächste Verbindung im Kontext.
REST API Integration
Die Dokumentation ist da, ein Testrequest funktioniert. Im Alltag fehlen trotzdem Daten oder es entstehen doppelte Datensätze. DataSource verbindet Ihre REST-API mit dem konkreten Geschäftsprozess und plant auch den Fall, dass die Antwort ausbleibt.
Bestellungen & Status synchronisieren
Der Shop meldet bezahlt, das ERP kennt noch keinen Auftrag, der Versand hat bereits eine Trackingnummer. Wir verbinden diese Schritte mit definierten Zuständen, eindeutigen Auftragsreferenzen und einem geplanten Wiederanlauf.
Benutzer & Rechte automatisieren
Ein neuer Mitarbeiter braucht Zugänge in mehreren Anwendungen. Ein Teamwechsel verändert Rollen, ein Austritt verlangt den Entzug. Wir verbinden die führenden Personaldaten mit einem kontrollierten Prozess für diese Änderungen.
Technische Referenzen
Offizielle Dokumentation, geprüft am 6. Oktober 2026. Die Eignung hängt von der konkreten Installation und Version ab.