Geonovum is samen met Bureau Forum Standaardisatie, Kamer van Koophandel, VNG Realisatie, Logius en het Kadaster het Kennisplatform API's gestart. Gezien de ontwikkeling naar een digitale samenleving waar veel digitale diensten eenvoudig met elkaar moeten kunnen samenwerken, geloven wij dat de Nederlandse overheid baat heeft bij een Kennisplatform API’s, waarin we gezamenlijk kijken naar strategische en tactische vraagstukken rond het ontwikkelen van API’s door de overheid en gebruik van deze APIs buiten en binnen de overheid.
Wat is een API?
API’s (Application Programming Interfaces) spelen een belangrijke rol op het Internet. Met behulp van een API kan je informatie makkelijker herbruikbaar maken voor programmeurs. Een API dient als interface tussen verschillende softwareprogramma's. Het zorgt ervoor dat een applicatie automatisch toegang krijgt tot bepaalde informatie en/of functionaliteiten. Een aantal aanbieders van open data bij de overheid, ontsluiten hun gegevens al met behulp van een API. Deze API’s leveren in veel gevallen een rechtstreekse “kopie” van de data, met alle complexiteit van dien.
Waarom een kennisplatform API's?
Het Kennisplatform API's wil API's beter bij de vraag aan laten sluiten, kennis over het toepassen van API's uitwisselen en de aanpak bij verschillende organisaties op elkaar afstemmen en waar nodig standaardiseren. Deze wens hebben we vastgelegd in een manifest die door diverse organisaties is ondertekend waaronder het Ministerie van Binnenlandse Zaken en Koninkrijksrelaties, PinkRoccade, Vicrea, VNG Realisatie, Forum Standaardisatie, Logius, Geonovum, Centric, Digicosmos, APIwise en SWIS.Bekijk het manifest
In het Kennisplatform verkennen we in werkgroepen de verschillende aspecten rond het gebruik en toepassing van API's door de overheid.
Nomineer een API voor goud!
In december reikt het Kennisplatform API's opnieuw een gouden API uit. Deze prijsuitreiking wordt mogelijk gemaakt door het Forum standaardisatie. Heb jij een favoriete API? Tot 30 november 2024 kan je deze nomineren voor goud!
De Gouden API is een award voor vooruitstrevende API initiatieven. De uitreiking van de Award vindt plaats op de IBDS Stelseldag op 11 december 2024 in Mediaplaza Utrecht. Met de uitreiking van de gouden API brengen we de maatschappelijke toegevoegde waarde van API's onder de aandacht èn zetten we de organisatie waar deze is ontwikkeld extra in het zonnetje.
De jury kijkt naar maatschappelijke relevantie van de API, technisch gebruiksgemak en de kwaliteit van de API. Onder de genomineerden van 2024 bevinden zich:
- NewEmployments (O&P Rijk en Belastingdienst)
- Windturbine API (ministerie van IenW)
- Track and Trace Teler API (Justid)
- API voor de Basisregistratie Ondergrond (van TNO),
- TOMP-API voor vervoersadviezen (publiek private samenwerking gecoordineerd door Ministerie van Infrastructuur en Waterstaat)
- Gemeentelijke rioleringsdata obv het GWSW (van Stichting RIONED).
- API voor gegevens van de Tweede Kamer (Tweede Kamer)
- API voor het CPA Register met gegevens over de organisatie, de gebruiker, service, certificaten, en digikoppeling. (Justid)
- Open Data van de Rechtspraak om documenten en/of metadata geleverd te krijgen in xml-formaat (Rechtspraak)
Het is nog tot 30 november mogelijk om API's te nomineren.
In 2023 heeft het Kennisplatform API’s een Gouden API Award uitgereikt aan de Open Onderwijs-API van de Samenwerkende Universitaire Reken Faciliteiten (SURF). In 2021 ontving de Rijksdienst voor Identiteitsgegevens een Gouden API voor hun Haal Centraal BRP API. En in 2019 kreeg Kadaster een Gouden API voor hun BAG-API.
API Strategie
De API strategie bestaat uit een een inleidend document, verschillende normatieve documenten (NL GOV standaarden) en meerdere modulen die voor verschillende functionele of technische situaties kunnen worden ingezet. Onderdelen van de API Strategie staan op de lijst met verplichte open standaarden van het Forum Standaardisatie.
De verschillende onderdelen van de NL API Strategie bevatten de volgende documenten:
| Onderdeel | Documentnaam & Verwijzing naar de gepubliceerde versie |
|---|---|
| Algemeen | Inleiding NL API Strategie |
| Algemeen | Architectuur NL API Strategie |
| Algemeen | Gebruikerswensen NL API Strategie |
| Normatief | API Design Rules (ADR) |
| Normatief | Open API Specification (OAS) |
| Normatief | NL GOV OAuth profiel |
| Normatief | Digikoppeling REST API koppelvlak specificatie |
| Functionele module | GEO module |
| Technische module | Transport Security module |
| Technische module | Access control module |
Het meest actuele overzicht van de API documentatie vind je op de Github pagina van het Kennisplatform.
Intentieverklaring API Strategie
Verschillende overheidsorganisaties hebben al een intentieverklaring ondertekend waarmee zij zich ervoor uitspreken om API’s te structureren conform de afspraken in de API Strategie. Deze intentieverklaring is opgesteld om samenwerking tussen partijen die binnen de overheid met API’s en standaarden werken te bevorderen.
Masterclasses
Om kennis te delen over het maken en gebruiken van APIs, publiceren we Masterclasses. Deze Masterclasses zijn na de live uitzending ook nog online te bekijken.
- Sessie Kennisplatform API met op minuut 18.17 de Masterclasses ‘Van UML Model naar API Specificatie’ door de Johan Boer (VNG) en het Koos Boersma (Informatiehuis Water) en op 1.27 uur de Masterclass 'Studentmobiliteit met Emrex' met Gerald Groot Roessink, Jan Joost Norder en Pieter Zeeuw van DUO.
- Transport Operator, Mobility as a service Provider API - Bon Bakermans, Ministerie van Infrastructuur en Waterstaat
- De Blauwe Knop - Kiske de Leest en Timen Olthof, VNG Realisatie
- Haal Centraal BRP-API - Mel Raboen de Sánchez Pacheco | RvIG, Bob te Riele | RvIG en Cathy Dingemanse | VNG Realisatie, Haal Centraal
- Veilig Samenwerken met API's - Pascal de Haan, Politie
- KPN API Store - Wouter van Schaik, KPN
- Implementatie API managementplatform bij Logius - Paul van Gent, Logius
- API en Microservice beveiliging | Hoe API beveiliging wordt toegepast bij Machtigen - Frank van Es
- De beste API Style voor jouw missie kies je zo! - Joost Farla en Cathy Dingemanse, Kennisplatform API's
- Casus derdenbeslag | Toepassing API strategie, regie op gegevens, mens centraal - Steven Gort en Bert Lukkien
- Developer.overheid.nl | voor het vinden en delen van APIs van de overheid - Eelco Hotting
- Bekijk de API Talkshow van december 2020 waarin gasten uit binnen- en buitenland vertelden over actuele ontwikkelingen
Eerder verschenen er ook een aantal artikelen over het gebruik van APIs:
Meedoen?
Het Kennisplatform API is een open platform waar overheden, marktpartijen, gebruikers en aanbieders samen werken aan een Nederlandse API strategie en alles wat daar verder bij komt kijken. Wil je meedoen?
meld je aan voor de werkgroep(en)
Blijf op de hoogte
Wil je door ons op de hoogte worden gehouden? Met enige regelmaat brengen wij een nieuwsbrief uit met daarin het laatste nieuws over het Kennisplatform, uitnodigingen voor bijeenkomsten en meer.
