Löscht die Beziehung zur angeforderten ID.
DELETE/beziehungen/:id
Dieser Schnittstellenendpunkt löscht die Beziehung zur angegebenen beziehung.id
.
Ein DELETE zum Löschen einer Beziehung per beziehung.id
muss mit HTTP-DELETE auf die API /beziehungen/{beziehung.id}
erfolgen.
Es ist erforderlich, dass für eine Löschanfrage einer Beziehung das Attribut revision
der zugrunde liegenden Beziehung mitgeschickt wird. Der Schulconnex-Server überprüft
anhand des mitgeschickten Werts des Attributs revision
, ob der Datensatz in
der Zwischenzeit keine Änderung erfahren hat.
Request
Path Parameters
Der Pfad-Parameter bezieht sich auf die ID der Beziehung.
- application/json
Body
required
Revision der zugrunde liegenden Beziehung. Dieses Feld ist ein Pflichtfeld.
Responses
- 204
- 400
- 401
- 403
- 404
- 405
- 409
No Content
Bei einer erfolgreichen Ausführung der Löschanfrage wird es keine Antwort-Nutzdaten (Response Payload) geben.
Bad Request
Subcode 13: „Personenkontext wird genutzt." Dieser Fehler wird gemeldet, wenn Daten eines Personenkontexts bereits im Zusammenhang mit einem Anmeldevorgang an Dienste weitergeleitet wurden. In dem Fall muss die Löschung durch Setzen eines Löschzeitpunkts erfolgen, um sicherzustellen, dass andere Dienste über die Löschung informiert werden und eventuell existierende Information bei den Diensten gelöscht werden können.
Siehe Fehlerbehandlung
Unauthorized
Siehe Fehlerbehandlung
Forbidden
Siehe Fehlerbehandlung
Not found
Siehe Fehlerbehandlung
Method not allowed
Siehe Fehlerbehandlung
Conflict
Siehe Fehlerbehandlung