Wat is API? Uitleg over de programmeerinterface

Tegenwoordig is de onderlinge verbondenheid tussen software essentieel om verschillende activiteiten en functies te faciliteren die deel uitmaken van onze dagelijkse routines. Een Application Programming Interface (API) is een bouwsteen waarmee verschillende softwareproducten met elkaar kunnen communiceren, gegevens kunnen delen en verbinden en harmonieus met elkaar kunnen samenwerken.

In dit artikel leggen we uit wat API’s zijn en wat je erover moet weten, inclusief hun definities, hoe ze werken, soorten API’s, voordelen en praktijkvoorbeelden. Laten we erin duiken!

Wat is een API?

In de softwarewereld is een application programming interface (API) een verzameling procedurele hulpmiddelen waarmee een softwareprogramma diensten kan aanvragen bij een ander programma. Simpel gezegd is het een communicatiemethode. Het vertegenwoordigt het menu van functies, de methode van toegang, de syntaxis waarmee een besturingssysteem (OS) of applicatie reageert en de reeks betekenissen achter de syntaxis.

Het delen van gegevens is een van de primaire functies van API’s. API’s worden meestal geïmplementeerd door functieaanroepen te doen met behulp van eenvoudige talen, zoals werkwoorden en zelfstandige naamwoorden, en de specifieke regels hiervoor worden uitgelegd in de documentatie van de applicatie. Een onroerend goed website kan bijvoorbeeld een API hebben die beschikbare woningen in een bepaald geografisch gebied uitzendt, een tweede API die de actuele rentetarieven ophaalt en een derde API die de hypotheekbetaling bepaalt.

Hoe werkt de API?

De werking van API architectuur wordt meestal uitgelegd aan de hand van de rollen van de client en server. De applicatie die het verzoek indient is de client en de applicatie die het verzoek beantwoordt is de server. Bijvoorbeeld, de onroerend goed database dient als server in een onroerend goed website, en het apparaat waarop je toegang hebt fungeert als client.

De werking van een API is afhankelijk van de vier hoofdtypen API’s, die elk een heel ander doel dienen wat betreft hun creatie en functionaliteit.

• SOAP APIs: SOAP API’s gebruiken het Simple Object Access Protocol om berichten uit te wisselen tussen de client en de server met behulp van XML. Deze API’s, die nu wat minder gangbaar zijn, werden vooral eind jaren 90 tot begin jaren 2000 gebruikt.
• RPC APIs: Deze staan voor remote procedure calls. Hiermee kan de client een functie of procedure op de server aanroepen, waarna de server de output terugstuurt. Alle populaire webservers werken volgens dezelfde procedure met RPC API’s.
• WebSocket APIs: Als een vorm van web API ontwikkeling vertegenwoordigen WebSocket API’s een modernere benadering, waarbij berichten worden verpakt als JSON objecten. Deze API’s maken communicatie in twee richtingen mogelijk tussen client applicaties en servers, waarbij servers callback berichten kunnen sturen naar aangesloten clients. Dit maakt aanpassing efficiënter op basis van de behoeften van de client dan REST API’s.
• REST APIs: Dit zijn de meest voorkomende, flexibele en krachtige types op het web van dit moment. Ze werken door clients die verzoeken als gegevens naar de server sturen, de server pushen om bepaalde interne functies te starten op basis van deze gegevens en vervolgens de outputgegevens terugsturen naar de client.

Soorten API’s

Tegenwoordig zijn de meeste API’s web-API’s, die de gegevens en functionaliteit van een applicatie via het internet beschikbaar stellen met behulp van het HTTP-protocol. De vier belangrijkste soorten web API’s zijn de volgende:

