Release B4
Datum: 3 augustus 2020
Dit document beschrijft de wijzigingen in de API en datamodel sinds 13 juli 2020.
API wijzigingen release 2.0.0:
API versie 2 is geintroduceerd, https://api.hovi.nl/api/2/openapi.json - deze API blijft naast API versie 1 bestaan vanwege een niet backwards-compatible wijziging aan het veld otherRequirements
- Algemeen: Aantal decimalen in een hovi-decimal kan nu variëren per veld en is niet meer vastgezet op 2.
- Algemeen: Corrigeert foutmeldingen met de harcoded tekst 'result.resultlength' om het daadwerkelijke aantal terug te geven
- Organisaties: een alleen-lezen veld ‘shortCode’ is toegevoegd aan organisaties met een door Studiekeuze 123 gekozen ‘korte code’ om de organisaties te kunnen onderscheiden (bv UVA)
- Product: voegt het veld 'credits' toe. Max 1 decimaal
- Product: past documentatie 'tuitionfeeurl' aan dat er niet perse naar een rekentool in hoeft te worden verwezen
- Product: het ‘string array’ veld otherRequirements is vervangen door een ‘object array’.
- Deze array bestaat uit:
- requirement: een verwijzing naar het otherRequirements domein
- description: meertalig, richtext - een toelichting bij deze eis
- De waarden die in API versie 1 in het veld otherRequirements geplaatst werden, worden nu us in het ‘requirement’ veld gebruikt.Elke ‘requirement’ mag maar 1x in de array voorkomen
- Product: exchangePrograms.orgUnitCountry is nu expliciet als verplicht gemarkeerd
- Dit veld was effectief al verplicht maar gaf een onduidelijke foutmelding dat het land niet gevonden werd
- Evenementen: men moet voor minimaal 1 taal een eventName opgeven
Ter toelichting van de API wijziging:
Het veld otherRequirements in API V1:
Het veld otherRequirements in API V2:
Editor wijzigingen
- Algemeen: bij "is gepubliceerd" dialog kan een vinkje "niet meer tonen" worden gezet
- Algemeen: een 'alleen lezen' recht is toegevoegd om toegang tot alle HOVI data te kunnen geven
- Algemeen: dwing maximum lengte restrictie op richtext velden ook echt af
- Organisaties: Veld shortcode toegevoegd, gebruikt in de interface als korte naam voor organisaties
- Producten: label "Collegegeld rekentool url" vervangen door "Collegegeld url"
- Producten: voegt omschrijvingsveld toe bij de overige toelatingseisen
- Producten: toon alle vertalingen van omschrijving bij de overige toelatingseisen
- Producten: crohocode is niet langer bewerkbaar bij croho programs
- Producten: markeer land als verplicht bij uitwisselingen en samenwerkingen
- Producten: beheersrechten op dossierniveau zodat men producten kan aanmaken voor eigen dossier
- Producten: startdata toevoegen aan standaardwaarden
- Voorlichtingsevenementen: fix crash als het bewerken van evenementen alleen via de API mag en een gebruiker die anderszins wijzigrechten heeft toch een evenement opent
- Voorlichtingsevenementen: vereis naam evenement in minstens 1 taal