Einfach erklärt
Eine REST API ist wie die genaue Arbeitsanweisung für den Postboten im Internet. Sie legt fest, dass der Postbote immer die gleichen vier Aktionen ausführen darf: etwas abholen (Lesen), einen neuen Brief abgeben (Erstellen), einen alten Brief ändern (Aktualisieren) oder einen Brief wegwerfen (Löschen).
Alltagsbeispiel
Stell dir den Drive-in bei einem Schnellrestaurant vor. Du kannst nicht einfach in die Küche laufen. Du musst an den Schalter fahren und standardisierte Befehle rufen: „Ich hätte gern (GET) einen Burger.“ Die REST API ist dieser Schalter mit seinen festen Bestell-Regeln.
Kurze präzise Definition
REST APIs (Representational State Transfer Application Programming Interfaces) sind standardisierte Web-Schnittstellen, die HTTP-Protokolle nutzen, um eine maschinenlesbare Kommunikation und den Austausch von Ressourcen (oft in Form von JSON-Daten) zwischen verschiedenen Softwareanwendungen zu ermöglichen.
Ausführliche Erklärung
REST ist der absolute Branchenstandard für den dezentralen Datenaustausch im Web (der API-first-Ansatz). Es basiert auf Methoden wie GET (Daten abrufen), POST (neue Daten senden), PUT (Daten ändern) und DELETE. Da REST-APIs zustandslos (stateless) sind, muss jede Anfrage alle nötigen OIDC-Sicherheitstokens enthalten, um vom Identity Access Management durchgelassen zu werden.
Zusammenhang mit dem Digitalen Produktpass
Der DPP ist eine Daten-Sammelstelle. Wenn ein Nutzer den Pass öffnet, schickt die App im Hintergrund sofort einen REST-API-Aufruf (einen GET-Befehl) an den Auflösungsdienst (Resolver). Der Resolver antwortet im Bruchteil einer Sekunde und liefert die gewünschten Produktdaten oder das Zertifikat im JSON-LD-Format zurück auf das Handy des Nutzers.
Synonyme / Abkürzungen
RESTful Schnittstelle, Web-API.
Praxisbeispiel aus Unternehmen oder Industrie
Das ERP-System einer Fabrik generiert jede Minute einen neuen PCF (Carbon Footprint) für ein Bauteil. Das System nutzt eine REST API, um einen POST-Befehl an das DPP Repository zu schicken. Der Befehl lautet für den Computer übersetzt: „Erstelle hier einen neuen Datensatz für Bauteil X mit dem Wert 12 kg CO2.“
Quellen
- IETF: RFC 9110, HTTP Semantics.
https://www.rfc-editor.org/rfc/rfc9110 - OpenAPI Initiative: OpenAPI Specification.
https://spec.openapis.org/oas/latest.html - OpenAPI Initiative: The OpenAPI Specification explained.
https://learn.openapis.org/specification/