Een nieuwe verzamelplek voor onze API’s

Een van de voordelen van de zomer doorwerken, terwijl het onderwijsland langzaam tot stilstand komt, is dat je toekomt aan de dingen waar je de rest van het jaar geen tijd voor hebt. Eén van die dingen stond al een tijd op ons verlanglijstje, namelijk: een nieuwe plek om onze API’s in onder te brengen.

Vanuit onze verschillende projecten en programma’s hebben we inmiddels een flinke verzameling websites en apps. Deze hebben aan de achterkant allemaal een API: een stukje software waar je verzoeken naar toe kunt sturen, om - in de meeste gevallen - data terug te krijgen van de server. API’s vormen zo een essentiële schakel om de juiste informatie, op de juiste plekken, aan de juiste mensen te tonen.

Maar eerst… Waarom is dit interessant voor jou?

Ben je actief namens een onderwijsregio, een regioloket, school(bestuur) of andere organisatie die zich bezighoudt met het werven, informeren en activeren van nieuwe doelgroepen voor het onderwijs? Komt jouw organisatie online in contact met deze doelgroepen? Dan kunnen onze API’s je een deel van het werk uit handen nemen!

Het verzamelen, schrijven, beheren en doorlopend cureren van je informatie-aanbod kan namelijk een flinke klus zijn. Het is niet zo simpel als éénmalig uitzoeken welke instroommogelijkheden er zijn, en daar verschillende mooie webpagina’s over schrijven. Om je informatie-aanbod samen te stellen moet je continu signaleren tegen welke knelpunten je doelgroep aanloopt en uitvragen hoe je de onderliggende behoefte kunt vervullen. De inzichten die je hieruit opdoet, verwerk in je verschillende vormen en mediums (een artikel, een social media post, een FAQ etc.). Het is dus een permanente wisselwerking tussen de informatie-leverancier en de informatievrager. Je informatie-aanbod is zodoende nooit compleet of klaar, maar een ongoing concern.

Het voordeel is: je staat er gelukkig niet alleen voor! Er zijn heel veel andere mensen bezig met het samenstellen van dit informatie-aanbod: binnen jouw regio, buiten jouw regio en op landelijk niveau. Via onze API’s heb je directe toegang tot een deel van deze informatie, zodat je die direct en naadloos kunt integreren in je eigen websites. Zo is de informatie die je biedt altijd kloppend en actueel, zonder dat je er íets voor hoeft te doen!

Oke… Maar hoe werkt zo’n API dan?

Hoe een API werkt is het makkelijkst uit te leggen aan de hand van een voorbeeld. Neem het artikel dat je nu aan het lezen bent: toen je deze opende, stuurde onze website een verzoek naar onze server om de “data” van dit artikel op te vragen. Deze data omvat o.a. de titel van het artikel, de afbeelding, de auteursgegevens, de tussenkopjes, de paragrafen, metadata en nog veel meer. Nadat de server deze data naar je browser had opgestuurd, kon je het artikel zien en lezen.

Een API vormt dus als het ware een brug tussen de “website” en de “server” en zorgt ervoor dat beide met elkaar kunnen communiceren. Maar het zorgt er niet alleen voor dat ónze website met de server kan communiceren, jouw website kan dat net zo goed doen!

Nou is een deel van de data die die via onze API’s beschikbaar is, helemaal niet zo interessant om te zetten buíten de plek waar ze van origine voor was bedoelt. Dit artikel heeft bijvoorbeeld geen relevantie op een andere website dan de onze. Maar veel van de data die we hebben kan wél relevant zijn voor websites van anderen. Bijvoorbeeld de veelgestelde vragen van het Onderwijsloket, de innovatieve en onderwijsvernieuwende projecten van onze trainees, of de video’s en podcasts van overstappers die we hebben geportretteerd voor Klaar voor de Stap.

Deze data en content is allemaal gratis op te vragen en in te zetten in je eigen websites en apps. Maar hoe weet je dat dat het geval is, of hoe je dat moet doen? Dingen waarvan je het bestaan niet weet, kun je tenslotte niet inzetten.

Daarom hebben we deze zomer gewerkt aan een API portal die vanaf nu beschikbaar is op api.onderwijs.in. Vanuit deze hub kun je onze verschillende API’s ontdekken, proberen en testen. Met daarbij interactieve documentatie, en handige tools om verschillende verzoeken uit te proberen.

Via de API portal heb je onder andere toegang tot:

• Informatie over ruim 800 lerarenopleidingen, meer dan 100 onderwijsinstellingen en andere gegevens uit de navigator van het onderwijsloket.

• Geo-gerelateerde zoekopdrachten, om bijvoorbeeld alle regioloketten binnen 30km van de zoeker te tonen

• Alle routes naar het onderwijs, incl. élke mogelijke variant op basis van vooropleiding, zodat je je eigen routetool kunt bouwen.

• Ruim 200 artikelen en veelgestelde vragen over werken in het onderwijs

• 50+ video’s en tientallen podcasts

• Instant search voor de gehele dataset van het Onderwijsloket, gebouwd op de Neural Search Engine van Algolia.

• 100+ innovatieve en onderwijsvernieuwende projecten, opgezet en uitgevoerd door onze trainees.

• Functies om kandidaten in het ATS systeem voor onderwijsregio’s te registreren (onderdeel van de pilot Digitale Infrastructuur onderwijsregio’s)

En er komt nog véél meer aan!

Voor het prototype Het onderwijs in de buurt, dat we recentelijk in samenwerking met meerdere onderwijsregio’s hebben ontwikkeld, hebben we een eerste aanzet gedaan om vacatures en activiteiten uit de regio centraal te registeren en beheren. Zodat we elke potentiële overstapper, vanaf elke regiosite, toegang kunnen bieden tot een compleet overzicht en aanbod van mogelijkheden. Ook deze informatie is straks op te vragen uit (en op te sturen naar) de API Hub.

Daarnaast gaan we de informatie in de onderwijsnavigator in de komende maanden uitbreiden en update in samenwerking met sectorpartners en bestaande, publieke registers zoals HOVI, KiesMBO en RIO.

En tot slot hebben we op de planning staan om analyticsdata van onze verschillende software systemen onder te brengen in de API. Zo heb altijd toegang tot de meest actuele statistieken, die hopelijk waardevolle inzichten opleveren - zoals welke zoekopdrachten het meest worden uitgevoerd op onze website.

Genoeg om nog naar uit te kijken dus! Wil je op de hoogte blijven over onze digitale ontwikkelingen? Schrijf je dan onderaan deze pagina in voor onze nieuwsbrief. Wil je verder lezen over onze digitale dienstverlening, of samen een project opstarten? Dan vind je hier meer informatie.