Wat is een API-koppeling? Uitleg met voorbeelden voor ondernemers
In dit artikel
Een API-koppeling is een vaste verbinding waarlangs twee programma's automatisch gegevens uitwisselen, zonder dat iemand iets overtypt. De API is het loket van een programma: je vraagt iets aan in een afgesproken vorm, laat je sleutel zien en krijgt antwoord. Zo komt een bestelling vanzelf in je boekhouding of een aanvraag in je CRM. Een koppeling kost eenmalig bouwtijd en daarna onderhoud, want API's veranderen, en de sleutel hoort op een server, nooit in de browser. Bouw en onderhoud van zo'n koppeling neem ik bij mijn sites op me.
Wat is een API-koppeling? Denk aan een loket
API staat voor application programming interface. Dat klinkt ingewikkelder dan het is. Een API is het loket van een programma: de plek waar andere programma's iets kunnen opvragen of aanleveren, volgens vaste regels.
Vergelijk het met het loket in het gemeentehuis. Je mag niet zelf het archief in. Je vult een formulier in met precies de velden die gevraagd worden, je laat je legitimatie zien en de medewerker geeft je wat je mag hebben. Vraag je iets wat niet op het formulier staat, of klopt je legitimatie niet, dan krijg je niets.
Een API werkt net zo:
- Het formulier is de documentatie van de API: welke vragen je kunt stellen en in welke vorm.
- De legitimatie is de API-sleutel, een lange geheime code die laat zien wie er vraagt en wat die mag.
- Het antwoord komt terug in een vaste vorm, meestal JSON, een tekstformaat dat programma's makkelijk lezen.
Een API-koppeling is het stukje software dat automatisch langs dat loket gaat. Komt er een bestelling binnen in je webshop, dan vraagt de koppeling je boekhoudpakket om er een factuur van te maken. Niemand hoeft meer iets over te typen.
Zo ziet zo'n vraag en antwoord er vereenvoudigd uit:
Vraag: GET https://api.voorbeeld-boekhouding.nl/v2/klanten?email=jan@voorbeeld.nl
Sleutel: Authorization: Bearer [geheime sleutel]
Antwoord: { "id": 4821, "naam": "Jan de Vries", "openstaand": 125.00 }
Dat ziet er overzichtelijk uit, en voor één vraag is het dat ook. Het werk zit in alles eromheen: wat er gebeurt als het antwoord uitblijft, als Jan twee keer in het systeem staat of als de sleutel niet meer geldig is.
Vaak hoor je de term REST API. Dat is de meest gebruikte manier om zo'n loket in te richten: elk soort gegeven heeft een eigen adres, zoals /klanten of /facturen, en er zijn vaste werkwoorden om iets op te vragen, aan te maken, te wijzigen of te verwijderen. De v2 in het adres is het versienummer van de API. Dat getal komt later in dit artikel nog terug.
Vijf voorbeelden van API-koppelingen in het mkb
De meeste ondernemers gebruiken al API-koppelingen zonder het te weten. Elke keer dat twee programma's elkaar iets doorgeven, zit er een API tussen. Vijf veelvoorkomende voorbeelden:
| Koppeling | Wat er automatisch gebeurt | Wat het scheelt |
|---|---|---|
| Webshop en boekhouding | Elke bestelling wordt een verkoopboeking of factuur | Overtypen en fouten bij de btw |
| Website en CRM | Een aanvraag via je formulier komt als lead in je CRM | Kopiëren uit je mailbox, vergeten leads |
| Kassa en voorraad | Een verkoop in de winkel verlaagt de voorraad in je webshop | Verkopen wat je niet meer hebt |
| Website en agenda | Een klant ziet vrije tijden en boekt zelf een afspraak | Heen en weer bellen en mailen |
| Webshop en verzending | Een bestelling wordt een verzendlabel met track-and-trace | Adressen overtypen, labels los aanmaken |
Voor veel van deze combinaties bestaat een kant-en-klare koppeling, als plugin of als app in het pakket zelf. Dan wordt de API wel gebruikt, maar hoeft niemand code te schrijven. Maatwerk komt pas in beeld als er geen standaardkoppeling is, of als die niet doet wat jij nodig hebt. Ik kijk daarom altijd eerst of een bestaande koppeling volstaat; maatwerk bouw ik pas als die tekortschiet.
Een uitgewerkt voorbeeld van zo'n keten van webshop, verzending en boekhouding staat in WooCommerce koppelen aan MyParcel en e-Boekhouden. Welk CRM bij een klein bedrijf past, lees je in CRM voor het mkb. En de keuze tussen een planningstool koppelen of iets laten bouwen, staat in online afspraken via je website.
API, webhook of automatiseringstool: wat is het verschil?
Drie begrippen die vaak door elkaar lopen:
- Een API is het loket. Jouw systeem gaat erheen en vraagt iets.
- Een webhook is de omgekeerde richting: het andere systeem meldt zich bij jou zodra er iets gebeurt, bijvoorbeeld als een betaling gelukt is. Wat zo'n melding precies is, leg ik uit in wat is een webhook.
- Een automatiseringstool zoals Zapier, Make of n8n is een tussenpersoon die namens jou langs de loketten gaat. De koppeling wordt bij elkaar geklikt in plaats van geprogrammeerd. Dat is snel voor eenvoudige stappen, maar de tool is wel een extra partij waar je gegevens langs lopen en een extra abonnement dat iemand moet bijhouden. Welke tool past, vergelijk ik in Zapier vs Make vs n8n.
Wil je een AI-assistent zoals Claude of ChatGPT toegang geven tot je software, dan gebeurt dat steeds vaker via een MCP-server, een laag bovenop de API die een AI kan gebruiken. Daarover gaat MCP-server.
De API-sleutel: het gevoeligste onderdeel
Wie de sleutel heeft, kan alles wat de koppeling kan: facturen inzien, klantgegevens downloaden, soms zelfs betalingen terugboeken. Een API-sleutel is daarom te vergelijken met de sleutel van je bedrijfspand.
De belangrijkste regel: een geheime sleutel hoort nooit in de browser. Alles wat in de browser van een bezoeker draait, kan die bezoeker lezen. Staat de sleutel in de JavaScript van je website, dan ligt hij in feite op straat. De vraag aan de API loopt daarom altijd via een server, of via een serverfunctie: een klein stukje code bij je host dat alleen draait als het nodig is en de sleutel voor de bezoeker verborgen houdt. Wat zo'n serverfunctie verder kan, staat in serverless functies.
Waar het in de praktijk misgaat:
| Wat er misgaat | Waarom het een probleem is |
|---|---|
| Eén sleutel voor alle koppelingen | Lekt hij uit, dan moet alles tegelijk om en valt alles even stil |
| De koppeling mag meer dan nodig | Een sleutel die alleen facturen hoeft te maken, kan ook klanten verwijderen |
| De sleutel staat in de projectbestanden | Een sleutel die ooit in versiebeheer stond, blijft in de geschiedenis staan, ook na het weghalen |
| De sleutel is rondgemaild of geappt | Hij staat in mailboxen en op telefoons waar niemand zicht op heeft |
| De sleutel wordt nooit vervangen | Een oud-medewerker of vorige leverancier kan er nog bij |
In mijn projecten staan sleutels in de geheime instellingen van de host, de zogeheten omgevingsvariabelen, en nooit in de code of in versiebeheer. Elke koppeling krijgt alleen de rechten die hij nodig heeft. Ook als mijn codeer-agent de code van een koppeling typt, beslis ik waar de sleutel staat en wat de koppeling mag, en kijk ik dat na voordat er iets live gaat.
Hoe duur een uitgelekte sleutel kan worden, zie je goed bij AI-diensten, waar iemand anders op jouw rekening kan doorwerken. Daarover gaat ChatGPT API op je website.
Wat kost een API-koppeling?
Een API-koppeling heeft eenmalige en doorlopende kosten. De bedragen lopen sterk uiteen, omdat het verschil tussen een standaardplugin en maatwerk groot is. Deze posten kom je tegen:
| Kostenpost | Eenmalig of doorlopend | Waar het van afhangt |
|---|---|---|
| Uitzoeken en bouwen | Eenmalig | De documentatie van de API, hoeveel gegevens er over moeten, het aantal uitzonderingen |
| Kant-en-klare koppeling of plugin | Vaak per maand of per jaar | Leverancier en aantal transacties |
| API-toegang bij het pakket | Soms alleen in een duurder abonnement | Het abonnement dat je bij de leverancier hebt |
| Hosting van de koppeling | Doorlopend, meestal laag | Aantal aanroepen, server of serverfunctie |
| Onderhoud en storingen | Doorlopend | Hoe vaak de API verandert en hoe belangrijk de koppeling voor je is |
Kijk bij de derde regel goed naar je huidige abonnement. Niet elk pakket biedt de API in elk abonnement aan, en soms zit er een grens aan het aantal aanvragen per maand.
De bouw zelf is zelden het lastigste deel. De tijd zit vooral in de uitzonderingen: een klant die al bestaat, een product zonder artikelnummer, een creditfactuur, een bestelling die half wordt teruggestuurd. Die vragen stel ik voordat ik begin, omdat een uitzondering die pas na de livegang opduikt meer tijd en gedoe kost dan een die vooraf op tafel ligt.
Waarom een koppeling onderhoud nodig heeft
Een koppeling is geen kabel die je één keer aanlegt. Beide kanten veranderen, en dan kan hij stilletjes ophouden met werken. De bekendste oorzaken:
- De API verandert. Leveranciers brengen nieuwe versies uit en zetten oude versies na een aankondiging uit. Dat is die v2 in het adres. Wie de aankondiging mist, merkt het pas als er geen facturen meer binnenkomen.
- De toestemming verloopt. Bij koppelingen waarbij je inlogt bij het andere pakket en de koppeling toestemming geeft (OAuth), verloopt die toestemming soms, of vervalt hij als iemand zijn account opheft.
- Limieten. De meeste API's beperken hoeveel vragen je per minuut of per dag mag stellen. Op een drukke dag kan een koppeling daar tegenaan lopen.
- Je eigen werkwijze verandert. Nieuwe btw-tarieven, een tweede vestiging, een product dat anders verzonden wordt.
Een goed gebouwde koppeling houdt daar rekening mee. Hij probeert het later opnieuw als de andere kant even niet bereikbaar is, schrijft elke fout weg in een logboek en stuurt een melding als het misgaat. En er is iemand die die melding leest en ernaar handelt. Hoe je bewaking zonder ruis inricht, staat in uptime-monitoring.
Dat laatste is waar het vaak misgaat: de melding gaat naar een mailbox die niemand leest, of naar iemand die niet weet wat hij ermee moet. Bouw ik een koppeling, dan valt het bijhouden ervan daarna onder het beheer. Kondigt een leverancier een nieuwe API-versie aan, dan pas ik de koppeling aan. Jij merkt er niets van, tenzij er iets is waar jouw beslissing voor nodig is.
Vragen die je stelt voordat je een koppeling laat maken
Deze vragen horen in het gesprek met je bouwer of leverancier. Het zijn ook de vragen die ik zelf langsloop voordat ik een koppeling bouw.
- Bestaat er al een standaardkoppeling of plugin, en waarom gebruiken we die wel of niet?
- Welke gegevens gaan er precies over, in welke richting en hoe vaak?
- Wat gebeurt er bij uitzonderingen, zoals een bestaande klant, een retour of een creditfactuur?
- Waar staat de API-sleutel en wie kan erbij?
- Welke rechten krijgt de koppeling, en is dat het minimum?
- Via welke partijen lopen de gegevens, en is er een verwerkersovereenkomst als er persoonsgegevens bij zijn?
- Wat gebeurt er als de koppeling faalt? Wordt het opnieuw geprobeerd, gelogd en gemeld, en bij wie?
- Wie houdt aankondigingen van de leverancier over nieuwe API-versies bij en past de koppeling aan?
- Wat kost de bouw, en wat kost het per maand of per jaar om hem werkend te houden?
- Van wie is de code, en kan een andere ontwikkelaar hem overnemen?
Krijg je op vraag 4 of 7 geen helder antwoord, dan is dat een signaal om door te vragen. Op vraag 10 is mijn antwoord kort: de code van de koppeling staat, net als de rest van je site, op jouw naam of onder jouw volledige toegang, zodat een ander hem kan overnemen.
Conclusie: een goede koppeling scheelt werk, als iemand hem bijhoudt
Een API-koppeling laat je systemen automatisch gegevens uitwisselen via het loket van elk programma. Dat scheelt overtypen, fouten en vergeten leads. Een standaardkoppeling volstaat vaak; maatwerk is pas nodig als die niet doet wat je nodig hebt. In beide gevallen zit het vakwerk in de uitzonderingen, de sleutel en het onderhoud.
Voor jou betekent dat: de vraag is niet of iets te koppelen is, maar wie de koppeling bouwt en wie het merkt als hij stilvalt. Bij mij liggen die twee rollen bij dezelfde persoon. Ik kies of een standaardkoppeling volstaat, bouw wat nodig is met de sleutel veilig op de server en houd het daarna in het beheer bij.
Wil je weten hoe een systeem jou zelf een seintje geeft als er iets gebeurt? Lees dan wat is een webhook. Benieuwd hoe ik werk? Download het pitchdeck.
Veelgestelde vragen
Wat is een API key?
Een API key, of API-sleutel, is een lange geheime code waarmee een programma zich bij een API bekendmaakt. De API weet daardoor wie er vraagt en wat die mag. Zo'n sleutel wordt aangemaakt in de instellingen van het pakket waarmee gekoppeld wordt, en kan daar ook weer worden ingetrokken. Behandel hem als een wachtwoord: niet mailen, niet in de code van je website en alleen bewaren op een server of in een wachtwoordmanager. Lekt hij uit, dan moet er direct een nieuwe komen en gaat de oude uit.
Wat betekent REST API?
REST is de meest gebruikte manier om een API in te richten. Elk soort gegeven heeft een eigen webadres, zoals /klanten of /facturen. Met vaste werkwoorden geef je aan wat je wilt: GET om iets op te vragen, POST om iets aan te maken, PUT of PATCH om iets te wijzigen en DELETE om iets te verwijderen. Het antwoord komt meestal terug in JSON, een tekstformaat dat programma's makkelijk lezen. Voor jou als ondernemer is vooral belangrijk dat REST gangbaar is, zodat bijna elke ontwikkelaar ermee kan werken.
Kan ik zelf een API-koppeling maken zonder te programmeren?
In een eenvoudig geval wel. Veel pakketten hebben een ingebouwde koppeling, en met een automatiseringstool zoals Zapier, Make of n8n klik je eenvoudige stappen bij elkaar. Wat er meestal misgaat, zit in wat je niet ziet: uitzonderingen waar niemand aan dacht, een fout die stil blijft, een sleutel op iemands persoonlijke account en een API die verandert zonder dat iemand het merkt. Bij geld, grote aantallen of persoonsgegevens kost dat al snel meer dan het bespaart. Koppelingen die ik maak, neem ik daarom mee in de bouw en daarna in het beheer.
Is een API-koppeling veilig?
Een API-koppeling is zo veilig als hoe hij is ingericht. De verbinding zelf loopt bijna altijd versleuteld via https. De risico's zitten in de sleutel en in de rechten: een sleutel die in de browser staat of wordt rondgemaild, of een koppeling die veel meer mag dan nodig is. Een goed ingerichte koppeling heeft de sleutel op een server, alleen de rechten die nodig zijn en bij persoonsgegevens leveranciers met een verwerkersovereenkomst. Ook ligt vast wat er gebeurt als de koppeling faalt en wie dan een melding krijgt.
Benieuwd hoe ik dit in de praktijk aanpak?
Het pitchdeck laat de hele werkwijze zien.
Geschreven door Dennis Boekhout
Marketing freelancer uit 's-Hertogenbosch. Volg op LinkedIn (opent in een nieuw tabblad)
