Direct naar de content
icon search white
2 april 2026 - Nieuws

De API Roadshow: Van aannames naar gebruikersinzichten

Hoe zorg je dat een technische oplossing niet alleen werkt, maar ook logisch voelt voor de gebruiker? Met die vraag gingen we in februari het land in. Tijdens de API Roadshow testten gemeenten de API Configuratie Wizard in de praktijk. De inzichten die dat opleverde, helpen ons om de wizard verder te ontwikkelen, mét de gebruiker als vertrekpunt.

Een groeiende behoefte aan regie op API's

Steeds meer gemeentelijke applicaties communiceren via API’s met landelijke voorzieningen, leverancierssystemen en interne platforms. Dat maakt integraties krachtiger, maar ook complexer om te beheren.

Tegelijkertijd groeit de behoefte bij gemeenten om hier zelf regie op te houden. Denk aan het toevoegen van nieuwe applicaties, het vervangen van certificaten of het analyseren van bestaande koppelingen.

Om dit beheer toegankelijker te maken, ontwikkelen we de API Configuratie Wizard: een oplossing die gemeenten stap voor stap ondersteunt bij het configureren en beheren van API-koppelingen.

Maar werkt zo'n wizard in de praktijk ook echt logisch voor gebruikers?

Om dat te toetsen organiseerden Alexander van Balen (Product Owner) en Marlinde Vos (Business Analist) in februari de API Roadshow. We bezochten gemeenten die deelnemen aan de werkgroep API Wizard Selfservice en lieten hen zelf met de wizard aan de slag gaan.

Geen demo’s of presentaties, maar hands-on testen.

Hiervoor ontwikkelden we tien realistische scenario’s, gebaseerd op dagelijkse beheeractiviteiten. Denk aan het koppelen van applicaties, het vervangen van certificaten en het in kaart brengen van huidige API-koppelingen.

Gebruikers bepaalden zelf hun aanpak. Dat gaf ons waardevolle inzichten: welke stappen voelen logisch, waar ontstaat twijfel en waar kan de interface beter aansluiten op de praktijk?

Een deelnemer verwoordde het treffend:

“De workflow zoals die is opgezet, voelt eigenlijk heel logisch. Het werkt erg intuïtief.”

Tegelijkertijd werd ook duidelijk waar nog winst te behalen is:

“Ik wil in één oogopslag kunnen zien welke API-koppelingen al zijn ontsloten en welke applicaties daar gebruik van maken. Dat inzicht ontbreekt nog.”

Wat hebben we geleerd?  

De roadshow leverde een aantal duidelijke inzichten op:

  • Overzicht is essentieel: Gebruikers willen direct inzicht in hun gekoppelde API-integraties, bijvoorbeeld voor impactanalyses of wijzigingen.
  • (Certificaat)beheer moet eenvoudiger: Het toevoegen of vervangen van certificaten bleek onoverzichtelijk. Gebruikers hebben behoefte aan meer begeleiding en beter inzicht in waar certificaten worden gebruikt.
  • Duidelijk onderscheid tussen omgevingen: Bij het wisselen tussen test- en productieomgevingen ontstond soms verwarring. Een duidelijker onderscheid helpt fouten te voorkomen.
  • Terminologie moet aansluiten op de praktijk: Gebruikers denken vaak vanuit applicaties en processen, terwijl sommige termen in de wizard nog té technisch georiënteerd zijn.

Van één flow naar twee duidelijke routes  

Een ander belangrijk inzicht is dat gebruikers in de praktijk twee typen taken uitvoeren, namelijk:

  1. Het beheren van bestaande koppelingen
  2. Het configureren van nieuwe koppelingen

Daarom werken we aan een duidelijke scheiding tussen deze twee flows. Dit maakt de wizard overzichtelijker en beter afgestemd op hoe gemeenten daadwerkelijk werken.

Samen verder ontwikkelen  

De API Roadshow, het webinar en de tests tijdens het Digitale Overheid L!VE event hebben ons waardevolle input gegeven. Maar we zijn nog niet klaar. Juist door samen met gemeenten te blijven testen en verbeteren, zorgen we dat de wizard echt aansluit op de praktijk.

Dus ben je benieuwd naar hoe de wizard in de praktijk werkt? Bekijk ons webinar. Hierin laten we de wizard in actie zien en nemen we je stap voor stap mee door de belangrijkste functionaliteiten.

En heb je vragen, ideeën of wil je meedenken over de verdere ontwikkeling?

Neem contact op met:

We gaan graag met je in gesprek. Hoe meer gemeenten meedenken, hoe beter we de wizard kunnen laten aansluiten op de praktijk.

Deel via:

‘Samen verder’

Marlinde Berends, Business Analist
Portretinformatievoorziening 36 (Marlinde 1) 500Px