ictu / api-ontwikkeling

Gezamenlijk ontwikkelen en beheren van gestandaardiseerde API’s voor gemeenten

Aanleiding

Er is een brede behoefte aan gestandaardiseerde API’s, voor alle gemeenten, t.b.v.:

• Moderne dienstverlening De omgeving van gemeenten, vereist dat steeds meer samengewerkt wordt met ketenpartners, met burgers en bedrijven. Ook is er een ontwikkeling gaande om de informatiepositie van de burger te verbeteren en de burger meer regie over haar gegevens te geven. Dit vraagt om informatie over gemeentelijke organisatiegrenzen heen te kunnen ontsluiten en beheren.
• Standaard functionaliteiten Bij de uitvoering van regels voor burgers en bedrijven hebben gemeenten een architectuurstandaard nodig, en dus ontwikkeling en beheer van API’s.
• Toegankelijke data Veel applicaties binnen gemeenten beschikken nog niet over API’s, de data kunnen daarom nog lastig op een moderne manier ontsloten worden uit de applicaties. Om de data op een moderne manier te ontsluiten, zullen er API’s op de databronnen behorende bij de applicaties ontwikkeld moeten worden. 

Datagedreven sturing

Voor gemeenten is het steeds belangrijker om te sturen op data, op de feiten, zogenaamde datagedreven sturing. Hiervoor is het van belang dat de data uit applicaties snel gebruikt kan worden voor stuurinformatie te creëren. Applicaties die voorzien zijn van uitgebreide API’s maken dit mogelijk.

Wetgeving

Er is steeds meer wetgeving dat het ontwikkelen en beheren van API noodzakelijk maakt voor gemeenten. Zoals:

• Europese Open Data Richtlijn schrijft de bevordering beschikbaarstelling van dynamische en real-time data met gebruik van Application Programming Interface (API), voor.
• Wet Hergebruik Overheidinformatie Voor ‘dynamische gegevens’ gaan bijzondere regels gelden: die moeten beschikbaar worden gemaakt met een API.
• Omgevingswet schrijft het toepassen van de landelijke API strategie voor
• EU Open datarichtlijn, zie impactanalyse VNG

Regie gemeenten

Waar regie voering tot de kerntaken van gemeente behoort is dat voor API ontwikkeling en beheer veelal niet of nauwelijks het geval. Om die reden wordt er niet of nauwelijks geïnvesteerd in aantrekken medewerkers die API kennis hebben op het gebied van ontwikkeling en beheer dan wel interne medewerkers opleiden.

Risico

Wat er nu gaat gebeuren is dat gemeenten zelf API’s gaan ontwikkelen en beheren of zelf uitbesteden en leveranciers met eigen API’s voor hun applicaties komen. Met als gevolg een versplinterd landschap van API’s die de uitvoering van moderne dienstverlening in de weg staat en niet zomaar te herstellen is. Denk hierbij aan privacy en security risico’s, API’s en data die niet gemeente-overstijgend kunnen worden ontsloten en overtolligheid doordat gemeenten gelijksoortige processen op eigen houtje doen.

Kans

Om dit te voorkomen en tegelijkertijd een antwoord te geven op de bredere behoefte aan gestandaardiseerde API ontwikkeling- en beheer is het initiatief genomen door Gemeente Utrecht, ICTU en Logius om samen organiseren vanuit Common Ground verder in de praktijk te brengen.

Een gezamenlijke aanpak voor ontwikkeling en beheer van API’s, biedt voordelen m.b.t.:

• Capaciteit (kleinere gemeenten, andere agendapunten)
• Snelheid (hergebruik van bouwstenen)
• Kosten (schaalvoordeel door samen te organiseren)
• Sturing (monitoring van gebruik)

api-ontwikkeling's Issues

Als PO wil ik API's migreren van het Red Hat API Management platform

De Integraties ontwikkeld op Red Hat API Management platform, code en documentatie op Github. Het zijn nog geen API’s die aan de inwoner beschikbaar gesteld kunnen worden, uitsluitend voor intern gebruik.

• HRM: SAP Succesfactors

Utrecht Vastgoed Organisatie API’s in kader energie transitie

• Smappy – ingediend bij Logius, zie #1
• KNMI
• Energiemissie
• Solar API's
• Webstatistieken (Publiek Dienst Verlening)

Als PO wil ik een API-definitie publiceren in de dienst API Management van Logius Centraal Aansluitpunt

Van de Logius website
De dienst API Management biedt organisaties een centrale plek en helpt hen om API’s op een uniforme wijze te publiceren en te (laten) gebruiken. U ontwikkelt en beheert zelf API’s om uw gebruikers en applicaties eenvoudig toegang te geven tot (bron)data en services. Wij kunnen voor uw organisatie API’s beschikbaar stellen en de versies, de abonnementen en het gebruik van deze API’s beheren.

Via dit aanvraag proces van Logius is de Smappee API Connector aangereikt.

Smappee is een oplossing waarmee energie verbruik makkelijk kan worden gemeten. De metingen zijn beschikbaar gemaakt via een API. Dit project verzamelt data van de Smappee API en voegt deze samen in een plat formaat wat eenvoudig kan worden verwerkt in bijvoorbeeld Tableau dashboards. Voor meer achtergrond zie Smappee en de API docs.

Als PO wil ik een Operating model API Management ingericht hebben

Als PO wil ik i.s.m. Wigo4it een nieuw te ontwikkelen API van Socrates voor VIL

Wigo4it is een coöperatie die in dienst van én samen met de 4 grote gemeenten (de G4) - Amsterdam, Rotterdam, Utrecht en Den Haag - ICT-oplossingen ontwikkelt die maatschappelijke meerwaarde opleveren.

Voor VIL is het gewenst om van de inwoner in Utrecht te weten of deze al bekend is in Socrates. Hiervoor is tijdens een Common Ground hackathon in juni dit jaar door een team van Wigo4it al een MVP gerealiseerd. Van die MVP willen we nu een productiewaardige variant.

Relevante context
Momenteel is Wigo4it volop bezig met Socrates naar de Cloud brengen (incl. de daarbij behoorde infra). In augustus gaan ze onderzoeken of het loont om API’s in Q4 (dus voor de Cloudgang) te ontsluiten terwijl er onderdelen nog on-prem draaien.