Consent API
De Consent API maakt het mogelijk om toestemmingsregistratie te beheren voor gegevensuitwisseling waarvoor consent vereist is binnen het Edu-V Afsprakenstelsel. Onderwijsorganisaties houden hiermee regie over welke gegevens leveranciers mogen uitwisselen.
Status: Beta — Implementation Draft (v0.9.1). Zie de EDU-V documentatie voor Consent API.
Wanneer is consent nodig?
Consent is vereist voor gegevensuitwisseling met classificatie IV (bijv. leerlinggegevens, resultaten). De Consentmanagement-component van de onderwijsorganisatie kan gegevensdiensten (de)activeren. Zonder actieve consent retourneert de API foutcode 0022 (consent required).
Scope: eduv.consent
Kernobjecten
- Name
ConsentStatus- Type
- object
- Description
Status van de toestemming voor een specifieke API en scope:
accepted,declined,revoked,pending.
- Name
ConsentNotification- Type
- object
- Description
Melding van nieuw verleende toestemming, verstuurd door de bronhouder naar de afnemer.
- Name
ConsentRevoke- Type
- object
- Description
Intrekking van toestemming door een van de betrokken partijen.
- Name
ConsentRequest- Type
- object
- Description
Verzoek om toestemming van afnemer aan bronhouder.
- Name
ConsentConfirmation- Type
- object
- Description
Bevestiging van ontvangst van een consent-melding.
Consentstatus ophalen
Haal de huidige consentstatus op voor een specifieke school en gegevensdienst.
Response (200)
[
{
"school": { "organisationMasterIdentifier": "16SK" },
"api": "Entitlement API",
"scope": "eduv.entitlement.licensor",
"status": "accepted",
"activatedAt": "2026-01-15T08:00:00.000Z"
}
]
Foutresponses
Zie EDU-V Foutcodes — Consent API (10xx) voor het volledige overzicht van functionele foutcodes.