/ Software-Lexikon
API-First
Architekturansatz, bei dem die Schnittstelle vor der Oberfläche entworfen wird — und Anbindungen wie Systemwechsel dadurch bezahlbar bleiben.
API-First bezeichnet einen Architekturansatz, bei dem die Schnittstelle eines Systems zuerst entworfen und als maschinenlesbare Spezifikation festgeschrieben wird — Oberfläche, App und Fremdsysteme arbeiten anschließend gegen genau diesen Vertrag. Die Schnittstelle ist damit kein nachträglicher Anbau, sondern das eigentliche Produkt.
Der Gegenentwurf ist der Normalfall gewachsener Software: Die Fachlogik steckt in der Oberfläche, Daten sind nur über Masken erreichbar, und wenn ein zweites System sie braucht, entsteht ein nächtlicher CSV-Export oder ein direkter Datenbankzugriff an der Anwendung vorbei. Beides funktioniert — und beides wird zum Problem, sobald sich an einer Stelle etwas ändert.
Praktisch heißt API-First: eine dokumentierte Spezifikation (verbreitet ist OpenAPI), versionierte Endpunkte, klare Fehlersemantik und die Regel, dass die eigene Oberfläche keinen privilegierten Sonderweg nimmt. Wenn die eigene Anwendung dieselbe Schnittstelle benutzt wie jeder Fremdzugriff, ist deren Qualität im Alltag automatisch getestet.
Wirtschaftlich zahlt sich das an drei Stellen aus: Anbindungen an ERP, Shop oder Kundenportal kosten Tage statt Wochen, weil die Funktionen bereits von außen erreichbar sind. Ein späterer Systemwechsel lässt sich schrittweise fahren, weil eine vorgeschaltete Fassade den Verkehr modulweise umleiten kann. Und der Wechsel des Dienstleisters bleibt real möglich, weil Funktionsumfang und Datenzugang beschrieben sind statt implizit.
Für den Mittelstand heißt das
Fordern Sie die Schnittstellendokumentation als Teil der Lieferung ein, nicht als kostenpflichtige Option — bei Eigenentwicklungen ebenso wie beim Kauf von Standardsoftware. Die Frage „Was kann ich mit diesem System von außen tun, ohne den Hersteller zu fragen?“ entscheidet später über die Kosten jeder Erweiterung, jeder Anbindung und jedes Wechsels.