Resultaat van de opdracht
API Ontwerp & Realisatie
Jouw werk start vanuit de principes van Strategic Domain-Driven Design (DDD) om de complexe gemeentelijke werkelijkheid te vertalen naar een helder en coherent API-landschap. Je neemt de bestaande informatiemodellen en API’s als vertrekpunt voor een robuust en toekomstbestendig ontwerp.
Je analyseert de behoeften vanuit de gemeenten en herstructureert de bestaande informatiemodellen en impliciete datamodellen uit de API’s tot logische Bounded Contexts, zoals Archivering of Track & Trace (zoals in de service MijnZaken). Voor elke context werk je aan heldere, functionele API’s die de kern van dat domein exposeren.
Je stelt de Ubiquitous Language van het domein vast en zorgt dat deze eenduidig wordt toegepast in de API-contracten. De namen van endpoints, schema’s en attributen (in JSON) zijn direct herleidbaar tot de taal die door domeinexperts en ontwikkelaars wordt gesproken.
Waar nodig ontwerp je Anti-Corruption Layers om de helderheid van de API’s te beschermen tegen legacy-systemen. Je ziet documentatieschuld niet als een last, maar als een kans om te refactoren richting duidelijkere domeingrenzen.
Je legt de publieke contracten van elke Bounded Context vast in de OpenAPI-standaard (v3.x). Via versiebeheer (GitHub) en interactieve documentatie maak je deze modellen toegankelijk en bruikbaar voor het hele ecosysteem.
Kwaliteit, Veiligheid en Beheer
Je ontwikkelt en onderhoudt een strategie voor geautomatiseerd testen van de API’s om de stabiliteit en betrouwbaarheid te garanderen.
Je draagt zorg voor een soepele overdracht van de API-standaarden en bijbehorende documentatie naar de implementerende partijen, inclusief duidelijke release notes.
Community & Stakeholdermanagement
Je bent een actieve deelnemer in technische werkgroepen en fieldlabs (Common Ground, Omnichannel) met architecten, developers en specialisten van onder andere G4, Dimpact en gemeenten.
Je bent hét technische aanspreekpunt voor de community van softwareleveranciers. Je haalt feedback op om de API-ontwerpen te valideren.
Je toetst de technische haalbaarheid van nieuwe concepten en vertegenwoordigt de API-roadmap en de technische visie naar diverse stakeholders.
Concrete Projectresultaten
- Het uitvoeren van een pilot met softwareleveranciers, resulterend in gevalideerde en gebruiksvriendelijke API-ontwerpen.
- Het opzetten geautomatiseerde tests die de kwaliteit en conformiteit van de API’s borgt.
- De succesvolle livegang van 3 gemeenten met MijnZaken, als bewijs voor de effectiviteit van de nieuwe architectuur.
Eindresultaat
Een bewezen blauwdruk die toekomstige digitale innovatie voor alle gemeenten versnelt en de ontwikkelkosten verlaagt.
Eisen
Wensen
- Opdrachtspecifieke wens 1: Aantoonbare ervaring met API-standaarden
- Tussen 3 en 5 jaar
- Tussen 5 en 7 jaar
- Meer dan 7 jaar
- Opdrachtspecifieke wens 2: Ervaring met Devops opgedaan in de afgelopen 6 jaar. Moderne ontwikkelpraktijken, waaronder versiebeheer met Git/GitHub, CI/CD-pipelines en het opzetten van geautomatiseerde tests voor API's. Aantoonbaar in cv en motivatie
- Tussen 3 en 5 jaar
- Tussen 5 en 7 jaar
- Meer dan 7 jaar
- Opdrachtspecifieke wens 3: Ervaring met het optreden als aanspreekpunt binnen een community van een complex stakeholdersveld (verschillende overheden, softwareleveranciers)
- Geen tot 3 jaar ervaring
- Tussen 3 en 5 jaar
- Tussen 5 en 7 jaar
- Meer dan 7 jaar
- Opdrachtspecifieke wens 4: Beschrijf uw aantoonbare ervaring met het ontwikkelen van zowel de server/provider- als de client/consumer-kant van API’s. Hoe heeft deze ervaring bijgedragen aan een verbeterde Developer Experience (DX)? Aantoonbaar in cv en motivatie
- Ik heb hier geen ervaring mee
- Ik heb deelgenomen aan een of meerdere bewegingen die hier initiatief in toonde
- Ik heb een of meerdere initiatieven genomen, daar zijn enkele ook daadwerkelijk uitgerold
- Ik heb een of meerdere initiatieven genomen, daar zijn meer dan 3 ook daadwerkelijk uitgerold
- Ik kan aantonen dat er meerdere initiatieven succesvol zijn geimplementeerd
- Opdrachtspecifieke wens 5: Kennis van moderne deployment via cloud-platformen (bijv. Azure, AWS, Google Cloud) en containerisatie (Docker, Kubernetes) is een pré. Aantoonbaar in cv en motivatie
- Geen ervaring mee gehad
- Beperkt: Heeft er af en toe mee te maken gehad
- Gemiddeld: Heeft enige kennis en kan ze globaal beschrijven
- Ruimschoots: Heeft ruime kennis en kan ze vanuit eigen ervaring omschrijven
- Uitgebreid: Heeft uitgebreide kennis en kan ze uitgebreid en diepgaand beschrijven