...
Veld | Type | Format | Omschrijving | Voorbeeld | O/V | Vullingsregel |
id | string | uuid | Unieke identifier voor deze notificatie | d290f1ee-6c54-4b01-90e6-d701748f0851 | V |
|
schemaVersion | string | string | Het versienummer van de berichtdefinitie die wordt gehanteerd. | 1.3.0 | V | Conform Semantic Versioning 2.0.0 |
objectType | string | ENUM | Het type object waarvan een notificatie wordt verstuurd. | Student | V |
|
objectId | string | string | Identifier van het dataobject dat wordt verstuurd in het Event. | - | O | Is verplicht bij isDeleteEvent |
userIdType | string | ENUM | Het type userId dat wordt gehanteerd in het veld objectId, indien het object een user betreft. | ECKiD | O* | Indien het dataobject een Student, Employee of StudentDelivery betreft, dan wordt hier gespecificeerd welke type userId is gehanteerd als objectId |
schoolId | string | string | Identifier van de onderwijsorganisatie waartoe het dataobject behoort. | O* | Indien het dataobject uit de SIS API komt dan is dit veld verplicht. De schoolId dient te worden gebruikt om het object op te vragen. | |
schoolPeriod | string | string | Referentie naar schoolperiode | 2021-2022 | O* | Referentie naar schoolPeriod.name Indien het dataobject uit de SIS API komt dan is dit veld verplicht. Dit stelt de Ontvanger in staat om het nieuwe, gewijzigde of verwijderde dataobject voor de correcte schoolperiode op te vragen. |
edu_org_id | string | string | Onderwijsorganisatie waarop de consent is geregistreerd voor de uitwisseling van het data object. | O* | Indien het dataobject uit de SIS API komt dan is dit veld verplicht. De edu_org_id dient te worden gebruikt om het object op te vragen. | |
created | string | datetime | Tijdstempel van actie die als trigger heeft gediend voor de notificatie | 2017-07-21T17:32:28Z | V |
|
url | string | string | URL naar het endpoint om het nieuwe of gewijzigde dataobject op te halen. | O | ||
isDeleteNotification | boolean | boolean | Indicatie voor de ontvanger dat dit het laatste bericht is betreffende dit dataobject aangezien deze verwijderd is. | True of False | O |
|
Status- en foutcodes
...
Status code
...
Status
...
statusMessage
...
Toelichting
...
200
...
0
...
OK
...
Bericht succesvol verwerkt
...
400
...
1
...
Failing event
...
Schemavalidatie niet succesvol
...
400
...
2
...
schemaVersion not supported
...
De ontvanger kan de gehanteerde SchemaVersion niet verwerken
...
401
...
3
...
scope required
...
Verzender is niet geautoriseerd voor scope
...
403
...
4
...
consent required
...
De gegevenssoort is van classificatie IV. Dit vereist een activering van de gegevensuitwisseling. Dit is in dit foutscenario niet het geval.
...
403
...
5
...
edu_org_id unknown
...
De Verzender communiceert in de context van een Onderwijsorganisatie die niet bekend is bij Ontvanger
...
400
...
99
...
Vullingsregel: in statusMessage een beschrijving van de reden opnemen
...
Voor alle APIs uit het Afsprakenstelsel Edu-V zijn de status- en foutcodes beschreven op de pagina Status- en foutcodes. Hierbij is onderscheid gemaakt in algemene en voor de API specifieke status- en foutcodes.
Technisch: API specificatie
...