Ereignis und Zustellung getrennt definieren
Beschreiben Sie die Bedeutung, den Entstehungszeitpunkt und die betroffene Ressource jedes Ereignisses. Vergeben Sie eine dauerhafte Kennung, die bei erneuter Zustellung gleich bleibt. Trennen Sie diese Identität von einzelnen HTTP-Anfragen und Zustellversuchen. Ergänzen Sie eine Schemaversion und genügend Kontext, damit der Empfänger den maßgeblichen Datensatz findet. Aus einer vagen Meldung wie „etwas geändert“ sollte niemand einen Geschäftsvorgang erraten müssen. Erklären Sie optionale Felder, fehlende Werte und Datensatzänderungen durch Beispiele. Vereinbaren Sie, ob eine Nachricht einen vollständigen Zustand enthält oder zum Abruf des aktuellen Zustands auffordert.
Duplikate und Reihenfolge festlegen
Rechnen Sie mit wiederholter Zustellung und Nachrichten, die nach neueren Ereignissen eintreffen. Der Empfänger sollte verarbeitete Ereignisse erfassen und die Geschäftshandlung sicher wiederholbar gestalten. Eine doppelte Nachricht darf nicht zwei Berechtigungen oder Supportfälle anlegen, sofern das nicht ausdrücklich gewollt ist. Für reihenfolgeabhängige Änderungen brauchen Sie eine Ordnungsreferenz oder eine Prüfung gegen den aktuellen Ressourcenzustand. Die Ankunftszeit darf nicht unerklärt die fachliche Reihenfolge ersetzen. Testen Sie bewusst vermischte Ereignisse und beschreiben Sie das erwartete Ergebnis vor der Implementierung. Beide Teams müssen wissen, welches System Konflikte entscheidet.
Fehler ohne endlose Wiederholungen sichtbar machen
Definieren Sie eine angenommene Zustellung und unterscheiden Sie vorübergehende Fehler von Anfragen, die erst nach einer Änderung erfolgreich sein können. Begrenzen Sie Wiederholungen, zeigen Sie Versuche und überführen Sie ungelöste Ereignisse in einen prüfbaren Zustand. Verantwortliche benötigen Ereigniskennung, Ziel, letzten Versuch, Antwortkategorie und nächsten Schritt. Schützen Sie sensible Nachrichtenfelder in Protokollen und Oberflächen. Eine Zeitüberschreitung kann den Sender im Unklaren lassen, obwohl der Empfänger fertig ist. Untersuchen Sie deshalb dauerhafte Kennungen auf beiden Seiten. Eine Wiederholungsschaltfläche muss ihre Wirkung erklären und die ursprüngliche Ereignisidentität bewahren.
Verantwortlichen einen praktischen Betriebsleitfaden geben
Dokumentieren Sie Einrichtung, Endpunktprüfung, Geheimniswechsel, Testereignisse und vorübergehendes Pausieren. Benennen Sie den Verantwortlichen des Empfängerendpunkts und die Prüfung von Konfigurationsänderungen. Ermöglichen Sie die Einsicht in ein Beispielereignis ohne Produktionsgeheimnisse und kennzeichnen Sie Umgebungen eindeutig. Prüfen Sie bei der Abnahme einen ausgefallenen Empfänger, ungültige Daten, doppelte Ereignisse und Wiederaufnahme nach korrigierter Konfiguration. Kontrollieren Sie die resultierenden Kundendaten ebenso wie die Zustellanzeige. Das sinnvolle Ergebnis ist eine verlässliche Verbindung mit erklärbarem Verhalten, nicht lediglich ein grünes Erfolgszeichen nach einer einzelnen Demonstrationsanfrage.