Definitie: Een API (Application Programming Interface) is een set afspraken waarmee software van het ene systeem gegevens of functies van een ander systeem kan gebruiken, zonder te weten hoe dat andere systeem van binnen werkt. De API legt vast welke verzoeken je kunt doen, in welk formaat en welk antwoord je terugkrijgt.
In het kort
- API staat voor Application Programming Interface: een programmeerinterface tussen twee stukken software.
- Een API werkt met verzoek en antwoord. Een applicatie stuurt een verzoek naar een vast adres, het endpoint, en krijgt gegevens of een bevestiging terug, meestal in JSON.
- De bekendste vorm is de REST API. Andere vormen zijn SOAP, GraphQL en webhooks.
- Je gebruikt dagelijks API’s zonder het te merken: bij inloggen met Google, betalen met iDEAL of het weerbericht in een app.
Wat is een API?
Een API is de afgesproken manier waarop twee programma’s met elkaar praten. Het ene programma vraagt iets, het andere geeft antwoord. De vrager hoeft niet te weten hoe het andere systeem werkt; hij moet alleen weten welke vragen hij mag stellen en hoe het antwoord eruitziet.
Een veelgebruikte vergelijking is de ober in een restaurant, die Guru99 ook gebruikt. Jij kijkt op de kaart en bestelt bij de ober. De ober brengt je bestelling naar de keuken en komt terug met je gerecht. Je komt zelf nooit in de keuken en hoeft niet te weten hoe het gerecht wordt bereid. De kaart is de documentatie van de API, de ober is de API en het gerecht is het antwoord.
Thunderbit gebruikt een vergelijkbaar beeld met een drive-in: je bestelt in een vast formaat bij het loket, krijgt precies wat je vroeg en komt de keuken nooit in. Wat beide vergelijkingen duidelijk maken: een API is een gecontroleerde ingang. Het systeem bepaalt zelf wat het naar buiten laat zien en wat niet.
Wat betekent API?
| Onderdeel | Betekenis |
|---|---|
| Application | Software met een bepaalde functie, zoals een boekhoudpakket, webshop of app |
| Programming | Bedoeld voor gebruik door software en ontwikkelaars, niet door eindgebruikers |
| Interface | Het raakvlak waar twee systemen elkaar ontmoeten en informatie uitwisselen |
Een gebruikersinterface is het scherm waarmee een mens werkt. Een API is de interface waarmee een programma werkt. Daarom heeft een API geen knoppen of schermen, maar vaste adressen, regels en gegevensformaten.
Hoe werkt een API?
Een API werkt volgens een vaste cyclus van verzoek en antwoord. Een eenvoudig voorbeeld: een webshop wil weten of een product op voorraad is bij de leverancier.
- Verzoek. De webshop stuurt een verzoek naar het endpoint van de leverancier, bijvoorbeeld een adres voor voorraadinformatie, met het artikelnummer erbij.
- Authenticatie. In het verzoek staat een sleutel of token, zodat de leverancier weet dat de webshop dit mag vragen.
- Verwerking. Het systeem van de leverancier zoekt de voorraad op in zijn eigen database.
- Antwoord. De leverancier stuurt het aantal op voorraad terug in een vast formaat, meestal JSON.
- Gebruik. De webshop toont op de productpagina of het artikel leverbaar is.
Bij een API horen een paar begrippen die je vaak tegenkomt:
- Endpoint. Het adres waar je een bepaald verzoek naartoe stuurt.
- Methode. Het soort verzoek: GET om gegevens op te halen, POST om iets aan te maken, PUT of PATCH om iets te wijzigen en DELETE om iets te verwijderen.
- Payload. De gegevens die je meestuurt of terugkrijgt.
- Statuscode. Een getal dat aangeeft hoe het verzoek is verlopen. Thunderbit noemt de bekendste: 200 betekent geslaagd, 401 niet geautoriseerd, 404 niet gevonden, 429 te veel verzoeken en 500 een fout bij de server.
- Documentatie. De beschrijving van alle endpoints, velden en regels. Zonder goede documentatie is een API lastig te gebruiken.
Welke soorten API’s zijn er?
API’s kun je op twee manieren indelen: naar wie er toegang heeft en naar de technische opbouw.
Naar toegang, volgens de indeling van Guru99:
| Soort | Wie heeft toegang? | Voorbeeld |
|---|---|---|
| Openbare API | Iedere ontwikkelaar, soms na registratie | Een API voor weergegevens of postcodes |
| Partner-API | Alleen partijen met een afspraak of licentie | Een leverancier die voorraad deelt met vaste wederverkopers |
| Interne API | Alleen systemen binnen de eigen organisatie | De koppeling tussen een webshop en het eigen magazijnsysteem |
| Samengestelde API | Combineert meerdere API’s in één verzoek | Een reisapp die vlucht, hotel en huurauto samen ophaalt |
Naar techniek:
| Type | Kenmerk |
|---|---|
| REST | De meest gebruikte vorm. Werkt via gewone webadressen en HTTP-methoden, meestal met JSON |
| SOAP | Ouder en strenger, werkt met XML en vaste contracten. Nog veel te vinden bij banken, overheid en oudere bedrijfssoftware |
| GraphQL | De vrager bepaalt zelf welke velden hij terugkrijgt, zodat je niet meer of minder ophaalt dan nodig |
| Webhook | Omgekeerde richting: het andere systeem stuurt zelf een bericht zodra er iets gebeurt |
| RPC | Roept direct een functie aan op een ander systeem, bijvoorbeeld met JSON-RPC of gRPC |
Volgens Thunderbit gebruikt 86% van de ontwikkelaars REST. Voor de meeste zakelijke koppelingen kom je dus een REST API tegen.
Voorbeelden van API’s
Je gebruikt dagelijks API’s zonder het te merken. Enkele herkenbare voorbeelden:
- Inloggen met Google of Microsoft. De website vraagt via een API aan Google of Microsoft of je bent wie je zegt dat je bent.
- Online betalen. Een webshop stuurt het bedrag via de API van een betaalprovider en krijgt terug of de betaling gelukt is.
- Kaarten. Een website toont een kaart van Google Maps via de Maps API.
- Weer-apps. De app haalt de verwachting op bij de API van een weerdienst.
- Boekhouding. Een factuur uit je eigen systeem komt via de API van je boekhoudpakket automatisch in de administratie.
- Verzending. Een webshop maakt via de API van een vervoerder een verzendlabel aan en haalt de track-and-tracecode op.
- AI. Een applicatie stuurt tekst naar een taalmodel via bijvoorbeeld de OpenAI API en krijgt een samenvatting terug.
Wat is het verschil tussen een API, een webhook en een koppeling?
Deze begrippen worden vaak door elkaar gebruikt.
| Begrip | Wat het is |
|---|---|
| API | De ingang die een systeem aanbiedt, met regels voor verzoeken en antwoorden |
| Webhook | Een bericht dat een systeem uit zichzelf stuurt als er iets gebeurt, zoals een nieuwe bestelling |
| API-koppeling | De verbinding die je bouwt tussen twee systemen, met behulp van hun API’s |
| SDK | Een pakket met code en hulpmiddelen dat het gebruik van een API makkelijker maakt |
| Integratieplatform | Een tool zoals Make, Zapier of n8n waarmee je koppelingen zonder of met weinig code maakt |
Kort gezegd: de API is de deur, de koppeling is de route die je erdoorheen bouwt. Een systeem zonder API is lastig te koppelen. Dan blijven alleen omwegen over, zoals exportbestanden of het uitlezen van schermen.
Hoe wordt een API beveiligd?
Een API geeft toegang tot gegevens en functies. Beveiliging is daarom essentieel. Encryption Consulting noemt de belangrijkste maatregelen:
- Versleuteling. Verkeer loopt via HTTPS, zodat niemand onderweg kan meelezen.
- Authenticatie. Met een API-sleutel, een token via OAuth of een certificaat bewijst de vrager wie hij is.
- Autorisatie. Daarna bepaalt de API wat die vrager mag: alleen lezen, of ook wijzigen.
- Rate limiting. Een maximum aantal verzoeken per periode voorkomt misbruik en overbelasting.
- Monitoring en versiebeheer. Afwijkend gebruik valt op, en wijzigingen worden gecontroleerd doorgevoerd.
Voor wie een API gebruikt geldt daarnaast: bewaar sleutels nooit in de code van een website of app die in de browser draait, geef een sleutel alleen de rechten die nodig zijn en vervang sleutels als iemand vertrekt of een sleutel mogelijk is uitgelekt.
Waar let je op als je met API’s werkt?
- Kwaliteit van de documentatie. Is duidelijk welke gegevens je kunt ophalen en wijzigen?
- Limieten. Hoeveel verzoeken mag je doen per minuut of per dag, en wat kost extra gebruik?
- Versies. Wat gebeurt er als de aanbieder zijn API aanpast, en hoeveel tijd krijg je om over te stappen?
- Volledigheid. Kun je via de API alles wat je nodig hebt, of alleen een deel van de functies?
- Betrouwbaarheid. Wat doet je systeem als de API tijdelijk niet bereikbaar is?
- Kosten. Sommige pakketten bieden de API alleen in een duurder abonnement aan.
Wat betekent dit voor jouw project?
Bij een nieuw idee onderzoek ik eerst of een bestaand pakket, een koppeling of maatwerk het beste past. De API van de systemen die je al gebruikt speelt daarin een grote rol. Een pakket met een goede API kan vaak blijven, terwijl maatwerk alleen het ontbrekende deel invult.
Bij Marketooo, mijn eigen platform dat nog in actieve ontwikkeling is, gaat het projectmateriaal onder meer over Meta Ads, OAuth en pixelkoppeling. De bouwles daar: maak verantwoordelijkheden zichtbaar voordat een systeem iets uitvoert. Via een API kan software een campagne of publicatie in gang zetten. Dan moet vooraf duidelijk zijn welk account het betreft, wie akkoord geeft en wat er gebeurt als een verzoek mislukt.
In de betaalde blauwdruk breng ik de afhankelijkheden in kaart: welke systemen er zijn, welke API ze bieden en welke gegevens heen en weer moeten.
Vraag? Werk je met systemen die niet met elkaar praten? Stuur me welke pakketten je gebruikt en welke informatie nu met de hand wordt overgezet. Dan kijken we samen welke eerste stap logisch is. Lees ook hoe ik een maatwerk webapplicatie opzet.
Veelgestelde vragen over API
Wat is een API in simpele woorden?
Een API is een afgesproken manier waarop twee programma’s met elkaar praten. Het ene programma stuurt een verzoek, het andere stuurt gegevens of een bevestiging terug, zonder dat de vrager hoeft te weten hoe het andere systeem van binnen werkt.
Wat is een voorbeeld van een API?
Inloggen met je Google-account op een andere website is een voorbeeld van een API. Ook online betalen, een kaart van Google Maps op een website en een factuur die automatisch in je boekhoudpakket komt, werken via API’s.
Wat is het verschil tussen een API en een API-koppeling?
Een API is de ingang die een systeem aanbiedt, met regels voor verzoeken en antwoorden. Een API-koppeling is de verbinding die je bouwt tussen twee systemen, waarbij je hun API’s gebruikt om gegevens uit te wisselen.
Verwante termen
API-koppeling · GraphQL · Software-architectuur · Make (voorheen Integromat) · n8n · Workflow-automatisering · LLM-API / AI-integratie
← Terug naar de kennisbank