Löscht den Personenkontext zur angeforderten ID.
DELETE/personenkontexte/:id
Dieser Schnittstellenendpunkt löscht den Personenkontext zur angegebenen
personendatensatz.personenkontexte.id
.
Ein DELETE zum Löschen eines Personenkontexts per personendatensatz.personenkontext.id
muss mit HTTP-DELETE auf die API /personenkontexte/{personendatensatz.personenkontext.id}
erfolgen.
Die Anfrage-Nutzdaten (Request Payload) beinhalten ein JSON-Objekt des Datentyps Personenkontext.
Siehe auch Datenmodell Personenkontext
.
Es ist erforderlich, dass für eine Löschanfrage eines Personenkontexts das Attribut
personenkontext.revision
des zugrunde liegenden Personenkontexts mitgeschickt wird.
Der Anmeldeservice überprüft anhand des mitgeschickten Werts des Attributs personenkontext.revision
,
ob der Datensatz des Personenkontexts in der Zwischenzeit keine Änderung erfahren hat.
Request
Path Parameters
Der Pfad-Parameter bezieht sich auf die ID des Personenkontexts.
- application/json
Body
required
Revision der Person des zugrunde liegenden Personenkontext. 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