developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

16 berichten getagd met "API Design Rules"

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.

Wij waren op FOST 2026: een terugblik

· 16 minuten leestijd
Tom Ootes
Developer Advocate - developer.overheid.nl
Dimitri van Hees
Product Owner - developer.overheid.nl

"Frank Terpstra tijdens de plenaire opening." Frank Terpstra opende de API-track plenair.

Op 9 en 10 juni stonden wij twee dagen op FOST Amsterdam met onze eigen NL Gov-track. FOST (Future of Software Technologies) begon ooit als de wereldbekende API Days-conferentie, maar groeide uit tot een wereldwijd paraplu-event waaronder verschillende miniconferenties vallen; oprichter Mehdi Medjaoui maakte gekscherend de vergelijking van monoliet naar microservices. Naast API Days zelf vallen daar onder meer de conferenties van OpenAPI, JSON Schema, AsyncAPI, Green IO en deze editie dus ook wijzelf onder. Ons goedbezochte event bestond uit twee onderdelen: een API-track en een open source-track. Van ons eigen developer.overheid.nl-team betraden Dimitri, Tom, Frank, Floris en Joost het podium, samen met andere collega's uit binnen- en buitenland. Een terugblik op twee inspirerende dagen.

Wat als je standaarden kon downloaden in je AI-assistant?

· 6 minuten leestijd
Anne Schuth
Staff Engineer - Bureau Architectuur BZK
Dimitri van Hees
Product Owner - developer.overheid.nl

Plaatje van een matrix

"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.

"Vraag niet wat je land voor jou kan doen – vraag wat jij voor je land kunt doen."

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

Toegegeven, het is een beetje een melodramatische quote. Maar ik vond hem toepasselijk voor het thema van deze blogpost. Deze blogpost gaat namelijk over effectiever bijdragen aan een betere digitale overheid. De originele quote is van niemand minder dan J.F. Kennedy en komt uit zijn inauguratie-speech uit 1961. Met recht een andere tijd en plaats.

Mijn inspiratie voor deze blogpost kreeg ik toen ik een paar weken terug mijn zoontje de fles aan het geven was op een nachtelijk uurtje, en me de volgende vraag overviel:

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.

OData en de REST API Design Rules: past dat wel?

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

Binnen de publieke sector groeit de behoefte aan goed gedocumenteerde, interoperabele en toekomstbestendige API's. De REST API Design Rules (ADR) vormen daarbij een belangrijk referentiekader: ze stimuleren eenvoud, voorspelbaarheid en brede toepasbaarheid door gebruik te maken van open standaarden.

Regelmatig komt de vraag voorbij of OData, een specificatie ontwikkeld binnen het Microsoft-ecosysteem, een slimme keuze kan zijn voor publieke API's. In dit artikel analyseren we de voor- en nadelen van OData, met nadruk op eenvoud, interoperabiliteit en vendor-neutraliteit. Ook bekijken we hoe OData zich verhoudt tot de ADR, en op welke vlakken deze conflicteren.

Logo of OData

Informatiehuis Water tekent intentieverklaring Kennisplatform API's

· 2 minuten leestijd
Kennisplatform API's
Strategische en tactische vraagstukken rond het ontwikkelen van API's

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