API's zitten overal — van je weer-app tot je bankieren op je telefoon. Maar wat is een API nou eigenlijk, en hoe werkt het? In deze uitleg neem ik je stap voor stap mee, zonder jargon.
Wat is een API in gewone taal?
Een API (Application Programming Interface) is een afgesproken manier waarop twee stukken software met elkaar praten. Jij stuurt een verzoek (request) en krijgt een antwoord (response) terug — zonder dat je hoeft te weten hoe de andere kant vanbinnen werkt.
De restaurant-vergelijking
Je zit aan tafel en bestelt bij de ober. Jij hoeft niet te weten hoe de keuken werkt — je geeft je bestelling door en krijgt een gerecht terug. De ober is de API: hij neemt je verzoek aan, brengt het naar de keuken (de server) en komt terug met het resultaat. De menukaart is de documentatie: die vertelt wat je mág bestellen.
Frontend, backend en de API ertussen
De meeste apps bestaan uit drie lagen. De frontend is wat jij ziet en aanraakt (de knoppen en schermen). De backend is waar de gegevens en de logica staan, meestal op een server. De API is het afgesproken doorgeefluik daartussen: de frontend vraagt via de API iets aan de backend en krijgt een antwoord terug. Zie een API daarom als een contract — het legt precies vast hoe je iets mag vragen en wat je terugkrijgt, los van hoe het systeem vanbinnen gebouwd is.
API's zitten overal
Je gebruikt er dagelijks tientallen zonder het te merken:
- Weer-app — haalt de verwachting op bij een weer-API (zoals Buienradar).
- "Inloggen met Google" — de app vraagt via Google's API of jij bent wie je zegt te zijn.
- Betalen in een webshop — de kassa praat via een API met de betaalprovider (iDEAL, Stripe).
- Google Maps in een bezorg-app — de kaart en route komen via de Maps-API binnen.
- KVK-nummer invullen bij een boekhoudpakket — de app haalt via de KVK-API automatisch je bedrijfsnaam en adres op.
Het vaste patroon: request → response
Elke API-aanroep bestaat uit dezelfde onderdelen. Dit is een GET-verzoek om een product op te halen:
GET https://dummyjson.com/products/7
En dit krijg je terug — gestructureerde data in JSON-formaat:
{
"id": 7,
"title": "Chanel Coco Noir Eau De",
"price": 129.99,
"category": "fragrances"
}Een verzoek heeft altijd deze bouwstenen:
| Onderdeel | Wat het is | Voorbeeld |
|---|---|---|
| Method | Wát je wilt doen | GET ophalen, POST aanmaken |
| URL (endpoint) | Wáár je het vraagt | https://dummyjson.com/products |
| Headers | Extra info over het verzoek | Authorization, Content-Type |
| Body | De data die je meestuurt (alleen bij schrijven) | { "title": "..." } |
De belangrijkste HTTP-methods
- GET gegevens ophalen
- POST iets nieuws aanmaken
- PUT een bestaand item bijwerken
- DEL een item verwijderen
Waarom JSON?
JSON (JavaScript Object Notation) is de taal waarin de meeste API's antwoorden.
Het is voor mensen leesbaar én voor computers makkelijk te verwerken: sleutels en waarden
tussen accolades. Je herkent het aan de "sleutel": waarde-paren.
Onthoud dit ene beeld: jij (client) stuurt een method + URL (+ headers + body) naar de server, en krijgt een statuscode + body terug. Elke API is een variatie op dit patroon.
Zelf aan de slag?
Lezen is mooi, maar API's leer je pas echt door ze te gébruiken. In de gratis hands-on labguide "Werken met API's" doe je zelf GET-, POST- en ingelogde requests — met echte API's, stap voor stap.
Start de training "Werken met API's" Geen installatie nodig · werkt in je browser · gratisSamengevat
Een API is de lijm tussen software. Zodra je het patroon request → response herkent — met method, URL, headers en body, en JSON als antwoord — kun je met vrijwel elke API overweg. De rest is oefening. En die oefening vind je in de training hierboven.
