Rest-API, was ist

Wenn Sie mit Technologie, digitalem Marketing oder Produkten arbeiten, haben Sie wahrscheinlich schon einmal das Akronym REST API gehört. Es ist das Rückgrat des modernen Internets. Es geht darum, wie Instagram mit dem Server kommuniziert, wie die Reise-Website nach Tickets bei verschiedenen Fluggesellschaften sucht und wie Ihre Bank einen Kartenkauf genehmigt.

Aber was genau ist REST? Und warum ist es zum globalen Standard geworden?

In diesem Artikel werden wir das technische Konzept entmystifizieren und klar erklären, was eine RESTful-API ist.

Was bedeutet das Akronym?

REST steht für Representational State Transfer. Es handelte sich um ein Konzept, das Roy Fielding im Jahr 2000 in seiner Doktorarbeit entwickelte.

Es handelt sich weder um Software noch um eine Bibliothek. Es ist ein Architekturstil. Dabei handelt es sich um eine Reihe von Regeln und Einschränkungen, deren Einhaltung es verschiedenen Systemen ermöglicht, auf effiziente, skalierbare und einfache Weise über das Internet miteinander zu kommunizieren.

Eine API, die REST-Regeln befolgt, wird RESTful genannt.

Wie es funktioniert (Die Web-Analogie)

REST funktioniert genauso wie das Surfen im Internet, das Sie bereits kennen. Wenn Sie auf eine Website zugreifen, fordern Sie (Client) eine Seite vom Server an. Der Server stellt Ihnen eine „Darstellung“ dieser Ressource (den HTML-Code der Seite) zur Verfügung.

In der REST-API ist es dasselbe, aber anstelle von HTML (zum Lesen durch Menschen) verwenden wir JSON (zum Lesen durch Maschinen).

HTTP-Verben (Aktionen)

REST verwendet Standard-HTTP-Protokollmethoden, um zu definieren, was Sie mit Daten tun möchten:

GET: Daten abrufen. (Beispiel: GET /usuarios -> Geben Sie mir die Liste der Benutzer).
POST: Daten erstellen. (Beispiel: POST /usuarios -> Diesen neuen Benutzer erstellen).
PUT: Vollständige Daten aktualisieren. (Beispiel: PUT /usuarios/1 -> Ersetzen Sie Benutzer 1 durch diese Daten).
LÖSCHEN: Daten löschen. (Beispiel: DELETE /usuarios/1 -> Benutzer 1 löschen).

Das ist intuitiv. Vor REST verwendeten wir komplexe Protokolle (wie SOAP), bei denen man für alles Namen erfinden musste (getUserList, createNewUserXml). In REST ist die URL das Substantiv (/usuarios) und die HTTP-Methode das Verb (GET, POST).

Staatenlos

Dies ist die wichtigste Regel. Der Server speichert keine Erinnerungen an Ihr bisheriges Surfen. Jede Anfrage (Anfrage) muss ALLE zur Verarbeitung notwendigen Informationen enthalten (z. B. wer Sie sind, das Authentifizierungstoken, was Sie wollen). Dadurch ist die API sehr schnell und skalierbar, da der Server keinen Speicher für die Speicherung von „Sitzungen“ verschwendet.

Die Anatomie eines REST-Aufrufs

Stellen Sie sich vor, Sie möchten die heutige Temperatur wissen.

Endpunkt (URL): https://api.clima.com/v1/previsao
Methode: GET
Kopfzeile: Authorization: Bearer 12345 (Ihr Personalausweis).
Body: (Leer in GET, aber in POST würde es Daten enthalten).

Serverantwort: Der Server gibt ein einfaches JSON mit dem Operationsstatus („Erfolg“) und den angeforderten Daten zurück, zum Beispiel eine Temperatur von 22 Grad Celsius für die Stadt Curitiba. Es handelt sich um ein leichtes Paket, das in jeder Sprache lesbar ist und von der Anwendung nur interpretiert und auf dem Bildschirm angezeigt werden muss.

Warum hat REST gewonnen?

Warum nutzen wir nicht andere Wege?

Einfachheit: Verwendet das HTTP-Protokoll, das bereits überall existiert. Jeder Browser und jede Programmiersprache versteht HTTP.
Client-Server-Trennung: Die Anwendung (Frontend) und der Server (Backend) sind völlig unabhängig. Sie können das Design der App ändern, ohne den Server zu beschädigen, und umgekehrt, solange das JSON-Format gleich bleibt.
Cache: REST nutzt Web-Caching. Wenn Sie GET /produtos ausführen, speichert der Browser oder das Netzwerk diese Antwort möglicherweise einige Minuten lang und speichert so Daten.

Fazit

REST API ist die Verkehrssprache des Internets. Das Verständnis seiner Prinzipien (Ressourcen, HTTP-Verben, zustandslos) ist für jeden Technologieprofi von grundlegender Bedeutung.

Obwohl neuere Technologien wie GraphQL und gRPC in bestimmten Fällen auf dem Vormarsch sind, bleibt REST aufgrund seiner Einfachheit und universellen Robustheit der Goldstandard für 90 % der Webintegrationen.