Alle Begriffe
Glossar
REST
Auch: RESTful API
Ein Baustil für Schnittstellen über HTTP: Ressourcen mit klaren Adressen, Standardmethoden und zustandslosen Aufrufen.
Der Vorteil ist Verbreitung: Jede Sprache, jedes Werkzeug und jeder Entwickler kann damit umgehen, ohne etwas zu installieren.
Der Baustil sagt wenig über Details wie Fehlerformate, Blätterung oder Versionierung. Genau dort entstehen die Unterschiede zwischen einer angenehmen und einer mühsamen Schnittstelle.
Woran Sie es erkennen
- Eine Schnittstelle soll von Dritten genutzt werden.
- Es gibt viele verschiedene Aufrufer mit verschiedenen Sprachen.
- Werkzeuge zum Testen sollen ohne Aufwand funktionieren.
Häufig gefragt
Wie versioniere ich eine REST-Schnittstelle sinnvoll?
Über den Pfad, also /v1/, wenn ein Bruch unvermeidbar ist, und ansonsten gar nicht. Die meisten Änderungen lassen sich additiv gestalten: Felder ergänzen statt umbenennen, alte Felder eine Weile mitliefern. Jede Version, die man vermeidet, spart Jahre Pflege.