Was ist eine REST-API?

REST API ist ein architektonischer Stil, kein Standard, zum Aufbau verteilter Systeme. Es basiert auf Prinzipien wie Zustandslosigkeit, Client-Server-Architektur und der Verwendung standardmäßiger HTTP-Methoden (GET, POST, PUT, DELETE, PATCH) für Operationen an Ressourcen.

Schlüsselprinzipien von REST:

• Zustandslos (stateless): Der Server speichert keine Informationen über den Zustand des Clients zwischen Anfragen. Jede Anfrage enthält alle notwendigen Informationen für die Verarbeitung.
• Client-Server: Klare Trennung zwischen Client und Server. Jeder kann unabhängig voneinander entwickelt werden.
• Cachefähig: Antworten können als cachefähig oder nicht cachefähig markiert werden, was die Leistung verbessert.
• Schichtensystem: Der Client kann nicht erkennen, ob er direkt mit dem Server verbunden ist oder über Zwischenschichten.
• Einheitliche Schnittstelle: Standardisierte Wege, mit Ressourcen zu interagieren. Dazu gehören:
  • Ressourcenidentifikation (URI)
  • Manipulation von Ressourcen durch Repräsentationen
  • Selbstbeschreibende Nachrichten
  • Hypermedia als das Steuerungselement des Anwendungszustands (HATEOAS) - der Zustand der Anwendung wird durch Hyperlinks gesteuert.

Beispiel für die Verwendung standardmäßiger HTTP-Methoden:

HTTP-Methode	Aktion an der Ressource (z.B. /users)	Beschreibung
GET	/users oder /users/{id}	Abrufen der Benutzerliste oder eines bestimmten Benutzers.
POST	/users	Erstellen eines neuen Benutzers.
PUT	/users/{id}	Vollständige Aktualisierung der Benutzerdaten anhand der ID.
PATCH	/users/{id}	Teilaktualisierung der Benutzerdaten anhand der ID.
DELETE	/users/{id}	Löschen eines Benutzers anhand der ID.

REST API wird für die Interaktion zwischen verschiedenen Systemen und Anwendungen verwendet, z.B. zwischen Frontend und Backend.