Beziehung zur angeforderten ID.
GET/beziehungen/:id
Dieser Schnittstellenendpunkt gibt die Beziehung zur angegebenen beziehung.id
zurück.
Ein READ zum Abfragen einer Beziehung per ID muss mit HTTP-GET auf die API /beziehungen/{beziehung.id}
erfolgen. Die Antwort-Nutzdaten (Response Payload) beinhalten
ein JSON-Objekt des Datentyps Beziehung.
Siehe auch Datenmodell Beziehung
.
Zusätzlich zu den Informationen aus dem Datenmodell wird ein Attribut ist_von_ktid
mitgeliefert, welches angibt, welchen Personenkontext die Beziehung referenziert.
Beziehungen können nicht direkt geändert werden. Sollte sich die Beziehung ändern, wenn beispielsweise eine andere Person das Sorgerecht bekommt oder sich die Rolle in einer Beziehung ändert, so ist die alte Beziehung zu löschen und eine neue Beziehung zu erstellen.
Request
Path Parameters
Der Pfad-Parameter bezieht sich auf die ID der Beziehung.
Responses
- 200
- 400
- 401
- 403
- 404
- 405
OK
- application/json
- Schema
- Example (from schema)
Schema
- SorgBer Sorgeberechtigter oder Sorgeberechtigte
- SchB Schulbegleiter oder Schulbegleiterin
ID der Beziehung.
ID des Mandanten.
ID des Personenkontexts, zu dem eine Beziehung besteht.
Possible values: [SchB
, SorgBer
]
Beziehungen ist eine Liste von Beziehungen, welche zwischen zwei Personen innerhalb von Personenkontexten bestehen können:
Revision der Beziehung.
ID des Personenkontexts, aus dem heraus die Beziehung besteht.
{
"id": "4de182f3-4a8b-468b-9050-76dd1cae95f3",
"mandant": "6325b810-6b27-423d-a16b-f4b4cfa9f073",
"ktid": "553f984f-5fea-48c8-ae26-089420465803",
"beziehung": "SchB",
"revision": "2",
"ist_von_ktid": "553f984f-5fea-48c8-ae26-089420465803"
}
Bad Request
Siehe Fehlerbehandlung
Unauthorized
Siehe Fehlerbehandlung
Forbidden
Siehe Fehlerbehandlung
Not found
Siehe Fehlerbehandlung
Method not allowed
Siehe Fehlerbehandlung