1. Open APIs: Ook wel openbare API’s genoemd, zijn er geen beperkingen op de toegang tot dit soort API’s omdat ze openbaar beschikbaar zijn. Een Open API is, zoals de naam al zegt, open en kan door iedereen gebruikt worden. Dit helpt bij het gemakkelijk promoten van de service op het web.
2. Partner APIs: Een Partner API is een interface die organisaties aanbieden om gecontroleerde toegang tot hun diensten mogelijk te maken binnen een zakelijk partnerschap. Het biedt de benodigde tools die externe leveranciers van oplossingen nodig hebben om intensief te ontwikkelen en te testen en, als ze klaar zijn, geeft het gecontroleerde toegang tot de diensten van een organisatie die niet voor iedereen vrij beschikbaar zijn. Meestal vragen ontwikkelaars toegang tot een partner-API aan via een openbaar API-ontwikkelaarsportaal en worden ze vervolgens begeleid of doorlopen ze een selfserviceproces om toegang te krijgen, wat resulteert in zelfgoedkeuring en het verstrekken van inloggegevens.
3. Interne APIs: Dit type web-API, ook bekend als privé-API’s, is alleen toegankelijk voor interne systemen. De ontwikkeling en het gebruik van interne systemen en processen, zoals besloten microservices en ander intranet-alleen gebruik van de gegevens en bedrijfslogica van een organisatie, bieden meestal geen API aan het publiek.
4. Samengestelde APIs: Dit zijn web API’s die meerdere data en/of service API’s combineren. Ze geven ontwikkelaars toegang tot meerdere eindpunten in een enkele oproep. In het geval van service-API’s helpen ze de communicatie en de noodzaak van meerdere heen-en-weer aanroepen tussen de clientapplicatie en de server te verminderen. Vooral gunstig in een microservices architectuur, stroomlijnen deze API’s taken waarvoor informatie uit meerdere bronnen nodig is.

API’s worden ook gecategoriseerd op basis van het soort systemen dat ze bedienen.

1. Lokale APIs: Applicatie-specifieke programmeerinterfaces die de OS en middleware diensten aan de applicatie leveren.
   Voorbeelden: Microsoft’s .NET API’s, Telefonie API’s voor spraaktoepassingen en API’s voor databasetoegang.
2. Web APIs: API’s die door de applicatie worden benaderd via HTTP om bronnen zoals HTML-webpagina’s weer te geven. Elke web URL of URI kan een Web API zijn. Deze API’s worden ook wel RESTful API’s genoemd. Dit betekent dat ze geen sessiegegevens vasthouden tussen verzoeken. Elke keer dat een verzoek wordt verzonden, is het een op zichzelf staand verzoek, vergelijkbaar met de manier waarop het internet werkt.
3. API’s op afstand:API’s die een nieuwe infrastructuur creëren voor een specifieke set van verzoeken op afstand. Deze operaties zijn niet noodzakelijkerwijs gebaseerd op webstandaarden.
   Voorbeelden: Java Database Connectivity API en Java Remote Method Invocation API.
4. Programma APIs: API’s die goed gedefinieerde klassen en bijbehorende functies binnen de toepassing plaatsen die de API bestuurt. Deze API’s werken met remote procedure call (RPC) technologie, inclusief interfaces gebaseerd op de Microsoft WS-reeks van API’s.

Voordelen van API’s

API’s vergemakkelijken niet alleen het ontwerp en de ontwikkeling van nieuwe applicaties en diensten en de integratie en het beheer van bestaande applicaties en diensten, maar bieden ook talloze extra voordelen voor ontwikkelaars en organisaties in het algemeen:

Verbeterde samenwerking

Met bijna 1.200 cloudapplicaties die door de gemiddelde zakelijke webhosting worden gebruikt, komt het maar al te vaak voor dat bedrijven een verzameling losgekoppelde systemen hebben. API’s maken het eenvoudiger om systemen te integreren en zorgen ervoor dat platforms en apps met elkaar kunnen praten, waardoor bedrijven workflows kunnen automatiseren en naadloos kunnen samenwerken op de werkplek. Anders zouden de verbindingsgaten informatie-silo’s creëren en de productiviteit en prestaties vertragen.

Versnelde innovatie

API’s bieden een niveau van flexibiliteit waarmee bedrijven verbindingen kunnen leggen met nieuwe zakenpartners en nieuwe diensten kunnen introduceren op hun bestaande markt. Deze flexibiliteit stelt bedrijven in staat om toegang te krijgen tot nieuwe markten, een aanzienlijk rendement te behalen en de digitale transformatie te versnellen.

De bedrijven die van oorsprong gewoon een API zijn, zoals Stripe met slechts zeven regels code, en hun bereik uitbreiden door te integreren met toonaangevende ondernemingen en hun aanbod te diversifiëren, zijn de bedrijven met de grootste waarderingen.

Gegevens te gelde maken

Veel bedrijven kiezen er in eerste instantie voor om een API gratis vrij te geven om een gemeenschap van ontwikkelaars rond hun merk te creëren en partnerschappen aan te gaan met degenen die ze als potentiële medewerkers zien. In de API-economie verdienen bedrijven geld door toegang tot waardevolle digitale activa te verkopen via API’s.

Neem AccuWeather als voorbeeld. Kort nadat de aanbieder van weergegevens AccuWeather zijn zelfbedieningsportaal voor ontwikkelaars met verschillende API-pakketten had uitgebracht, merkte het een nogal interessante wending op. Kort nadat het portaal live was gegaan, zagen ze veel ontwikkelaars naar het portaal komen en een pakket kiezen. Plotseling verkochten ze duizenden API-sleutels en was er een API-community geboren.

