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.

Het maakt natuurlijk niet uit waar de overstapper zijn klantreis start (in de regio of op een landelijk platform); 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 circa 20 informatiesoorten 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 of andere aanverwante projecten worden ontwikkeld, 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 je aan kunt haken

Wil je gebruik maken van de eerste (pre)release van de Onderwijsloket API? Dat kan? Check snel de documentatie om een account aan te maken en je eerste verzoeken te sturen. Heb je vragen over dit project, of kom je ergens niet uit? Stuur gerust een mailtje naar remi@onderwijs.in.

Wil je gewoon op de hoogte blijven over de voortgang van dit project? Schrijf je dan in voor onze nieuwsbrief.