Kees Keulemans van de Nederlandse Digitale Dienst

Lang wisten we weinig over de Nederlandse Digitale Dienst (NLDD). Het bleef een in nevelen gehuld initiatief waarvan de verwachtingen hoog gespannen waren. Gelukkig waren wij aanwezig bij de meetup van Digilab in Utrecht, waar Kees Keulemans van Bureau Architectuur meer vertelde over waar het team nu staat, en hoe het van plan is te opereren.

Je bouwt aan een nieuwe applicatie, koppelt systemen via API's of werkt aan een voorziening voor de overheid. En ergens onderweg komt de vraag langs: welke open standaarden moet ik hier nu eigenlijk toepassen? Ze zijn niet vrijblijvend. Voor publieke organisaties zorgen open standaarden voor interoperabiliteit, leveranciersonafhankelijkheid, veiligheid, datakwaliteit en toegankelijkheid. Precies de dingen die bepalen of jouw software straks soepel samenwerkt met de rest van het overheidslandschap.

"I know kung fu." In The Matrix downloadt Neo een vechtkunst in zijn hoofd en is klaar om te gaan. In het echt werkt het anders. Als developer moet je allerlei standaarden en protocollen kennen, en dat kost uren lezen en uitzoeken. Maar je AI-assistant kan die kennis wel gewoon ingeladen krijgen. Op developer.overheid.nl experimenteren we met skills die overheidsstandaarden inladen in je AI-assistant.

Ruim zeven jaar geleden werd het traject afgerond om de OpenAPI Specification (OAS) op de pas-toe-leg-uit-lijst van het Forum Standaardisatie te krijgen. Sindsdien is versie 3.0 de verplichte standaard voor overheids-API's. En dat was nog steeds zo, ondanks dat de volgende versie 3.1 al lang beschikbaar is. Tot deze week. Het standaardisatieproces voor OpenAPI 3.1 is eindelijk hervat. In deze blogpost leggen we uit waarom dit een belangrijke stap is waar veel ontwikkelaars op hebben gewacht.

Ondergetekende met het bewijs dat OpenAPI verplicht werd gesteld voor REST API's van de overheid, ruim zeven jaar geleden.

Forum Standaardisatie toetst het verplichten ("Pas toe of leg uit") van NL GOV profile for CloudEvents en NLGov Rest API Design Rules 2.0 aan de overheid. Via internetconsultatie.nl kunt u beide voorstellen bekijken en uw mening geven. Dit kan tot en met dinsdag 5 augustus. Uw inbreng is van groot belang.

Op 6 juni heeft het Informatiehuis Water de intentieverklaring ondertekend van het Kennisplatform API's. Met de ondertekening van deze verklaring, onderschrijft Informatiehuis Water de wil en ambitie om samen te werken aan het ontwikkelen en toepassen van goede API standaarden. Deelnemers in de werkgroepen van het Kennisplatform API's leveren een actieve bijdrage aan standaardisatie van API's in en buiten het Kennisplatform API's.

Het API-register krijgt een flinke upgrade. We kiezen bewust voor een REST-only en OpenAPI-first aanpak, zodat we optimaal kunnen profiteren van moderne standaarden en tooling. Dit levert niet alleen voordelen op voor ontwikkelaars, maar zorgt ook voor een eenvoudiger, consistenter en toekomstbestendig register. In deze blog lees je welke keuzes we maken, waarom we daarvoor kiezen en welke nieuwe mogelijkheden het API-register straks biedt.

Op woensdagmiddag 26 maart 2025 kwam het Kennisplatform API's bijeen om de laatste ontwikkelingen rond API's te bespreken. Hier presenteerde ik een update over de API Design Rules (ADR), waarvan de 2.0 versie is ingediend bij het Forum Standaardisatie om op de 'Pas toe of leg uit'-lijst (PTOLU) te zetten. Tevens lichtte ik toe wat Logius als beheerder doet om de standaard verder te brengen en hoe wij toe werken naar een 2.1 versie. Hierbij is de symbiose tussen developer.overheid.nl, het Kennisplatform en de ADR van belang voor een succesvolle toekomst.