Mijn verhaal bij de oplevering
Dit onderdeel is al behaald. Hieronder staat mijn uitleg bij het werk, voor dit portfolio verder uitgewerkt.
Mijn opdracht was om onderwijsgegevens uit de OU beschikbaar te maken via de OOAPI. De koppeling moest alleen lezen. Ik heb gewerkt aan de mapping, services, endpoints en toegang. De drie basisonderdelen zijn courses, programmes en organisations.
Opbouw van mijn demonstratie
| Onderdeel | Wat ik laat zien | Wat ik erbij vertel |
|---|---|---|
| Opdracht | Mijn eisen en wensen | De OU wil gegevens kunnen ophalen, zonder terug te schrijven. |
| Ontwerp | Component- en sequence diagram | Een request gaat via de API-keten naar de bron; mapping maakt er een OOAPI-response van. |
| Werkend resultaat | Screenshot van courses, daarna een detailrequest | Ik laat courseId, primaryCode, name en paging zien. |
| Technische keuze | ProductService en MappingProfiles | Courses en programmes delen logica omdat het allebei producten zijn. |
| Kwaliteit | Beide Postman-runs | Een 200-response kan toch inhoudelijk fout zijn; daarom controleer ik ook de velden. |
| Grenzen en vervolg | Testscenario’s en verbeterplanning | Negatieve tests, bronvelden en offerings vragen nog werk of bewijs. |
Afstemmen op mijn publiek
Voor iemand zonder technische achtergrond begin ik met wat de koppeling oplevert: een andere applicatie kan onderwijsgegevens ophalen. Ik wijs de naam en code in de response aan voordat ik over DTO’s of middleware praat.
Bij engineers ga ik dieper in op de mapping, de Reader-policy, het gedeelde ProductService en de foutafhandeling. Ik gebruik de screenshots als terugval wanneer de live omgeving niet beschikbaar is.
Vragen en mijn antwoorden
Dit zijn voorbeeldvragen die ik heb voorbereid, geen verslag van het gesprek.
- Waarom dezelfde service voor courses en programmes? Beide komen uit productgegevens. Met een producttype en DTO kan ik dezelfde ophaallogica gebruiken. Na een wijziging moet ik wel beide onderdelen testen.
- Waarom alleen GET? Volgens mijn opdracht mag de koppeling gegevens beschikbaar stellen en niets terugschrijven naar de OU.
- Is alles klaar als 102 controles groen zijn? Nee. Die run laat zes requestlabels zien. Zonder aparte fout- en autorisatietests kan ik niet zeggen dat ieder scenario goed is.
- Waarom staan er nog null-waarden? Dat moet ik per veld vergelijken met brondata en het afgesproken model. Ik wil geen ontbrekende onderwijsgegevens verzinnen.
Eerder beoordeeld
Dit onderdeel is al behaald met een 7,0. De opzet hierboven blijft staan als uitleg bij mijn werk.