developer.overheid.nl

Ontwikkelaarsportaal van de Nederlandse overheid

Ga naar hoofdinhoud

6 berichten getagd met "API Design Rules"

Laat alle tags zien

Uitnodiging Kennisplatform API's

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

Op donderdagmiddag 5 juni 2025 heet het Kennisplatform API je van harte welkom voor een nieuwe kennissessie in Meetup Utrecht (boven het Beatrixtheater). De bijeenkomsten van het Kennisplatform API's zijn toegankelijk voor iedereen die kennis wil opsnuiven en delen over het ontwikkelen en inzetten van API's bij de overheid. We beginnen deze bijeenkomst met een korte update over de laatste ontwikkelingen. Vervolgens zijn er parallelle sessies waarin specifieke thema's verder worden uitgelicht. Tussendoor is er ruimschoots de tijd om met de verschillende deelnemers van gedachten te wisselen en bij te praten. Je bent van harte welkom om aan te schuiven.

Status update API Design Rules

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

De uitdagingen bij API orkestratie

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

Iedere gebruikerstoepassing heeft een specifieke informatiebehoefte, die in veel gevallen meerdere databronnen overstijgt. Toepassingen moeten in dat geval in staat zijn om op een betrouwbare manier gegevens van meerdere bronnen te raadplegen en waar nodig met elkaar te combineren tot het gewenste informatieproduct in de ‘taal’ van de gebruiker.

Waarom zijn API design rules zo belangrijk?

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

Al sinds 2020 staan de REST API Design Rules op de pas-toe-of-leg-uit lijst van het Forum Standaardisatie, wat maakt dat deze verplicht zijn gesteld voor alle Nederlandse overheidsorganisaties. Deze design rules beschrijven een set regels waar een REST API aan zou moeten voldoen, met als doel meer uniformiteit aan te brengen in het informatielandschap van de overheid. In dit artikel geven we een aantal argumenten waarom API design rules zo waardevol zijn.