Worum es geht: Eine API ist die Tür, durch die Programme miteinander sprechen. Wer verstanden hat, wie eine Anfrage aufgebaut ist und was ein Statuscode bedeutet, kann fast jeden Fehler in einer Webanwendung einkreisen – und einem KI-Agenten sagen, wo er suchen soll.
1. Das Grundprinzip
Eine Schnittstelle nach dem REST-Muster folgt immer derselben Logik: Ein Verb sagt, was geschehen soll, ein Pfad sagt, womit, und ein Statuscode sagt, wie es ausgegangen ist. Die Daten selbst reisen als JSON – ein Textformat, das Menschen lesen und Maschinen zuverlässig verarbeiten können.
GET /api/anfragen
← 200
[{"id": 1, "name": "Weber GmbH"}, {"id": 2, "name": "Bau Nord"}]
Alle Anfragen holen: Die Liste kommt zurück. GET verändert nie etwas – dieselbe Anfrage zweimal zu stellen ist unschädlich.
2. Die Statuscodes, die zählen
| Code | Bedeutung | Wer hat das Problem |
|---|---|---|
| 200 / 201 / 204 | geklappt / angelegt / erledigt ohne Inhalt | niemand |
| 400 | Anfrage unvollständig oder unlogisch | der Aufrufer |
| 401 / 403 | nicht angemeldet / angemeldet, aber nicht berechtigt | der Aufrufer |
| 404 | gibt es nicht | meist der Aufrufer |
| 429 | zu viele Anfragen | der Aufrufer, vorübergehend |
| 500 / 502 / 503 | Fehler oder Überlastung auf dem Server | der Server |
3. JSON in drei Sätzen
JSON kennt nur sechs Arten von Werten: Text in doppelten Anführungszeichen, Zahlen, true/false, null, Listen in eckigen Klammern und Objekte in geschweiften. Schlüssel stehen immer in doppelten Anführungszeichen. Ein Komma nach dem letzten Eintrag ist nicht erlaubt – der häufigste Tippfehler überhaupt.
4. Wie man eine API prüft
Die Entwicklerwerkzeuge des Browsers zeigen unter „Netzwerk“ jede Anfrage: Verb, Pfad, Statuscode, gesendete und empfangene Daten. Das ist das wichtigste Werkzeug bei der Fehlersuche – und der Grund, warum Sie einem Agenten präzise Hinweise geben können: „Die Anfrage geht raus, kommt aber mit 422 zurück, und im Rumpf steht, dass flaeche eine Zahl sein soll.“
Auf der Kommandozeile leistet curl dasselbe. Für wiederkehrende Tests lohnt sich eine kleine Sammlung gespeicherter Anfragen, die nach jeder Änderung durchläuft.
5. Häufige Fragen
Was ist der Unterschied zu GraphQL? Bei REST bestimmt der Server, welche Felder eine Antwort enthält; bei GraphQL fragt der Aufrufer genau die Felder ab, die er braucht. Für die meisten Projekte im Mittelstand ist REST einfacher und völlig ausreichend.
Warum nicht einfach direkt auf die Datenbank? Weil dann jede Prüfung fehlt: wer etwas darf, ob die Daten stimmen, was mitprotokolliert wird. Die API ist genau diese Prüfstelle.
Muss eine API öffentlich sein? Nein. Die meisten APIs sind intern – sie verbinden nur das eigene Frontend mit dem eigenen Backend.
Stand: September 2026. Die Übungen laufen vollständig in Ihrem Browser – es wird nichts gespeichert oder übertragen.