developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

5 berichten getagd met "OpenAPI Specification"

Laat alle tags zien

Verslag OGC code sprint Rotterdam

· 10 minuten leestijd
Linda van den Brink
Senior Adviseur - Geonovum

Het Open Geospatial Consortium (OGC) is een internationale standaardenorganisatie. Hier komen onder andere de OGC API standaarden vandaan: gestandaardiseerde REST APIs die ervoor zorgen dat geodata op een universele manier geserveerd en gebruikt kan worden. Regelmatig organiseert het OGC code sprints: hackathons van drie dagen waar standaarden-experts en ontwikkelaars de OGC standaarden implementeren in software. De OGC standaarden die geimplementeerd worden zijn dan meestal nog in draft; wel stabiel, maar nog niet officieel goedgekeurd. Op basis van de feedback van ontwikkelaars kunnen OGC standaarden-experts meteen de standaarden verbeteren en aanvullen. Zo wordt het ontwikkelen van standaarden net iets meer agile.

Ervaringen eerste Geonovum JSON-schema publicatie

· 9 minuten leestijd
Pieter Bresters
Senior Adviseur - Geonovum

Op 31 oktober 2024 publiceerde Geonovum voor het eerst een JSON-schema bij een informatiemodel. Het betrof de publicatie van versie 3.0 van het Informatiemodel Externe Veiligheid: (IMEV). Daarnaast is er ook een suggestie voor een OpenApi Specificatie (OAS) gepubliceerd. In deze blog worden de ervaringen gedeeld die Geonovum daarmee heeft opgedaan in de hoop dat anderen daar van kunnen leren.

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.

Vorderingenoverzicht Rijk: één overzicht met betalingsverplichtingen dankzij de Common Ground principes

· 12 minuten leestijd
Tom Ootes
Developer Advocate - developer.overheid.nl

Het team van Vorderingenoverzicht Rijk kreeg een interessante opdracht toen ze werd gevraagd een dienst te ontwikkelen waarin burgers hun openstaande betalingsverplichtingen bij de overheid kunnen inzien. Vanaf de start van het project is de architectuur vormgegeven in lijn met het principe Data bij de Bron. In dit geval betekent dat, dat burgers met de app van Vorderingenoverzicht Rijk bij (nu nog) acht verschillende overheidsorganisaties data kunnen ophalen over hun financiële situatie. Omdat de data rechtstreeks uit de bron komt, wordt data nergens anders opgeslagen of verwerkt.

Ook werkt het team volledig volgens de Common Ground principes, dat het opknippen van functionaliteit in component-gebaseerde applicaties voorschrijft. In dit artikel lees je hoe deze principes het team helpen om succesvol hun doel te bereiken.