Der record
-Endpunkt steht unter der Endpunkt-URI /rest/v1/record
zur Verfügung. Er dient dem Abrufen (GET), Erstellen (POST), Ändern (PATCH), Ersetzen (PUT) und Löschen (DELETE) von Datensätzen.
Bei allen Aufrufen werden die Zugriffsrechte des jeweiligen Benutzers ausgewertet und entsprechend reagiert.
Aufrufsyntax pro Methode:
- GET:
/rest/v1/record/<recordkey>
- POST:
/rest/v1/record/<ormType>
- DELETE:
/rest/v1/record/<recordkey>
- PUT:
/rest/v1/record/<recordkey>
- PATCH:
/rest/v1/record/<recordkey>
Alle Methoden bis auf POST unterstützen bedingte Abfragen auf Basis von ETag oder dem letzten Änderungsdatum. Änderungen werden nur durchgeführt, wenn die Bedingung erfüllt ist.
Die Methoden zum Ändern oder Erstellen von Datensätzen erwarten im Inhalt der http-Anfrage eine JSON-Struktur mit den einzutragenden Daten, der Inhaltstyp der Anfrage muss in diesen Fällen auf “application/json” lauten. Die JSON-Struktur leitet sich in jedem Fall von den Informationen ab, die der typeinfo
-Endpunkt zu dem entsprechenden Datentyp liefert.