Web-Entwicklung

Was ist eine API? REST einfach erklärt

APIs verbinden Anwendungen miteinander. Hier lernst du, was eine API ist, wie REST funktioniert und was HTTP-Methoden und Statuscodes bedeuten.

Anton

— 2 Min. Lesezeit
Teilen
Was ist eine API? REST einfach erklärt

Sobald du Webanwendungen baust, hörst du überall das Wort API. Aber was steckt dahinter? In diesem Beitrag erkläre ich dir verständlich, was eine API ist, was REST damit zu tun hat und wie du selbst eine API ansprechen kannst. Keine Sorge – das ist einfacher, als es klingt.

Was ist eine API?

API steht für "Application Programming Interface", auf Deutsch "Programmierschnittstelle". Eine API ist ein vereinbarter Weg, über den zwei Programme miteinander reden. Stell dir einen Kellner im Restaurant vor: Du sagst ihm deine Bestellung, er bringt sie der Küche und kommt mit dem Essen zurück. Die API ist dieser Kellner – sie nimmt deine Anfrage entgegen und liefert eine Antwort, ohne dass du die Küche kennen musst.

Was bedeutet REST?

REST (Representational State Transfer) ist ein verbreiteter Stil, um Web-APIs zu bauen. Eine REST-API stellt Daten über URLs bereit, die man Endpunkte nennt. Jeder Endpunkt steht für eine Ressource, zum Beispiel Nutzer oder Produkte:

https://api.example.com/users      # alle Nutzer
https://api.example.com/users/42   # der Nutzer mit ID 42

Das Schöne an REST: Die Struktur ist vorhersehbar. Wenn du /users kennst, errätst du /products fast von selbst.

Die HTTP-Methoden

Mit derselben URL kannst du verschiedene Dinge tun – je nach HTTP-Methode. Die vier wichtigsten sind:

  • GET – Daten abrufen (lesen)
  • POST – neue Daten anlegen
  • PUT – vorhandene Daten aktualisieren
  • DELETE – Daten löschen

So sprichst du dieselbe Ressource auf unterschiedliche Weise an. Ein GET /users/42 liest den Nutzer, ein DELETE /users/42 löscht ihn.

Daten im JSON-Format

REST-APIs tauschen Daten meist im JSON-Format aus. JSON ist leicht lesbar und sieht aus wie ein JavaScript-Objekt:

{
  "id": 42,
  "name": "Anna",
  "email": "anna@example.com",
  "aktiv": true
}

Wenn du eine GET-Anfrage stellst, antwortet der Server mit solchen JSON-Daten. Bei POST sendest du selbst JSON mit, um zum Beispiel einen neuen Nutzer anzulegen.

Statuscodes verstehen

Jede Antwort einer API enthält einen HTTP-Statuscode, der dir sagt, ob alles geklappt hat. Die wichtigsten Gruppen:

  • 2xx – Erfolg, z.B. 200 OK oder 201 Created
  • 4xx – Fehler beim Client, z.B. 404 Not Found oder 401 Unauthorized
  • 5xx – Fehler beim Server, z.B. 500 Internal Server Error

Den berühmten 404 kennst du sicher von kaputten Links. In APIs hilft er dir, Fehler gezielt zu behandeln.

Eine API ansprechen

Im Browser oder in Node.js kannst du mit fetch eine API aufrufen. Hier ein einfaches Beispiel, das Nutzerdaten lädt:

fetch("https://api.example.com/users/42")
  .then((response) => response.json())
  .then((daten) => console.log(daten))
  .catch((fehler) => console.error("Fehler:", fehler));

Du stellst die Anfrage, wartest auf die Antwort, wandelst sie mit .json() um und kannst die Daten dann nutzen. Genau so reden Frontend und Backend miteinander.

Fazit

Eine API ist die Schnittstelle, über die Programme Daten austauschen. Mit REST machst du das über klare URLs, HTTP-Methoden wie GET und POST sowie das JSON-Format. Die Statuscodes verraten dir, ob eine Anfrage erfolgreich war. Mit diesem Wissen kannst du fremde APIs nutzen und verstehst, wie moderne Web-Apps im Hintergrund kommunizieren. Im nächsten Schritt schauen wir uns an, wie du mit Node.js selbst zum Server-Programmierer wirst.

Weiterlesen