Was ist eine Schnittstelle (API) – einfach erklärt?

Ein Bild

Eine API funktioniert wie eine Speisekarte. Sie sagt, was bestellt werden kann und in welcher Form es kommt. Was in der Küche passiert, geht Sie nichts an – und darf sich ändern, ohne dass Sie es merken.

Ohne API wäre es, als würden Sie selbst in die Küche gehen und im Kühlschrank suchen. Das funktioniert, bis jemand die Küche umbaut.

Warum das wichtig ist

Der direkte Zugriff auf die Datenbank eines fremden Systems ist die häufigste Ursache für Anbindungen, die nach einem Update kaputtgehen. Eine API ist eine Zusage: „Diese Felder gibt es, und sie heissen so."

Was zu einer belastbaren Schnittstelle gehört

• Dokumentation. Welche Anfragen gibt es, welche Antworten kommen zurück
• Versionierung. Änderungen dürfen bestehende Nutzer nicht brechen
• Zugriffsschutz. Wer darf was
• Fehlerbehandlung. Was passiert, wenn das Gegenüber nicht antwortet
• Begrenzung. Schutz vor Überlastung

Der vierte Punkt wird am häufigsten vergessen. Eine Schnittstelle ohne Wiederholungslogik verliert Daten unbemerkt.

Die praktische Frage vor jeder Anbindung

Gibt es eine dokumentierte API? Wenn ja, ist die Anbindung überschaubar. Wenn nein, bleibt Dateiaustausch – funktionsfähig, aber langsamer, fehleranfälliger und nicht in Echtzeit.

Diese Frage sollte vor der Aufwandsschätzung geklärt sein, nicht danach.