developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

7 berichten getagd met "OpenAPI Specification"

Laat alle tags zien

Tools in the loop: "human in the loop" krijgt hulp

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

Abstracte weergave van het proces

"Human in the loop" is inmiddels het standaardantwoord op bijna elke zorg rond AI. Maar voor wie AI inzet om overheidssoftware te bouwen, is het verstandig om naast de mens ook tools in de loop houden: generators die het zware werk doen en validators die de regels bewaken. Zo verschuift het naleven van standaarden van de oplettendheid van een mens en de welwillendheid van AI naar tooling die je kunt vertrouwen. Hoe dat samenwerkt, en aan welk arsenaal aan skills, generators, validators en andere tools we werken, lees je in deze post.

Volle zaal, scherpe vragen: een terugblik op meetup #2

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

Hij zit er weer op, de tweede editie van onze meetup! Wat een mooie middag: een volle zaal met developers, scherpe vragen, goede gesprekken en ook nog een gezellige borrel bij Ruig achteraf. Graag delen we een korte terugblik met je van de sessies.

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

· 10 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.