Update developer.overheid.nl — april 2026

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.

TL;DR

• De kennisbank heeft een nieuwe indeling: zoeken op tutorials, standaarden en tools.
• Registersites zijn herbouwd op Astro + NL Design System; er is een herbruikbaar template.
• Autorisatie gaat voortaan via Open Policy Agent in plaats van een APISIX-plugin.
• Nieuwe don-checker valideert API Design Rules vanuit de CLI, onafhankelijk van Spectral.
• We werken aan schemas.overheid.nl voor herbruikbare JSON-schema's en OAS-componenten.
• Er is een AI-skill om publiccode.yml automatisch te genereren.
• Agenda: FOST op 9 & 10 juni (Amsterdam) en een fysieke bijeenkomst op 17 juni (Utrecht).

📺 De live sessie is nog niet vrijelijk terug te kijken. Voor toegang tot de opname stuur een mail naar: V.vanderHeijden@geonovum.nl.

Kennisbank

De kennisbank op de homepage heeft een nieuwe indeling gekregen. Naast de bestaande thema's zijn er drie dwarsdoorsnedes toegevoegd: tutorials, standaarden en tools. Hiermee kun je direct op contenttype zoeken, ongeacht het thema.

Ook zijn een aantal thema's hernoemd. Het meest zichtbaar: 'Infra' heet voortaan 'DevOps'. Tot slot is het proces voor het aandragen van artikelen verbeterd met uitgebreidere tutorials en voorbeelden, zodat bijdragen makkelijker wordt.

Registersites en nieuwe frontend

De registersites — waaronder het Open Source Register en het API Register — zijn het afgelopen jaar volledig herbouwd op een nieuwe architectuur. De belangrijkste keuzes:

• Astro: het framework dat zorgt voor structuur, routing en server-side rendering.
• NL Design System: we gebruiken de Rijkshuisstijl community-componenten, een React-bibliotheek gebaseerd op dit systeem.
• Register Site Template: beschikbaar op GitHub, zodat andere organisaties (zoals DSO of RVO) hun eigen registersite in dezelfde stijl kunnen opzetten.

In het Open Source Register zijn nieuwe filters toegevoegd op basis van publiccode.yml-data: softwaretype, ontwikkelstatus en onderhoudsstatus.

API-infrastructuur en releasebeheer

Om hergebruik door derden te vergemakkelijken investeren we in strakker versioneren en releasen. We gebruiken Changesets voor de frontend en Changie voor de backend om consistente changelogs te genereren.

Op het gebied van autorisatie is de logica verplaatst van een custom APISIX-plugin naar de Open Policy Agent (OPA). Dit maakt de setup minder afhankelijk van maatwerk en beter beheerbaar. Er zijn nu twee flows:

• Trusted client: gebruikt een bearer token voor lees- én schrijfrechten.
• Untrusted flow: gebruikt een x-key voor uitsluitend leesrechten.

De volgende stap is om de volledige routing als code in de infrastructuur onder te brengen.

De nieuwe don-checker

Er is een nieuwe don-checker geïntroduceerd die onafhankelijk van Spectral werkt en via de commandline aanroepbaar is. Kenmerken:

• Ondersteuning voor zowel JSON als YAML.
• Validatie van meerdere versies van de API Design Rules.
• Resultaten gegroepeerd op severity-level: error, warning, info en hint, zodat duidelijk is wat prioriteit heeft.

JSON Schema Register en OpenAPI 3.1

Met de komst van OpenAPI 3.1 verschuift de focus naar volledige ondersteuning van JSON Schema. We werken aan een centraal register op schemas.overheid.nl voor herbruikbare JSON-schema's en OAS-componenten zoals parameters en headers.

Binnen het Kennisplatform API's start een nieuwe werkgroep die zich buigt over Schema Design Rules en de koppeling met semantiek via JSON-LD.

AI Skill voor publiccode.yml

Voor het beschrijven van open-source projecten promoten en gebruiken we de Europese standaard publiccode.yml. De voordelen van publiccode.yml zijn:

• Doordat we door heel Europa dezelfde metadata hanteren kunnen we projecten uitwisselen tussen verschillende catalogi van landen. Zo bestaan er bijvoorbeeld al een Duitse, en een Italiaanse op basis van publiccode.yml.
• Door je project te beschrijven in een bestandje in je repository sla je deze metadata agnostisch van je git-omgeving op. Als je dus later moet verhuizen met je project, hoef je de data niet meer handmatig over te zetten.
• De publiccode.yml dient als flag om aan te geven dat je project wellicht nuttig is voor andere organisaties uit de publieke sector.

Om het aanmaken van een publiccode.yml te vergemakkelijken is er een AI-skill ontwikkeld die automatisch een beschrijving en metadata genereert door projectinformatie zoals de README te analyseren.

Deze skill is gebaseerd op de internationale standaard Agent Skills, hierdoor is hij compatibel met verschillende AI clients.

De skill wordt onderdeel van een nieuwe AI Skills Marketplace, waarmee overheidsorganisaties kennis over standaarden en werkwijzen direct in hun AI-assistant kunnen laden.

Save the date!

Er komen weer reuze interessante en gezellige events aan waarop je ons kan ontmoeten:

• 9 & 10 juni — FOST (voorheen API Days) in Amsterdam. Hier organiseren we twee tracks; een API- en een Open Source-track. Hiervoor zullen gratis tickets beschikbaar worden gesteld. Houd hiervoor onze Mastodon in de gaten.
• 17 juni — Developer.overheid.nl meetup in het Beatrixtheater in Utrecht. Op deze middag willen we jullie inspireren met interessante hands-on demo's, onze highlights van het afgelopen jaar delen en kunnen elkaar weer eens in het echt ontmoeten. Schrijf je in op: opensourcewerken.nl.

Vragen of feedback? Dat kan via de gebruikelijke kanalen of via een GitHub issue.