Schnittstellen
Was ist eine REST-API? Erklärt ohne Entwicklerjargon
Eine API ist eine vereinbarte Schnittstelle zwischen zwei Programmen. Was dabei passiert und warum Dokumentation wichtiger ist als das Protokoll.
Eine API ist eine Absprache: Programm A fragt Programm B nach Daten oder übergibt eine Aufgabe. REST beschreibt, wie diese Abfrage üblicherweise aufgebaut ist – über normale HTTP-Adressen und Standardmethoden.
Die vier Grundoperationen
- GET liest einen Datensatz, etwa einen Artikel.
- POST legt etwas Neues an, etwa eine Bestellung.
- PUT oder PATCH ändert einen bestehenden Datensatz.
- DELETE entfernt einen Datensatz.
Die Adresse benennt die Ressource, zum Beispiel /artikel/4711. Die Antwort enthält einen Statuscode: 200 bedeutet Erfolg, 404 bedeutet nicht gefunden, 500 bedeutet ein Fehler auf dem Server.
Warum Authentifizierung entscheidend ist
Eine offene Schnittstelle kann jeder aufrufen. Deshalb braucht jede API eine Form der Authentifizierung: API-Keys für einfache Fälle, OAuth für Zugriffe im Namen eines Nutzers, signierte Requests bei sicherheitskritischen Prozessen. Zugangsdaten gehören niemals in den Browser-Code.
Was eine gute API ausmacht
Nicht das Protokoll, sondern die Nachvollziehbarkeit. Eine gute Schnittstelle nennt ihre Felder, ihre Fehlerfälle und ihre Grenzen. Sie verhält sich bei Wiederholungen gleich, statt doppelte Datensätze zu erzeugen. Und sie protokolliert, was passiert ist.
Der häufigste Fehler
Zu glauben, eine Verbindung sei fertig, sobald ein Testaufruf funktioniert. Im Alltag entscheiden Timeouts, fehlende Felder, Rate Limits und abgelaufene Tokens darüber, ob eine Integration trägt. Genau dafür braucht es Fehlerbehandlung – und jemanden, der sie liest.