API

Uit NORA Online
Versie door Ericbrouwer (overleg | bijdragen) op 25 okt 2019 om 18:31 (koptekst API)
Naar navigatie springen Naar zoeken springen


Wordcloud met woorden rond API, zoals developers, use en many.
Wordcloud API, overgenomen van wikimedia commons

Wat is een Application Programming Interface (API)?

In Wikipedia wordt dat als volgt uitgelegd: https://nl.wikipedia.org/wiki/Application_programming_interface
Een API is een verzameling definities op basis waarvan een computerprogramma kan communiceren met een ander computerprogramma of onderdeel (meestal in de vorm van bibliotheken). Vaak vormen API's de scheiding tussen verschillende lagen van abstractie, zodat applicaties op een hoog niveau van abstractie kunnen werken en het minder abstracte werk uitbesteden aan andere programma's. Hierdoor hoeft bijvoorbeeld een tekenprogramma niet te weten hoe het de printer moet aansturen, maar roept het daarvoor een gespecialiseerd stuk software aan in een bibliotheek, via een afdruk-API.

En vanuit Computerworld wordt daarop aangevuld: https://computerworld.nl/development/74796-wat-is-een-api
Het aardige van een API is dat deze niet voor een gebruiker van een softwarepakket of bezoeker van een website zichtbaar is. De API werkt op de achtergrond en doet daar geruisloos zijn werk door met andere softwareprogrammatuur of het besturingssysteem te communiceren.

Een API werkt dus als een interface tussen 2 of meer computerprogramma's (software), staat daardoor nooit op zichzelf, is dus een bijzondere bouwsteen en wordt beschouwd bij de Applicatielaag van het NORA vijflaagsmodel.

En als je liever uitleg krijgt via een leuk filmpje van 3½ min.: What is an API?

Waarom is API van belang?[bewerken]

API’s gaan ons in staat stellen om het uitwisselen van gegevens -technisch gezien- stukken eenvoudiger te maken, met name ook over de grenzen van (overheids)organisaties heen. Dat kan indien we API’s gaan ontwerpen met open standaarden (inrichtingsonafhankelijk), zodat ze te gebruiken zijn in verschillende processen of ketens en indien we die API’s publiekelijk gaan publiceren, zodat ze eenvoudig te hergebruiken zijn.
Door het bundelen van onze ontwerp- en ontwikkelkennis kunnen we processen en ketens ontlasten doordat die API’s kunnen hergebruiken in plaats van dat ze die zelf moeten ontwikkelen en bouwen.

Een belangrijke voorwaarde voor deze technische gegevensuitwisseling is, dat vanuit het bestuur en management draagvlak moet bestaan voor verdergaande samenwerking tussen de betrokken (overheids)organisaties: de eigen "interne" processen zullen aangepast moeten worden aan overkoepelende keten-processen, waarbij de afhankelijkheden tussen die organisaties toenemen en de (formele) verantwoordelijkheidsverdeling opnieuw in balans moet worden gebracht.

Overigens kunnen API's ook goed worden toegepast binnen een organisatie.
Traditionele applicaties bestaan doorgaans uit grote brokken functionaliteit die alleen beschikbaar zijn binnen de beveiligde grenzen van een organisatie. Deze applicaties zijn voorheen vooral gemaakt om een geheel proces te ondersteunen. Ze zijn vaak niet ontworpen met generieke software-componenten die door verschillende applicaties kunnen worden hergebruikt. Daardoor bevatten ze vaak functionaliteit die ook in andere applicaties voorkomen, zoals voor Identity & Access Management, Beveiliging en Privacy.
Door nu achteraf generieke software-componenten te ontwikkelen -bijvoorbeeld in de vorm van API’s- kunnen we die traditionele applicaties verbouwen en mede samenstellen uit diverse kleinere software-componenten: daardoor ontstaat een meer flexibele applicatie.


Direct aan de slag

Binnen de Omgevingswet is een API-strategie opgesteld. GEMMA wil zich hierbij aansluiten voor gemeentelijke architectuur. In deze API-strategie zijn verdere regels opgesteld waaraan API's moeten voldoen. Waar mogelijk wordt gerefereerd aan bestaande standaarden. De meeste moderne API's zijn webgebaseerd (en doorgaans in JSON): daarom is het nuttig om ook over de URI's afspraken te maken.

API-strategie & URI-strategie Digitaal Stelsel Omgevingswet
'Aanzet tot een nationale URI-Strategie voor Linked Data van de Nederlandse overheid' bij Pilod
Thema Application Programming Interfaces bij Forum Standaardisatie
Puzzelstuk.png
Samen leren & zoeken

Er zijn diverse overheidsorganisaties die al bezig zijn met dit onderwerp. U kunt van hun ervaringen leren en direct deelnemen aan de lopende discussies.

Kent u een overleg binnen de overheid dat zich bezig houdt? Neem dan contact op met NORA Beheer. Op dit moment is NORA niet bekend met lopende initiatieven. Forum Standaardisatie heeft bijeenkomsten gehouden over de API-economie.

Gereedschap.png
Meer informatie & Contact

Nuttige links

Heldere uitleg API's bij Computerworld Nederland
API-strategie van Britse belastingdienst voor derden

Er is nog geen verband of organisatie die zich dit onderwerp heeft toegeëigend

→ [[ ]]

Contactpersoon is -,

Contact.png


Deze pagina is in opbouw. Kom later terug om het resultaat te zien of neem contact op met nora@ictu.nl als je mee wilt werken aan de eerste concepten.