01. Integrationsarchitektur und Freigabegrenzen

Eine Schnittstelle hat zwei Seiten, aber nur eine gemeinsame Wahrheit. Ohne Führungsregel beginnen Systeme, dieselben Werte gegeneinander zu korrigieren.

Die Schnittstelle als Produkt

Die Architektur muss Datenbesitz, Taktung, Synchronität, Fehlerzustand, Datenschutz, Verfügbarkeit und Rückfall erklären. Besonders wichtig ist die Grenze zwischen generischem CRUD und fachlichen X-ERP-Aktionen.

So wird die Anbindung robust

1. Zeichnen Sie Quelle, Ziel, Netzwerkweg, Vertrauensgrenze, Queue/Job und Monitoring.
2. Benennen Sie je Feld und Objekt das führende System.
3. Erstellen Sie eine Allowlist aus freigegebenem Controller, Methode und Zweck.
4. Definieren Sie Latenz, Volumen, Reihenfolge, Ausfallverhalten und Aufbewahrung.
5. Legen Sie Abbruch-, Rückfall- und Supportgrenzen fest.

Produktionsreife nachweisen

• Kein Datenobjekt besitzt zwei unkoordinierte Schreiber.
• Nicht unterstützte Endpunkte sind technisch und organisatorisch ausgeschlossen.
• Datenschutz und Lösch-/Aufbewahrungspflichten sind berücksichtigt.
• Ausfall eines Systems erzeugt einen definierten, sichtbaren Zustand.

Fehler, die erst im Betrieb teuer werden

• Bidirektionale Synchronisation ohne Konfliktregel erzeugt Pingpong.
• Ein UI-Endpunkt wird als öffentliche API behandelt.
• Buchen oder Stornieren wird durch direkten Status-Write ersetzt.

Das nehmen Sie mit

Die Integration besitzt eine Architektur, die Fachbereich, Sicherheit und Betrieb gemeinsam verstehen.

Weiterführender Link / Quelle

Weiterführende Themen

1. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 02. Anmeldung und Sitzungscookie
2. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 03. API-Rechte und eigener Integrationsbenutzer
3. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 04. Endpunkte, Datenverträge und Antworten

Häufige Fragen