In het kort
- API betekenis: application programming interface, een afgesproken ingang waarlangs software gegevens uitwisselt.
- Een API koppeling verbindt twee systemen via hun API's, zodat gegevens zelf de goede kant op gaan.
- Bijna elk modern pakket heeft een API: Shopify, Exact, Moneybird, Mollie, AFAS en de meeste CRM's.
- Een goede koppeling heeft foutafhandeling, logging en een melding als er iets misgaat.
Wat is een API? De uitleg in gewone taal
Vergelijk een API met het loket van een restaurant. Je loopt als gast de keuken niet in. Je geeft je bestelling door aan de bediening, in een vaste vorm: gerecht, aantal, bijzonderheden. De keuken maakt het klaar en de bediening brengt het terug. Hoe de keuken werkt, hoef je niet te weten.
Een API werkt hetzelfde. Een programma stuurt een verzoek in een vaste vorm, bijvoorbeeld "geef me alle orders van vandaag" of "maak deze factuur aan". Het andere systeem voert het uit en stuurt een antwoord terug. Hoe dat systeem van binnen werkt, blijft verborgen.
De vaste vorm is de kern. De maker van de software legt in documentatie vast welke verzoeken kunnen, welke gegevens je moet meesturen en wat je terugkrijgt. Iedereen die zich daaraan houdt, kan met het systeem praten. Zo kan een boekhoudpakket met honderden andere programma's werken, zonder dat de makers elkaar ooit gesproken hebben.
API's zijn ook de reden dat AI iets kan doen in je bedrijf. Een taalmodel zoals ChatGPT of Claude kan zelf niet in je boekhouding kijken. Via een API kan een AI agent wel een klant opzoeken, een order aanmaken of een factuur controleren. Een standaard die dat makkelijker maakt, is MCP. Daarover lees je meer in wat is MCP. Zonder API's blijft AI beperkt tot een chatvenster.
Wat houdt een API koppeling in?
Een API is de ingang van één systeem. Een API koppeling is de verbinding tussen twee of meer systemen via hun API's. De koppeling zelf is een stukje software dat bepaalt wat er wanneer van het ene naar het andere systeem gaat.
Een voorbeeld. Een klant bestelt in je webshop. De koppeling:
- haalt de nieuwe order op via de API van de webshop;
- zoekt of maakt de klant aan in je boekhouding;
- maakt de factuur aan via de API van de boekhouding;
- meldt de zending aan bij de vervoerder;
- zet de track-en-tracecode terug in de webshop, zodat de klant een mail krijgt.
Zonder koppeling doet iemand dat met de hand, met tikfouten en vertraging. Met koppeling gebeurt het binnen een minuut, elke keer op dezelfde manier. Meer over wat wij bouwen lees je bij API koppelingen.
Hoe werkt een API koppeling technisch?
Je hoeft dit niet te kunnen om een koppeling te laten bouwen. Het helpt wel om de woorden te kennen die een ontwikkelaar gebruikt.
| Begrip | Betekenis |
|---|---|
| Endpoint | Het adres voor één soort verzoek, zoals orders of klanten |
| Request | Het verzoek dat je stuurt: ophalen, aanmaken, wijzigen of verwijderen |
| Response | Het antwoord, meestal in JSON, een leesbaar tekstformaat |
| API-sleutel of token | Het wachtwoord van de koppeling, zodat alleen bevoegde software erbij kan |
| Webhook | Het omgekeerde: het systeem meldt zelf dat er iets gebeurd is, bijvoorbeeld een nieuwe betaling |
| Rate limit | Het maximum aantal verzoeken per minuut dat een systeem accepteert |
De meeste moderne API's werken als REST API via internet. Oudere systemen gebruiken soms SOAP of alleen bestandsuitwisseling, zoals CSV via een map of EDI in de groothandel. Ook die kun je koppelen, alleen kost het meer werk. Wat er gebeurt als iets misgaat, is net zo belangrijk als wat er gebeurt als het goed gaat: een koppeling die stil faalt, merk je pas als een klant belt.
Hoe bouw ik een API koppeling?
Er zijn drie routes, van eenvoudig naar maatwerk:
- Een standaardkoppeling. Veel pakketten hebben een kant-en-klare koppeling in hun app store. Klik aan, log in, klaar. Prima als hij precies doet wat je nodig hebt.
- Een automatiseringstool. Met n8n, Make of Zapier bouw je een koppeling met blokken in plaats van code. Geschikt voor de meeste mkb-processen, zeker als er stappen of voorwaarden in zitten.
- Maatwerk. Voor grote aantallen, complexe logica of systemen zonder standaard API schrijft een ontwikkelaar de koppeling in code.
Welke route je ook kiest, begin met een paar vragen. Welk systeem is de bron voor klanten, artikelen, prijzen en voorraad? Wat gebeurt er als een systeem even niet bereikbaar is? Wie krijgt een melding bij een fout? Wie die vragen overslaat, bouwt een koppeling die na een paar maanden stilletjes verkeerde gegevens rondstuurt.
Een voorbeeld uit onze praktijk
Bij Sucre & Co, een groothandel in vers gebak, vriesgebak en chocolade, lopen orders, facturen en leveringen via koppelingen tussen de systemen. Samen met de AI-onderdelen scheelt dat 80 uur handwerk per week.
Eén les uit dat project: koppel ook de partij zonder API. Eén vervoerder had geen kant-en-klare koppeling. Die bouwden we vanaf nul, want juist daar zat het handwerk. Het makkelijke deel koppelen en het lastige deel laten liggen levert vaak weinig op.
Een tweede les: bouw bewaking in. Elke koppeling logt wat hij doet en geeft een melding als iets niet lukt. Zo zie je een probleem voordat een klant het ziet.
Veelgemaakte fouten
- Geen bron afspreken. Als prijzen in twee systemen worden aangepast, overschrijven ze elkaar. Kies per gegeven één bron.
- Geen foutafhandeling. Een koppeling zonder meldingen faalt stil.
- Sleutels delen. API-sleutels horen niet in een mail of spreadsheet. Behandel ze als wachtwoorden.
- Rate limits vergeten. Bij een grote import weigert het systeem opeens verzoeken, en dan missen er orders.
- Denken dat het klaar is. Pakketten veranderen hun API. Reken op onderhoud en controleer koppelingen na een update.
- Alles tegelijk. Begin met de koppeling die het meeste handwerk wegneemt en breid daarna uit.
Uit de praktijk
Veelgestelde vragen
Wat houdt een API in?
Een API is een afgesproken ingang van een softwarepakket. Andere software kan daarlangs gegevens opvragen of versturen, in een vaste vorm, zonder te weten hoe het pakket van binnen werkt.
Wat houdt een API koppeling in?
Een verbinding tussen twee of meer systemen via hun API's. De koppeling bepaalt welke gegevens wanneer van het ene naar het andere systeem gaan, zoals orders van je webshop naar je boekhouding.
Hoe werkt een API koppeling?
De koppeling stuurt verzoeken naar de API van een systeem, bijvoorbeeld om nieuwe orders op te halen, en verwerkt het antwoord in een ander systeem. Met webhooks meldt een systeem zelf dat er iets nieuws is.
Hoe bouw ik een API koppeling?
Kies tussen een standaardkoppeling uit de app store van je pakket, een automatiseringstool zoals n8n of Make, of maatwerk in code. Leg eerst vast welk systeem de bron is en wat er bij een fout gebeurt.
Heeft elk systeem een API?
De meeste moderne pakketten wel, zoals Shopify, Exact, Moneybird, Mollie en AFAS. Oudere systemen soms niet. Dan kan een koppeling via bestanden, EDI of een eigen tussenlaag.
Wat is een API key?
Een API key of API-sleutel is het wachtwoord van een koppeling. Het systeem controleert bij elk verzoek of de sleutel geldig is en wat hij mag, zodat alleen bevoegde software erbij kan. Behandel een sleutel als een wachtwoord: niet in een mail of spreadsheet, en vervang hem als iemand vertrekt of als hij is uitgelekt.
Wat is een API call?
Eén verzoek van de ene software aan de andere via de API, bijvoorbeeld "geef de orders van vandaag" of "maak deze klant aan". Het antwoord komt meestal in JSON terug. Veel systemen beperken hoeveel calls je per minuut mag doen. Dat heet de rate limit.