AVN · Ontwikkelprogramma voor rijscholen · Module 20 / 24
API-koppeling, autorisatie en continuïteit
Een API-sleutel is een technisch toegangsmiddel, geen bewijs van inhoudelijke aansluiting op het leerplan. De koppeling vraagt heldere afspraken, beperkte rechten en controleerbare werking. De opdrachten gebruiken een testomgeving en bevatten geen echte sleutels.
Begin met de lessenAlle modules bekijkenWat je in deze module ontwikkelt
- Je kunt het onderwerp ‘Van aansluiting naar gegevensafspraak’ toepassen op een concrete onderwijskeuze en die keuze met passend bewijs onderbouwen.
- Je kunt het onderwerp ‘Sleutels en minimale toegangsrechten’ toepassen op een concrete onderwijskeuze en die keuze met passend bewijs onderbouwen.
- Je kunt het onderwerp ‘Fouten, herhaling en synchronisatie’ toepassen op een concrete onderwijskeuze en die keuze met passend bewijs onderbouwen.
- Je kunt het onderwerp ‘Eigenaarschap en onafhankelijk functioneren’ toepassen op een concrete onderwijskeuze en die keuze met passend bewijs onderbouwen.
Lees de lessen, werk de opdracht uit en bespreek je bewijs met een collega. Gebruik fictieve of zorgvuldig geanonimiseerde gegevens. De reflectie is inhoudelijk; deze leesomgeving registreert geen persoonlijke voortgang.
De lessen
Les 20.1 · Van aansluiting naar gegevensafspraak
Beschrijf vóór een koppeling welke gegevens tussen welke systemen nodig zijn, voor welk doel en wie daarvoor verantwoordelijk is. Leg de centrale leerlingidentificatie en relaties met organisatie en instructeur vast. Controleer of een bestaande leerling correct herkend wordt en niet dubbel wordt aangemaakt. Maak onderscheid tussen lezen en schrijven. Begin bij de kleinste noodzakelijke gegevensstroom. Een schema van de gewenste koppeling is nog geen werkende integratie. Noteer welke onderdelen technisch zijn getest en welke eerst nader moeten worden ingericht.
Verbind dit aan je praktijk
Beschrijf een concreet voorbeeld uit je eigen lespraktijk bij dit onderwerp. Noteer wat je vooraf wist, wat je daadwerkelijk observeerde en welke onderwijskeuze daaruit volgt. Benoem ook welke informatie ontbreekt voordat je een definitieve conclusie kunt trekken.
Les 20.2 · Sleutels en minimale toegangsrechten
Laat een sleutel alleen toegang geven tot wat voor de betreffende koppeling nodig is. Bewaar sleutels in daarvoor bedoelde beveiligde configuratie, nooit in cursusopdrachten, screenshots of openbare pagina’s. Spreek af wie een sleutel mag uitgeven, intrekken of vervangen. Test ook dat een sleutel van organisatie A geen gegevens van organisatie B kan lezen. Een API-sleutel vervangt geen controle op de juiste organisatie en leerling. Beoordeel iedere gegevensvraag serverzijdig en gebruik passende beveiligingsmaatregelen volgens de concrete technische omgeving.
Verbind dit aan je praktijk
Beschrijf een concreet voorbeeld uit je eigen lespraktijk bij dit onderwerp. Noteer wat je vooraf wist, wat je daadwerkelijk observeerde en welke onderwijskeuze daaruit volgt. Benoem ook welke informatie ontbreekt voordat je een definitieve conclusie kunt trekken.
Les 20.3 · Fouten, herhaling en synchronisatie
Een technische aanvraag kan mislukken, vertraagd aankomen of opnieuw verstuurd worden. Leg daarom vast hoe de koppeling dubbele verwerking voorkomt en hoe herstel wordt herkend. Test een ontbrekende relatie, ingetrokken sleutel, ongeldige invoer en onderbroken verbinding. Bij een onduidelijke uitkomst mag de gebruiker niet ten onrechte ‘opgeslagen’ zien. Maak foutmeldingen bruikbaar zonder geheimen of leerlinggegevens te tonen. Bewaar technische logging alleen voor een duidelijk doel en met passende toegang. Beschrijf de herstelroute voordat je echte gegevens aansluit.
Verbind dit aan je praktijk
Beschrijf een concreet voorbeeld uit je eigen lespraktijk bij dit onderwerp. Noteer wat je vooraf wist, wat je daadwerkelijk observeerde en welke onderwijskeuze daaruit volgt. Benoem ook welke informatie ontbreekt voordat je een definitieve conclusie kunt trekken.
Les 20.4 · Eigenaarschap en onafhankelijk functioneren
Maak inzichtelijk welke onderdelen zelfstandig draaien, welke afhankelijk zijn van externe diensten en welke export- en herstelmogelijkheden bestaan. Een lesadministratie mag niet stilzwijgend afhankelijk worden van een persoonlijke chatsessie. Onderzoek dit technisch; een belofte alleen is onvoldoende. Test een export en, waar ingericht, herstel in een afgescheiden omgeving. Leg onderhoud, toegang en verantwoordelijkheden vast. Bij gebruik van automatische inhoudsvertaling of AI moet duidelijk zijn welke functie daarvan afhankelijk is en hoe het onderwijsproces bij uitval verdergaat. Deze cursus vervangt die technische acceptatietest niet.
Verbind dit aan je praktijk
Beschrijf een concreet voorbeeld uit je eigen lespraktijk bij dit onderwerp. Noteer wat je vooraf wist, wat je daadwerkelijk observeerde en welke onderwijskeuze daaruit volgt. Benoem ook welke informatie ontbreekt voordat je een definitieve conclusie kunt trekken.
Praktijkopdracht 20
Maak een koppelingsplan en voer een acceptatietest met testdata uit: juiste organisatie, onjuiste organisatie, ingetrokken sleutel, dubbel bericht en verbindingsfout.
Op te leveren bewijs
- Een uitgewerkt document met doel, context en bronrelatie waar relevant.
- Een beschreven toepassing of duidelijk gemarkeerd ontwerp voor toepassing.
- Een concrete observatie of testuitkomst, zonder echte leerlinggegevens in je cursuswerk.
- Een reflectie op wat je wel en nog niet kunt concluderen, met een volgende stap.
Gebruik het werkboek via het cursusoverzicht. Vraag een collega naar één inhoudelijke verbetering en verwerk die zichtbaar.
Kenniscontrole en toepassing
1. Waarom bewijst een geldige API-sleutel nog niet dat een gegevensaanvraag toegestaan is?
Antwoordrichting: Omdat daarnaast onder andere organisatie, leerlingrelatie, doel en toegangsrechten bij de concrete aanvraag gecontroleerd moeten worden.
2. Hoe onderbouw je de praktijkopdracht in deze module?
Antwoordrichting: Maak een koppelingsplan en voer een acceptatietest met testdata uit: juiste organisatie, onjuiste organisatie, ingetrokken sleutel, dubbel bericht en verbindingsfout. Maak vervolgens onderscheid tussen een plan, een uitgevoerde activiteit en daadwerkelijk verkregen bewijs. Beschrijf de omstandigheden en ontvangen hulp. Laat een collega toetsen of je conclusie uit dat bewijs volgt.
3. Wanneer moet je je oordeel of aanpak bijstellen?
Antwoordrichting: Benoem een concreet tegenvoorbeeld bij ‘api-koppeling, autorisatie en continuïteit’. Geef aan welke aanvullende waarneming, broncontrole of test nodig is. Een ontbrekend gegeven is geen bewijs dat iets goed of fout gaat. Kies een toetsbare vervolgstap en leg vast wie die uitvoert.
