Was ist eine API? Einfach erklärt
Kurzantwort
Eine API ist die definierte Schnittstelle, über die ein Programm Funktionen und Daten für andere Programme bereitstellt – wie eine Speisekarte, die sagt, was man bestellen kann. Der Aufrufer muss nicht wissen, wie es intern funktioniert. Im Web sind REST-APIs verbreitet: Sie werden über HTTP angesprochen und liefern meist JSON zurück.
Teil des Lernpfads Programmieren und Softwareentwicklung · Schritt 15 von 18
Wenn deine Wetter-App die Vorhersage anzeigt, hat sie das Wetter nicht selbst gemessen – sie hat bei einem anderen System nachgefragt. Genau dafür gibt es APIs. Sie sind der Grund, warum moderne Software nicht jedes Rad neu erfinden muss.
Was ist eine API?
API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Sie ist die klar definierte Stelle, an der ein Programm Funktionen und Daten für andere Programme bereitstellt.
Dieses Verstecken der Interna ist der eigentliche Gewinn: Der Anbieter kann seine Software intern umbauen, ohne dass alle Nutzer ihre Programme anpassen müssen – solange die Schnittstelle gleich bleibt.
Was ist eine REST-API?
Im Web hat sich ein bestimmter Stil durchgesetzt: REST. Eine REST-API wird über HTTP angesprochen – also mit denselben Mitteln wie eine Webseite. Jede Ressource hat eine eigene Adresse (einen Endpunkt), und die gewünschte Aktion steckt in der HTTP-Methode:
| Methode | Bedeutung | Beispiel |
|---|---|---|
| GET | Daten abrufen | Liste aller Azubis holen |
| POST | neu anlegen | einen Azubi hinzufügen |
| PUT | ändern | Daten eines Azubis aktualisieren |
| DELETE | löschen | einen Azubi entfernen |
Eine Anfrage und ihre Antwort sehen dann etwa so aus:
Anfrage: GET /api/azubis/42
Antwort: 200 OK
{ "id": 42, "name": "Aylin", "beruf": "IT-Systemkauffrau" }Die Antwort kommt meist im Format JSON, weil es kompakt und leicht zu verarbeiten ist.
Wozu das Ganze?
Selbstkontrolle
Selbstkontrolle
Du willst über eine REST-API einen neuen Datensatz anlegen. Welche HTTP-Methode nutzt du?
Häufige Fragen
Was ist der Unterschied zwischen einer API und einer Webseite?
Beide werden oft über HTTP angesprochen, richten sich aber an unterschiedliche Empfänger. Eine Webseite liefert HTML, das für Menschen im Browser dargestellt wird. Eine API liefert strukturierte Daten wie JSON, die ein anderes Programm weiterverarbeitet. Dieselbe Anwendung kann beides anbieten.
Was bedeutet REST?
REST steht für Representational State Transfer und beschreibt einen Architekturstil für Schnittstellen im Web. Kennzeichnend sind eindeutige Adressen für Ressourcen, die Nutzung der HTTP-Methoden für die Aktionen und zustandslose Anfragen: Jede Anfrage enthält alle nötigen Informationen, der Server merkt sich zwischen zwei Aufrufen nichts.
Warum sind APIs oft geschützt?
Weil sie Zugriff auf Daten und Funktionen geben, die nicht für jeden bestimmt sind, und weil ihre Nutzung Rechenzeit kostet. Deshalb verlangen viele APIs eine Authentifizierung, etwa über einen Schlüssel oder ein Token, und begrenzen die Zahl der Anfragen pro Zeitraum.
Muss ich wissen, wie eine API intern funktioniert?
Nein, und genau das ist ihr Sinn. Du musst nur die Schnittstelle kennen: welche Endpunkte es gibt, welche Daten du mitschicken musst und was zurückkommt. Diese Informationen stehen in der API-Dokumentation. Das Innenleben kann sich ändern, ohne dass dein Programm angepasst werden muss.
Weiterlesen: Was ist eine Datenbank? Tabellen und SQL · Was ist Open Source? Einfach erklärt · IoT und Industrie 4.0: vernetzte Systeme verstehen
Das Wichtigste in Kürze
- Eine API ist die definierte Schnittstelle eines Programms für andere Programme.
- Sie versteckt das Innenleben – wie eine Speisekarte die Küche.
- REST-APIs nutzen HTTP: GET, POST, PUT, DELETE als Aktionen.
- Statuscodes: 200 Erfolg, 404 nicht gefunden, 401 nicht angemeldet, 500 Serverfehler.
- Antworten kommen meist als JSON.