Eine REST API ist die Sprache, in der sich Programme im Web unterhalten – und wenn du sie einmal verstanden hast, fügt sich plötzlich das halbe Internet zu einem klaren Bild zusammen. In diesem Guide erklären wir dir REST mit einer Restaurant-Analogie, die hängen bleibt, zeigen dir die HTTP-Methoden als Tabelle und gehen ein echtes JSON-Beispiel Zeile für Zeile durch. Danach weißt du, was eine API macht, wie eine Anfrage aussieht und woran du eine richtig gute API erkennst.
- Eine API ist eine Schnittstelle, über die zwei Programme Daten austauschen – ohne dass eines das andere von innen kennen muss.
- REST ist ein verbreiteter Baustil für Web-APIs: Daten heißen Ressourcen und liegen unter klaren Adressen (Endpoints).
- Vier HTTP-Methoden reichen für fast alles: GET (lesen), POST (anlegen), PUT (ändern), DELETE (löschen).
- Der Server antwortet mit einem Statuscode (z. B.
200,404,500) und meist mit JSON.
Was ist eine API – und was bedeutet REST?
API steht für Application Programming Interface, auf Deutsch „Programmier-Schnittstelle“. Sie ist die definierte Tür, durch die ein Programm bei einem anderen etwas bestellen kann. Deine Wetter-App hat selbst keine Wetterdaten – sie fragt über eine API einen Wetterdienst und bekommt die Daten zurück. Du musst dafür nicht wissen, wie der Wetterdienst intern rechnet. Du nutzt nur seine Schnittstelle.
REST (Representational State Transfer) ist ein bestimmter Architekturstil für solche Web-Schnittstellen. Eine REST API baut konsequent auf den Mechanismen auf, die das Web sowieso schon nutzt: Adressen (URLs), HTTP-Methoden und Statuscodes. Genau das macht REST so beliebt – es braucht keine exotische Technik, sondern nutzt das HTTP-Protokoll, das jeder Browser ohnehin spricht.
Die Restaurant-Analogie
Stell dir ein Restaurant vor. Du sitzt am Tisch (das ist deine App). Die Küche kocht (das ist der Server mit der Datenbank). Dazwischen läuft der Kellner – das ist die REST API.
Du bestellst von der Speisekarte
Die Speisekarte ist die API-Dokumentation: Sie listet auf, was du überhaupt anfragen darfst. Du kannst nicht „irgendwas“ bestellen, nur was draufsteht.
Der Kellner trägt die Bestellung in die Küche
Du redest nie direkt mit der Küche. Der Kellner (die API) nimmt deine Anfrage entgegen und reicht sie strukturiert weiter – das schützt die Küche und hält die Regeln ein.
Du bekommst das Gericht – oder eine klare Rückmeldung
Entweder kommt dein Essen (die Daten, meist als JSON) oder eine ehrliche Ansage: „Ausverkauft“ (Fehlercode). Genau dieses saubere Antwortverhalten ist das Herz von REST.
HTTP-Methoden: GET, POST, PUT, DELETE
Jede Anfrage an eine REST API benutzt eine HTTP-Methode (auch „Verb“ genannt). Sie sagt dem Server, was du mit einer Ressource vorhast. Du kommst im Alltag mit vier Methoden extrem weit:
