Spectral is een open source linter waarmee je regels voor API-documentatie vastlegt in een ruleset en die vervolgens automatisch controleert. Die tool ligt onder vuur. Er staan honderden issues en pull requests open, de VS Code-plugin loopt achter, en half juli kwam daar een supply chain-incident in een van de dependencies bovenop. Dat laatste was voor veel mensen de druppel. Omdat onze eigen tooling op Spectral draait en de API Design Rules ermee beschreven zijn, uitten veel mensen daar terecht hun zorgen over. Ons antwoord: we slopen Spectral er niet halsoverkop uit, want er zit juist beweging in de richting die we toch al op wilden. Hieronder leggen we uit waar we staan en wat we doen.

Een goede API begint niet bij de controller, maar bij het contract. In de Bouw een API-tutorial laten we zien hoe je vanuit een gevalideerde OpenAPI Specification servercode genereert. Tot nu toe lag de nadruk daar vooral op een Express-template als demonstratie. Inmiddels hebben we de template-repository uitgebreid met meer runtimes en programmeertalen.

Dat klinkt misschien als een kleine toolingstap, maar het raakt een praktisch probleem dat veel teams herkennen: hoe kom je van een nette OAS naar een applicatie die dezelfde afspraken ook echt afdwingt?

"Human in the loop" is inmiddels het standaardantwoord op bijna elke zorg rond AI. Maar voor wie AI inzet om overheidssoftware te bouwen, is het verstandig om naast de mens ook tools in de loop houden: generators die het zware werk doen en validators die de regels bewaken. Zo verschuift het naleven van standaarden van de oplettendheid van een mens en de welwillendheid van AI naar tooling die je kunt vertrouwen. Hoe dat samenwerkt, en aan welk arsenaal aan skills, generators, validators en andere tools we werken, lees je in deze post.

Om maar in de zelfde stroming te blijven als de Pitch voor het event zelf: Er staat een nieuwe wind in het digitale landschap. Een wind aangewakkerd door internationale incidenten, uitspraken, maar toch ook door een kritische blik op 'hoe zijn we hier gekomen'. Digitale souvereiniteit is de veilige haven waar we op koersen, en de vloot is ondertussen onomkeerbaar in beweging gekomen.

Hij zit er weer op, de tweede editie van onze meetup! Wat een mooie middag: een volle zaal met developers, scherpe vragen, goede gesprekken en ook nog een gezellige borrel bij Ruig achteraf. Graag delen we een korte terugblik met je van de sessies.

Frank Terpstra opende de API-track plenair.

Op 9 en 10 juni stonden wij twee dagen op FOST Amsterdam met onze eigen NL Gov-track. FOST (Future of Software Technologies) begon ooit als de wereldbekende API Days-conferentie, maar groeide uit tot een wereldwijd paraplu-event waaronder verschillende miniconferenties vallen; oprichter Mehdi Medjaoui maakte gekscherend de vergelijking van monoliet naar microservices. Naast API Days zelf vallen daar onder meer de conferenties van OpenAPI, JSON Schema, AsyncAPI, Green IO en deze editie dus ook wijzelf onder. Ons goedbezochte event bestond uit twee onderdelen: een API-track en een open source-track. Van ons eigen developer.overheid.nl-team betraden Dimitri, Tom, Frank, Floris en Joost het podium, samen met andere collega's uit binnen- en buitenland. Een terugblik op twee inspirerende dagen.

Digitale kaartinformatie, ook wel geo-informatie genoemd, is voor een organisatie als het Kadaster onmisbaar. De eenvoudigste manier om geo-informatie te bekijken en te gebruiken, is via een online kaartviewer. Diverse kaartviewers, zoals de PDOK Viewer, het WOZ-waardeloket en de BAG Viewer, zijn door het Kadaster ontwikkeld om geodata eenvoudig te raadplegen en te gebruiken.

Wat minder zichtbaar is bij het gebruik van deze viewers, is dat ze 'onder de motorkap' dezelfde componenten gebruiken: de Generieke Geo Componenten.

24 april was ik bij de softlaunch van code.overheid.nl. Het is een project dat bij veel developers en organisaties aanslaat omdat elke developer een gitomgeving nodig heeft om überhaupt samen te kunnen werken. Sinds er veel aandacht uit gaat naar digitale soevereiniteit is de roep om een gezamenlijke gitomgeving alleen maar gegroeid, het werd steeds minder voordehandliggend om op Github te blijven.

Vanuit dit besef heeft OSPO BZK zich hard gemaakt voor de opzet van code.overheid.nl, in de vorm van een Forgejo instance.

Op 22 april hielden we onze eerste online update-sessie. In de geest van open source werken lieten we zien waar we mee bezig zijn, wat er is opgeleverd en wat er aan zit te komen. Dit is een samenvatting voor degenen die niet bij konden zijn.

Elke medewerker heeft een account.

Maar wie heeft er écht zicht op?

Bij Wigo4it liepen identity-gegevens jarenlang via Microsoft Identity Manager. Het werkte — maar het was ook handmatig werk, dubbele administratie en een sterke afhankelijkheid van één leverancier.

Op een gegeven moment vroegen we ons af: moet dit zo?

Wij maken dit soort afwegingen dagelijks in onze eigen operatie. En soms leidt zo'n vraag tot een concrete beslissing.

In dit artikel laten we zien hoe Wigo4it Microsoft Identity Manager verving door een leverancier-onafhankelijke synchronisatie tussen AFAS, Keycloak en Entra ID. Wat de aanleiding was, welke keuzes we maakten, wat we leerden — en waarom we Entra ID bewust niet overboord gooiden.

Na dit artikel kijk je anders naar cloudkeuzes, security en de rol van identity.