developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

5 berichten getagd met "OpenAPI"

Laat alle tags zien

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.

Verslag Open Geospatial Consortium (OGC) meeting

· 6 minuten leestijd
Frank Terpstra
Implementatie ondersteuner - developer.overheid.nl

De 131ste Open Geospatial Consortium (OGC) - Technical Committee (TC) meeting vond plaats van 3 tot 6 maart 2025 in Rome, Italië. Het was een evenement voor professionals in de GIS industrie om samen te werken aan de toekomst van Geo- standaarden en technologieën. Namens Geonovum waren Frank Terpstra en Linda van den Brink aanwezig en hebben zij verslag gedaan van de belangrijkste inzichten.

Status update API Design Rules

· 6 minuten leestijd
Tim van der Lippe
Architect/API Adviseur - Logius

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.

Design-first of code-first API ontwikkeling?

· 4 minuten leestijd
Joost Farla
Implementatie ondersteuner - developer.overheid.nl

Als je gaat starten met het ontwikkelen van een API zijn er verschillende manieren om dit aan te pakken. In de praktijk zie je grofweg 2 verschillende methoden: "design-first" en "code-first". In dit artikelen leggen we uit wat de verschillen zijn en waarom de "design-first" aanpak wat ons betreft de voorkeur heeft.