De Onderwijsloket API

Waarom dit project

Iemand die een overstap naar het onderwijs wil maken, doorloopt daarbij een route [een klantreis], waarbij elke fase andere vragen en behoeften oproept bij de overstapper. Daarnaast zijn de instroompunten in deze klantreis divers en verspreid: soms is dit het landelijke Onderwijsloket, maar veel vaker is dit op regionaal niveau.

Er is gelukkig geen verkeerd instroompunt voor overstappers; zolang de plek wáár dat gebeurt de overstapper een warm welkom geeft, een compleet en objectief beeld schetst van de mogelijkheden die er zijn en de overstapper helpt zijn persoonlijke route te doorlopen. Op deze manier is de uitgangspositie en kans van slagen van de overstap pér instroompunt even groot.

Bij het landelijke Onderwijsloket hebben we de afgelopen jaren een rijke database gebouwd met informatie over werken in het onderwijs - voornamelijk gericht op de oriënterende overstapper. Daarnaast controleren we deze informatie continu op juistheid, houden we deze informatie actueel en breiden we waar nodig uit. Dit doen we met belangrijke bronnen, partners en experts uit het veld, zoals bijvoorbeeld op het gebied van de wetten, de cao’s, bevoegdheden, regelingen en routes.

Wij zien in de praktijk dat dit op regionaal niveau ook gebeurd; regioloketten hebben hun eigen websites met artikelen, veelgestelde vragen en soms een routetool. Dat betekent twee dingen:

1. We doen dubbel werk: informatie verzamelen, content schrijven en deze onderhouden.

2. We bieden niet altijd allemaal dezelfde informatie en soms zelfs tegenstrijdige informatie.

Dat betekent dat we ten eerste onze tijd, energie en expertise inefficiënt inzetten, maar ook dat we onduidelijkheid creëren voor de overstapper. Vanuit dat perspectief willen we gaan werken aan een oplossing voor deze knelpunten, waarbij alle regioloketten - en andere organisaties die een rol spelen in de klantreis - geautomatiseerd toegang krijgen tot de informatiebron van het Onderwijsloket. Hiermee kan men per (regionaal) initiatief deze informatie naar eigen inzicht verwerken in hun eigen website. Dat betekent dat ieder regioloket ten alle tijde kloppende, actuele en volledige informatie op de website heeft staan over landelijke, algemeen geldende regelgeving.

Daarnaast biedt deze werkwijze de optie voor elke regio om deze algemene, landelijk geldende informatie van het Onderwijsloket verder te verrijken met bijvoorbeeld regio-specifieke informatie. Zo kunnen we gezamenlijk een completer en consistenter informatie-aanbod samenstellen voor de overstapper.

Wat we willen maken

We hebben de afgelopen maanden achter de schermen alvast gewerkt aan een eerste versie van de Onderwijsloket API, en deze willen we de komende periode verder doorontwikkelen. Met de API is praktisch alle data van het Onderwijsloket in realtime op te halen, om die vervolgens geheel naar eigen inzicht in te zetten.

Zo kun je bijvoorbeeld (een subset van) de veelgestelde vragen van het Onderwijsloket automatisch op jouw website laten zien geheel in de huisstijl van jouw website. Je kunt dus zelf kiezen welke informatiesoorten je op wilt gebruiken, en welke specifieke onderdelen (datapunten) daarbinnen. Je kunt je selectie verder finetunen met filters; wil je bijvoorbeeld alleen informatie over het primair onderwijs? Dan stuur je dat mee met je verzoek aan de API.

Om het gebruik zo gemakkelijk mogelijk te maken, werken we ook aan uitgebreide documentatie voor developers met allerlei voorbeelden van verschillende toepassingen. In samenwerking met jullie eigen websitebouwer kun je jouw website dus enorm verrijken met informatie en wordt het altijd up-to-date gehouden.

Via de API kun je ruim 25 verschillende soorten informatie opvragen, zoals artikelen, veelgestelde vragen, lerarenopleidingen, podcasts, of routes naar het onderwijs. Gezamenlijk zijn bijna 5000 content items. Daarnaast bieden we ook allerlei extra features om de bezoekers van je website nóg beter, sneller en relevanter te informeren. Bijvoorbeeld door ze te laten zoeken naar lerarenopleidingen in de buurt.

We willen de API (en aanverwante tools) in de toekomst steeds verder uitbreiden. Nieuwe functionaliteiten en content die voor onderwijsloket.com ontwikkeld worden, willen we standaard via de API aan gaan bieden. Maar we zouden ook uitbreidingen kunnen ontwikkelen waarmee het gebruik maken van de API nóg simpeler en sneller wordt (d.m.v. SDK’s of plugins). Via plugins zou je bijvoorbeeld in een paar klikken de héle kennisbank van het Onderwijsloket in je eigen site, met je eigen huisstijl, kunnen integreren zonder dat daar technische kennis voor is vereist.

Hoe we te werk gaan

Dit project heeft geen vaste looptijd - we willen de Onderwijsloket API continu doorontwikkelen en blijven aanbieden zolang er vraag naar is.

Voor de korte termijn zijn we op zoek naar een aantal regio’s die het tof vinden om in kleine en besloten kring, alvast met de eerste versie van de API te gaan ontwikkelen (tijdens private alpha / testfase), om ons van feedback te voorzien en suggesties te doen voor verbetering. Doe je mee met de private alpha? Dan:

• kunnen we deze werking van de API beter afstemmen op jullie gebruikswijze

• helpen we je bij het selecteren van geschikte informatie, en het opvragen daarvan via de API

• kun je na afloop direct de informatie van het Onderwijsloket direct in je website gebruiken

Hoe en wanneer je aan kunt haken

Wil je meedoen met de private alpha of wil je er meer over weten? Je kunt hier terecht. Het streven is om deze in de zomer van 2024 uit te voeren, maar deze termijn staat nog niet definitief vast. We hebben in de private alpha ruimte voor zo’n 3 - 5 regio’s!

Wil je niet meedoen met de private alpha, maar op een later moment wél gebruik gaan maken van de API? Of wil je gewoon op de hoogte blijven over de voortgang van dit project? Dat kan je via dit formulier laten weten.

Heb je vragen over dit project? Stuur gerust een mailtje naar remi@onderwijs.in.