Glossar   /   API-Entwicklung

REST-Ressource

Eine REST-Ressource ist ein eindeutig adressierbares fachliches oder konzeptionelles Objekt einer REST-Schnittstelle.

Auch bekannt als: Resource, Ressource

Was bedeutet REST-Ressource?

Das kann beispielsweise ein Auftrag oder eine Sammlung von Aufträgen sein. Die Anwendung greift nicht unmittelbar auf die Ressource selbst zu, sondern tauscht Darstellungen ihres Zustands aus, etwa als JSON.

Die Ressource ist deshalb nicht mit einer einzelnen Datenbankzeile gleichzusetzen. Ihre Grenze sollte zum fachlichen Zweck passen. Erlaubte Aktionen und Zugriffsrechte müssen klar beschrieben sein.

So sieht das in der Praxis aus

Beispiel: Ein Auftrag besitzt eine eigene Adresse. Darüber lässt sich sein Zustand lesen oder nach den erlaubten Regeln ändern.

Häufige Fragen

Ist eine Ressource dasselbe wie ihre JSON-Antwort?

Nein. JSON ist eine mögliche Darstellung. Dieselbe Ressource kann abhängig von Format und Berechtigung unterschiedlich dargestellt werden.

Muss jede Datenbanktabelle als Ressource erscheinen?

Nein. Die öffentliche Schnittstelle sollte fachlich passende Objekte anbieten. Interne Tabellenstrukturen müssen dafür nicht unverändert nach außen übernommen werden.

Was passiert, wenn jemand eine fremde Ressourcenkennung errät?

Die Anwendung muss den Zugriff trotzdem prüfen und gegebenenfalls ablehnen. Eine Kennung oder schwer erratbare Adresse ersetzt keine Berechtigungsprüfung.

Das könnte Sie auch interessieren

Passend zum Thema

API-Entwicklung Agentur Verbindliche Austauschbedingungen für angebundene Anwendungen erarbeiten.

Quellen und weiterführende Informationen

Roy Fielding: Architectural Styles, Kapitel 5 – REST
← Zurück zu allen Glossarbegriffen

Austauschregeln gemeinsam festlegen

Mehrere Anwendungen sollen verlässlich zusammenarbeiten? Stimmen Sie benötigte Angaben, Antworten und das Verhalten bei Abweichungen frühzeitig ab.

Kontakt aufnehmen