Release P

Datum: 9 maart 2026

Dit document beschrijft de wijzigingen in de API en datamodel sinds release N.

Nieuwe API v5

API versie 5.0 is toegevoegd. De verschillen tussen versie 4 en versie 5 zijn:

Bij type product is het veld percentageDistanceLearning vervangen door het nieuwe veld distanceLearningOptions. Hierbij kan er in plaats van een enkel percentage meerdere opties worden opgegeven (volledig online, volledig op locatie, of hybride met een percentage online).
Bij type product is er nu nog maar 1 studyAdvices toegestaan per productvorm.
Bij type product moet bij het veld studyAdvices een period worden opgeven van minimaal 1 maand.
Bij type product is het bij het veld studyAdvices het subveld hasMinimumECTS toegevoegd, die aangeeft of er een minimum aantal ECTS wordt gehanteerd bij het studieadvies. Dit veld moet op true worden gezet als er een minimum wordt gehanteerd. In dat geval moet het veld minimumECTS wordt opgegeven met een waarde groter dan 0. Als het veld op false wordt gezet (of niet wordt opgegeven) mag het veld minimumECTS niet worden opgegeven.

Voor API v3 en v4 zijn er de volgende wijzigingen:

Bij type product wordt per productvorm bij het veld studyAdvices alleen het eerste element opgeslagen.
Bij type product moet bij het veld studyAdvices een period worden opgeven van minimaal 1 maand.
Als er meerdere opties worden opgegeven bij product veld distanceLearningOptions (via de editor of API v5) zal er maar 1 worden teruggeven in veld percentageDistanceLearning.

Bij producten mag er maximaal 1 studieadvies (per productvorm) worden opgegeven.
Bij een studieadvies moet de periode minimaal 1 maand zijn
Er moet bij een studieadvies specifiek worden aangevinkt dat er een minimum aantal ECTS wordt gehanteerd, als deze wordt opgegeven moet dat aantal groter dan 0 zijn.
De rubriek 'Deel online te volgen' is vervangen door 'Op locatie/online onderwijs', waarbij er meerdere opties kunnen worden opgegeven (volledig online, volledig op locatie, of hybride met een percentage online).

Bij het veld percentageDistanceLearning wordt 0 omgezet naar distanceLearningOptions [{ "type": "atLocation" }], 100 naar [{ "type": "fullOnline" }], en 1-99 naar [{ "type": "hybrid", "percentageOnline": <originele waarde> }].
Als er bij een productvorm meerdere studyAdvices zijn opgegeven wordt daarvan alleen de eerste bewaard, de rest wordt weggegooid.
Als er bij een studieadvies minimumECTS 0 is ingevuld dit geïnterpreteerd als 'niet opgegeven' en wordt hasMinimumECTS met false gevuld, en als er waarde ongelijk aan 0 is ingevoerd wordt hasMinimumECTS op true gezet.