DEFINITION

Was ist eine API?

API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Sie legt fest, wie verschiedene Softwareanwendungen miteinander kommunizieren: welche Befehle gelten, welche Datenformate genutzt werden und welche Regeln beide Seiten einhalten müssen. Ein System kann so Funktionen oder Daten eines anderen Systems nutzen, ohne dessen internen Code zu kennen. APIs sind deshalb ein zentrales Element moderner Softwarearchitektur.

Wie funktionieren APIs?

APIs arbeiten nach dem Request-Response-Prinzip. Ein Client sendet eine Anfrage an eine Schnittstelle, der Server antwortet mit den angeforderten Daten oder einer Statusmeldung. Die Anfrage enthält in der Regel eine URL, eine Methode wie GET oder POST sowie weitere Informationen wie Header oder einen Body. Die Antwort kommt häufig im JSON- oder XML-Format zurück.

Zusätzlich nutzen viele APIs Authentifizierung über Schlüssel oder Token und liefern standardisierte Fehlercodes, damit Anwendungen verlässlich mit der Schnittstelle arbeiten können.

Unterschied zu verwandten Begriffen

SDK

Ein SDK, kurz für Software Development Kit, ist ein Paket aus Bibliotheken, Tools, Dokumentation und Beispielen. Es erleichtert die Arbeit mit einer API, indem es Entwicklern fertige Bausteine zur Verfügung stellt.

Unterschied zum API
Eine API definiert ausschließlich die Schnittstelle: die Regeln für Anfragen und Antworten. Ein SDK baut darauf auf und liefert zusätzliche Hilfsmittel, um diese Schnittstelle praktisch umzusetzen. Die API ist das Regelwerk, das SDK das Werkzeugset.

Interface

Ein Interface beschreibt abstrakt, welche Methoden und Funktionen ein Programm anbietet, ohne deren konkrete Umsetzung zu zeigen.

Unterschied zum API
Ein Interface existiert meist lokal innerhalb eines Systems, etwa als Konstrukt einer Programmiersprache. Eine API hingegen ist eine externe Kommunikationsschnittstelle, die in der Regel über ein Netzwerk angesprochen wird. Der Scope ist ein anderer.

REST-API

Eine REST-API ist eine spezielle Form der API, die auf HTTP-Standards aufbaut. Sie arbeitet zustandslos, speichert also zwischen zwei Anfragen keinen Sitzungsstatus, und nutzt Ressourcen-URIs gemeinsam mit HTTP-Methoden wie GET, POST oder DELETE.

Unterschied zum API
API ist der übergeordnete Begriff. Er beschreibt jede Art von Schnittstelle, unabhängig von Protokoll oder Architektur. Eine REST-API ist eine konkrete Ausprägung davon, die bestimmten Prinzipien folgt. Nicht jede API ist eine REST-API, aber jede REST-API ist eine API.