Content Comparison

0.0.1: Eerste draft van de API.

0.0.2: Objecten en YAML files zijn toegevoegd t.b.v. de 80 procent specificatie.

0.0.3: De technische specificatie is verder uitgewerkt. Ook is de feedback uit de werkgroepen verwerkt in een volgende versie:

• Endpoint toegevoegd waarin entitlements voor een onderwijsdeelnemer of onderwijsmedewerker opgevraagd kunnen worden.

• Query parameter edu_org_id is toegevoegd aan alle endpoints als implementatie van het regie op gegevens en de M2M identificatie en authenticatie.

• Het transactiepatroon georkestreerde uitwisseling met een opeenvolging van asynchrone uitwisselingen is toegepast op de Entitlement API. Dit heeft geresulteerd in PUT endpoints voor de meldingen en de terugmeldingen (confirmations) voor de relevante referentiecomponenten.

• BasispoortIDs zijn toegevoegd als opties voor Onderwijsdeelnemer, Onderwijsmedewerker en School.

• In de YAML is aangegeven welke referentiecomponent de endpoints aanbiedt als Producer.

• De YAML is geactualiseerd op basis van de bovenstaande wijzigingen.

0.0.4: De status- en foutcodes zijn toegevoegd aan de documentatie en aan de YAML.

0.0.5: Objecten geactualiseerd op basis van herziening rollen en referentiecomponenten in het architectuurkader. Objecten ChangeLicenseStatus en ChangeLicenseStatusConfirmation toegevoegd.

0.0.6: YAML file aangepast. Endpoints voor activatiecode verwijderd en verplaatst naar de ActivationCode API.

0.0.7: Typo’s verwijderd uit de YAML file.

0.0.8: De objecten en koppelvlakspecificatie inclusief de YAML zijn aangepast naar het nieuwe conceptueel model. Dit heeft geleid tot de volgende wijzigingen:

• Aanspraken zijn van toepassing voor een enkele eindgebruiker. De voorheen open aanspraakvarianten zijn verplaatst naar de leveringsorders in de Delivery API

• Aanspraken zijn er nog steeds in typen. De typen variëren vanuit de beoogde gebruiker: onderwijsdeelnemer, onderwijsmedewerker en een eindgebruiker met een activatiecode. Daarnaast zijn er aanspraken die toebehoren aan een onderwijsorganisatie.

• De statusinformatie van aanspraken is gewijzigd. Dit heeft geleid tot de status van een aanspraak en de status van de plaatsing van de links in het leermiddelenportaal.

• Er zijn GET endpoints toegevoegd voor het Leermiddelendashboard

• Er zijn GET endpoints toegevoegd voor het Leermiddelenportaal om aanspraken en producten uit aanspraken op te vragen voor een specifieke eindgebruiker.

• Er zijn GET endpoints toegevoegd voor de Bestelomgeving leermiddelen en de Licentieregistratie om aanspraken op basis van een leveringsorderId en contractId op te vragen.

• Het transactiepatroon voor het Leermiddelendashboard is gewijzigd naar een Bevraging. Het Leermiddelendashboard ontvang geen meldingen meer vanuit de Aanspraakmanager en speelt geen rol meer in de georkestreerde uitwisseling.

• De scopes zijn aangepast met een specifieke scope voor de gegevensafnemende referentiecomponenten: Bestelomgeving leermiddelen, Licentieregistratie, Leermiddelendashboard en Leermiddelenportaal.

0.0.9: Er zijn wijzigingen verwerkt:

• Wijzigen in de architectuur:

  • Attribuut schemaVersion is verwijderd uit de objecten.

  • Query parameter schemaVersion is verwijderd uit de koppelvlakken.

  • Query parameter edu_org_id is verwijderd uit de koppelvlakken waar consent voor nodig is.

  • Query parameters orgMasterId, orgId en orgIdType zijn toegevoegd om informatie over een onderwijsaanbieder op te vragen.

  • Primaire en secundaire identifiers voor onderwijsaanbieders en eindgebruikers bijgewerkt.

• Feedback vanuit de werkgroep Verwerven en in gebruik nemen:

  • Attribuut urlStatus is vervangen door urlStatusses met een verwijzing naar de urlStatus per Portaal.

  • Endpoint entitlementproducts/school/user is hernoemd naar entitlements/school/user/products

0.0.10: / achter endpoints verwijderd.

0.9.0: Het Bestuurlijk Overleg heeft tijdens de bijeenkomst van 27 juni 2024 het Afsprakenstelsel Edu-V als versie 0.9.0 goedgekeurd voor implementatie.

0.9.1: Wijzigingen naar aanleiding van RFC’s:

• Op basis van RFC002 is de scope aangepast met een prefix eduv.. Dit stelt leveranciers in staat om onderscheid te maken tussen gegevensuitwisselingen met leveranciers binnen en buiten het Edu-V afsprakenstelsel.

• De parameters voor paginering zijn uit de koppelvlakspecificatie verwijderd. Binnen het afsprakenstelsel zijn de afspraken hierover beschreven op de pagina paginering, sorteren en rate limiting.

• De Vestigingserkenning is als secundaire identifier voor een onderwijsaanbieder verwijderd uit de koppelvlakspecificatie.

1.0.0: Na succesvolle implementatie in najaarsrelease 2024 in beheer genomen.