Systeembeveiliging

API’s fungeren als een beschermende barrière tussen de aanvragende applicatie en de infrastructuur van de service, waardoor risico’s effectief worden beperkt en de communicatie en infrastructuur verder worden beveiligd. API-aanroepen vereisen over het algemeen het gebruik van authenticatiegegevens.

Daarnaast worden andere beveiligingsmaatregelen zoals HTTP headers, cookies of query strings goed ondersteund voor verdere beveiliging van gegevensuitwisseling. Diensten maken ook eenvoudig gebruik van kosten zoals API gateways om de toegang te reguleren en verdere beveiligingsrisico’s in te schatten.

Beveiliging en privacy van eindgebruikers

API’s spelen ook een belangrijke rol in het handhaven van netwerkbeveiliging en zijn een groot deel van de extra beschermingslaag voor individuele gebruikers wanneer ze worden blootgesteld aan hun vitale informatie. Een goed voorbeeld hiervan is wanneer een website naar de locatie van een gebruiker vraagt en een locatie-API gebruikt. Een gebruiker kan ervoor kiezen om dit verzoek toe te staan of te weigeren om de privacy en veiligheid van zijn gegevens te waarborgen.

Het web is natuurlijk niet de enige die API’s gebruikt. Verschillende webbrowsers en mobiele besturingssystemen bevatten nu toestemmingsstructuren die API-toegang tot de applicaties en gegevens van een apparaat regelen, terwijl bestandssystemen zoals Windows (met de beste Windows VPS), Mac en Linux strengere toestemmingen afdwingen voor bestandstoegang die door API’s wordt aangestuurd.

Voorbeelden van API’s

Hier zijn enkele populaire voorbeelden van API’s die verschillende protocollen en standaarden gebruiken:

1. Google Maps: Alles van de techgigant Google zal waarschijnlijk de standaard zetten voor anderen in de industrie. Zo is het ook met hun kaartendienst. Veel websites zullen Google Maps API’s integreren om kaarten weer te geven. Hun Directions API gebruikt bijvoorbeeld HTTP requests met antwoorden geformatteerd in XML of JSON om routebeschrijvingen tussen verschillende locaties te geven.
2. WeatherAPI:Hiermee heb je toegang tot gratis geolocatie- en weergegevens. Het heeft ook een groot aantal API’s voor weersvoorspellingen, sport, astronomie, geolocatie, tijdzones en IP lookups. De gegevens worden geleverd in JSON/XML via een eenvoudige RESTful API. Je kunt de API rechtstreeks via HTTP of HTTPS aanvragen. De site bevat ook gedetailleerde documentatie om ontwikkelaars te helpen met de API.
3. Yelp API: De API is gebouwd op GraphQL en biedt gebruikers informatie over eten, handelaren en beoordelingen van restaurants, spa’s, activiteiten en meer. Servers retourneren gegevens volgens alle methoden van het HTTP-verzoekprotocol. Bij het implementeren van nieuwe applicaties kunnen hun ontwikkelaars API endpoints erin integreren. Het uitwisselingsformaat dat wordt gebruikt is JSON.

Verschillende softwareproducten en tools gebruiken API’s om de functionaliteit te implementeren die hun klanten nodig hebben. Van DevOps tot platforms zoals Microsoft SharePoint, krachtige API-bronnen zijn Docker, Jenkins en GitLab. Voor bedrijven die vertrouwen op SharePoint kan het zoeken naar Sharepoint ontwikkelingsdiensten van ervaren leveranciers helpen om API’s naadloos te integreren en de functionaliteit te verbeteren. Open API’s geïntegreerd met sociale netwerksites kunnen een extreem breed scala aan functionaliteiten voor derden creëren, waaronder nieuwsfeeds, het delen van foto’s en vele andere.

Conclusie

API’s zijn essentieel voor het versnellen en vereenvoudigen van het softwareontwikkelingsproces. Ze stellen ontwikkelaars niet alleen in staat om diensten van derden te gebruiken om nieuwe applicaties te bouwen, maar ook om extra functionaliteiten toe te voegen aan bestaande oplossingen. API’s zorgen ervoor dat ontwikkelaars niet alle knowhow van een andere oplossing hoeven te begrijpen en fungeren als een abstractielaag die verschillende softwaresystemen met elkaar verbindt en tegelijkertijd de complexiteit van de systemen verbergt.

FAQ