developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud
Dimitri van Hees
Product Owner - developer.overheid.nl
Bekijk alle auteurs

OpenAPI 3.1 eindelijk in zicht: de voordelen op een rijtje

· 9 minuten leestijd
Dimitri van Hees
Product Owner - developer.overheid.nl

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. Ondergetekende met het bewijs dat OpenAPI verplicht werd gesteld voor REST API's van de overheid, ruim zeven jaar geleden.

Het nieuwe API-register: REST-only en OpenAPI-first voor maximale Developer Experience

· 14 minuten leestijd
Dimitri van Hees
Product Owner - developer.overheid.nl

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.

Nieuwe versie developer.overheid.nl

· 9 minuten leestijd
Dimitri van Hees
Product Owner - developer.overheid.nl

De vernieuwde versie van developer.overheid.nl is live! Met deze update zetten we een grote stap richting een centrale, open en toegankelijke plek voor softwareontwikkeling binnen de overheid. We zijn er nog niet, maar onder het mom van release early, release often, hebben we de eerste grote koerswijziging alvast doorgevoerd. In deze post leggen we uit wat we van plan zijn, waarom we dat gaan doen en hoe we dat gaan realiseren.