Informationen zu der Organisation des Quellsystems.
GET/organisation-info
Die Schnittstelle /organisation-info
bezieht sich auf das Anfordern von Informationen
zu der Organisation des Quellsystems. Die benötigten Daten werden bei der Anfrage mit
dem access_token
übermittelt.
Dieser Schnittstellenendpunkt gibt die Informationen der anfordernden Organisation zurück.
Ein READ zum Abfragen einer Information zu einer Organisation muss mit HTTP-GET auf die API /organisation-info
erfolgen. Die Antwort-Nutzdaten (Response Payload) beinhalten ein
JSON-Objekt des Datentyps Organisation.
Siehe auch Datenmodell Organisation
.
Responses
- 200
- 400
- 401
- 403
- 404
- 405
OK
- application/json
- Schema
- Example (from schema)
Schema
- Schule
- Anbieter
- Sonstige sonstige Organisationen / Einrichtungen
- 01 Bund
- 02 Land
- 03 Kommune
- 04 Privat
- 05 Kirchlich
- 06 Sonstige
ID der Organisation.
Die optionale Kennung (Identifikations-ID) einer Organisation.
Offizieller Name einer Organisation.
anschrift
object
Postleitzahl.
Amtlicher Gemeindename.
Teil eines Orts, falls genauere Untergliederung gewünscht.
Possible values: [Schule
, Anbieter
, Sonstige
]
Wie folgt:
Ergänzender Name einer Organisation.
Possible values: <= 64 characters
Kurzname einer Organisation.
Possible values: [01
, 02
, 03
, 04
, 05
, 06
]
Wie folgt:
{
"id": "b0d7b0dd-3477-4122-a38d-095ec242e786",
"kennung": "NI_12345",
"name": "Heinrich-Heine-Gymnasium",
"anschrift": {
"postleitzahl": "30519",
"ort": "Hannover",
"ortsteil": "Döhren"
},
"typ": "Schule",
"namensergaenzung": "vorher Heinrich-Heine-Gesamtschule",
"kuerzel": "Heine-Gym",
"traegerschaft": "01"
}
Bad Request
Siehe Fehlerbehandlung
Unauthorized
Siehe Fehlerbehandlung
Forbidden
Siehe Fehlerbehandlung
Not found
Siehe Fehlerbehandlung
Method not allowed
Siehe Fehlerbehandlung