Sinds 12 oktober 2020 is versie 4 van de OOAPI beschikbaar.

De documentatie van deze nieuwe V4 is te vinden op: https://open-education-api.github.io/specification/v4/docs.html
De V4 OOAPI specificatie zelf is te vinden op: https://github.com/open-education-api/specification/tree/master/v4

Het voorstel tot deze OOAPI V4 is tot stand gekomen met behulp van feedback vanuit de instellingen op het gebruik van de OOAPI V3 en door te kijken naar de ontwikkeling van de IMS Global eduAPI.
Met het V4 voorstel menen wij een belangrijke stap te hebben gezet met een duidelijk en toepasbaar model ^*) waarbij de onderwijscomponenten (program, course, component) alsmede het aanbod (offering) en de afname hiervan (association) volledig beschreven kunnen worden.

^*) Zie ook: https://github.com/open-education-api/notulen/blob/master/2020/20200512/OOAPI%20v4%20-%20use%20cases%20-%20v20200512.pdf

V3.0 van de OOAPI specificatie is beschikbaar.

OOAPI v3.0 kent een aantal aanpassingen en verbeteringen ten opzichte van de v2.1. Hieronder volgt een overzicht van de issues die onderwerp zijn van deze 3.0 versie:

• De specificatie is compatibel met de OpenAPI (OAS) specificatie V3 gebracht.
  https://github.com/open-education-api/specification/pull/71
• Er zijn wijzigingen aan de paginanummering aangebracht.
  https://github.com/open-education-api/specification/pull/76
• De nondescriptive keys ‘items’ zijn vervangen door een descriptive key.
  https://github.com/open-education-api/specification/pull/72
• En er zijn 3 nieuwe endpoints toegevoegd om een beter onderscheid te maken in het opleidingsaanbod:
  /educational-programmes, /institution, /course-offerings
  https://github.com/open-education-api/specification/pull/75

De referentie documentatie is bijgewerkt en beschikbaar op:
https://open-education-api.github.io/specification/docs.html

V2.1 van de OOAPI specificatie is beschikbaar. De belangrijkste wijziging is de toevoeging van een root endpoint. Hiermee wordt service metedata beschikbaar gemaakt waarmee aangegeven kan worden welke OOAPI endpoints worden ondersteund door de instelling. Zie voor meer informatie en de overige aanpassingen de 2.1 issues.

De referentie documentatie is bijgewerkt en beschikbaar op: https://rawgit.com/open-education-api/specification/v2/docs.html

De Standaardisatieraad van Edustandaard heeft op 29 maart 2018 besloten de Open Onderwijs API in beheer te nemen. Hiermee hebben we een belangrijke stap gezet in het borgen van deze standaard voor het HO.

Zie ook: https://www.surf.nl/nieuws/2018/03/open-onderwijs-api-in-beheer-bij-bureau-edustandaard.html

Er zijn nieuwe vergaderdata gepland voor de community- en werkgroepoverleggen in 2018:

• Vrijdag 23 maart 10:00-12:30 uur
• Dinsdag 15 mei – 14.00-16:30 uur
• Donderdag 28 juni – 10:00-12:30 uur
• Maandag 10 september – 14.00-16:30 uur
• Vrijdag 23 november – 10:00-12:30 uur

Het volgend community- en werkgroepoverleg staat gepland op maandag 22 januari 2018 van 14:00-16:30 uur bij SURFnet in Utrecht.

Iedereen met interesse in de Open Onderwijs API is welkom. Aanmelden kan via info@openonderwijsapi.nl.

De verslagen van het Open Onderwijs API werkgroepoverleg van 21 augustus 2017 en 16 oktober 2017 zijn beschikbaar via Google Drive.

Verslag 16 oktober:

https://drive.google.com/file/d/1g1JibqBVSj-35q8gjYc2X_41OMqw1Q7J/view?usp=sharing

Verslag 21 augustus:

https://drive.google.com/file/d/1UAWmqZmHbWFjXJsviVftIqPLn6NPZWqD/view?usp=sharing

Op 7 november j.l. heeft de werkgroep Open Onderwijs API positief gestemd over het besluit dat de Open Onderwijs API specificatie wordt aangemeld bij Bureau Edustandaard en vanaf 2018 door hen in beheer wordt genomen. Meer informatie over de achtergrond voor dit besluit staat hier. De aanmeldprocedure is inmiddels in gang gezet.

Op 16 juni 2017 gaven Kirsten Veelo (SURFnet) en Joachim Rijsdam (Universiteit Leiden) op HO Link 2017 de presentatie ‘Onderwijsdata ontsluiten via Open Onderwijs API, een praktijkcase’. Kirsten gaf een inleiding over de Open Onderwijs API en achtergrondinformatie over het project. Joachim lichtte de toepassing van Open Onderwijs API bij Universiteit Leiden toe, beschreef de aanleiding en werkzaamheden die verricht worden om Open Onderwijs API te implementeren. Ten slotte stonden zij beiden stil bij wat Open Onderwijs API mogelijk kan maken om onderwijs(logistieke) processen te verbeteren. De presentaties zijn te bekijken via:

Beste werkgroep- en communityleden,

Met plezier wil ik jullie aankondigen dat de v2 van de OOAPI officieel akkoord is bevonden. Daarmee heeft de v2 van de OOAPI specificatie de final status gekregen en is dit de versie waarmee we verder zullen gaan.

Eventuele aanpassingen en uitbreidingen kunnen in een later stadium weer opgenomen worden in de v2.1 (december 2017/januari 2018) en volgend jaar in de 3.0.

The V2 specificatie is te vinden op: https://github.com/open-education-api/specification

Documentatie is beschikbaar op: https://rawgit.com/open-education-api/specification/v2/docs.html