Welche Prinzipien gibt es für eine einheitliche Schnittstelle?

Prinzipien der einheitlichen Schnittstelle (auch bekannt als Prinzipien der RESTful API-Designs, obwohl sie auch auf andere verteilte Systeme anwendbar sind):

1. Ressourcenidentifikation: Jeder Teil der adressierbaren Information muss eine eindeutige Kennung haben. Der Client interagiert mit Ressourcen unter Verwendung dieser Kennungen.
2. Manipulation von Ressourcen durch Darstellungen: Der Client erhält eine Darstellung der Ressource (z.B. im JSON- oder XML-Format) und kann den Zustand der Ressource ändern, indem er die modifizierte Darstellung zurück an den Server sendet.
3. Selbstbeschreibende Nachrichten: Jede Nachricht zwischen Client und Server muss ausreichend Informationen enthalten, um vollständig interpretiert werden zu können. Der Client sollte sich nicht auf externe Informationen oder den Sitzungszustand auf dem Server verlassen.
4. Hypermedia als Steuerungselement des Anwendungszustands (HATEOAS - Hypermedia As The Engine Of Application State): Der Server sollte Hyperlinks in den Antworten bereitstellen, die auf die nächsten möglichen Aktionen oder verwandte Ressourcen verweisen. Der Client navigiert durch die Anwendung, indem er diesen Links folgt, anstatt auf festgelegte URLs oder Logik zu vertrauen.
5. Client-Server-Architektur: Klare Trennung der Verantwortlichkeiten zwischen Client (der für die Benutzeroberfläche und die Initiierung von Anfragen zuständig ist) und Server (der Daten speichert und Anfragen verarbeitet). Diese Trennung verbessert die Skalierbarkeit und Portabilität des Clients.
6. Zustandslosigkeit (Stateless): Jede Anfrage des Clients an den Server muss alle notwendigen Informationen enthalten, damit der Server sie versteht und verarbeitet. Der Server speichert keine Informationen über den Sitzungszustand des Clients zwischen den Anfragen. Dies erhöht die Skalierbarkeit und Fehlertoleranz.

Die Einhaltung dieser Prinzipien trägt dazu bei, skalierbare, flexible und wartungsfreundliche verteilte Systeme zu erstellen.