API-Integration

Was bedeutet API-Integration?

API steht für Application Programming Interface. Bei einer Integration sendet ein System strukturierte Anfragen an ein anderes und verarbeitet dessen Antwort. Dafür müssen Endpunkte, Datenformate, Authentisierung, Berechtigungen, Limits und mögliche Statuscodes bekannt sein.

Produktionsreif wird eine Verbindung erst durch ihren Fehlerweg. Dazu gehören Zeitüberschreitungen, begrenzte Wiederholungen, eindeutige Zustellzustände, Schutz vor Dubletten und ein manueller Klärungsweg. Monitoring sollte nicht nur prüfen, ob die API erreichbar ist, sondern ob der fachliche Datensatz im Zielsystem angekommen ist.

Worauf Sie achten sollten

• Der Datenvertrag enthält Pflichtfelder, Formate und Versionen.
• Authentisierung und Berechtigungen folgen dem Minimalprinzip.
• Timeouts, Limits, Wiederholungen und Dubletten sind ausdrücklich behandelt.
• Technischer Erfolg und fachliche Zustellung werden getrennt überwacht.

Wo die Grenzen liegen

Eine API-Verbindung behebt keine widersprüchlichen Stammdaten oder unklaren Verantwortlichkeiten. Vor der technischen Kopplung muss feststehen, welches System für welche Information führend ist.

Verwandte Begriffe

• Webhook

  Ein Webhook ist eine HTTP-Nachricht, die ein System bei einem Ereignis aktiv an eine vorher festgelegte Empfängeradresse sendet.

• Idempotenz

  Idempotenz bedeutet, dass dieselbe fachliche Operation mehrfach angefordert werden kann, ohne ihre beabsichtigte Wirkung mehrfach auszulösen.

• API (Programmierschnittstelle)

  Eine API (Application Programming Interface, deutsch Programmierschnittstelle) legt fest, wie ein Programm Funktionen und Daten eines anderen Programms nutzen kann, ohne dessen Bedienoberfläche zu verwenden.

• CRM (Customer-Relationship-Management)

  CRM steht für Customer-Relationship-Management: das planvolle Pflegen von Kundenbeziehungen und die Software, die Kontakte, Unternehmen, Vorgänge und Aktivitäten dafür an einer Stelle zusammenführt.

Passende Leitfäden und Leistungen

• Systeme miteinander verbinden

  Planung und Umsetzung nachvollziehbarer Schnittstellen zwischen Geschäftssystemen.

• CRM und Buchhaltung integrieren

  Praxisleitfaden zu Datenflüssen, Freigaben, Tests und Fehlerwegen.

• Fahrzeiten in der Online-Terminbuchung

  Was ein Routendienst über seine Schnittstelle liefert und welche Rückfallregel gilt, wenn er nicht antwortet.

Offizielle Quellen

1. IETF RFC 9110: HTTP Semantics
2. OWASP API Security Project