Koppelingen laten je systemen met elkaar praten, zodat je gegevens niet langer handmatig overtikt. Je website die een bestelling doorzet naar je boekhouding, je voorraad die automatisch klopt, je CRM dat zichzelf bijwerkt. Het hart daarvan is de API. Deze gids legt in gewone taal uit wat een API is, hoe een koppeling werkt, wat webhooks zijn en waar je op let voordat je iets laat koppelen.

Wat is een API in gewone taal?

API staat voor Application Programming Interface, maar de naam doet er niet toe. Zie het als een nette balie tussen twee systemen. Het ene systeem stelt via die balie een vraag (geef me de laatste bestellingen, maak een factuur aan), het andere geeft een net antwoord, volgens afspraken die beide kennen. Niemand hoeft in elkaars systeem te graaien; ze communiceren via een vaste, voorspelbare ingang.

Het mooie: omdat de afspraken vastliggen, gebeurt die uitwisseling automatisch en betrouwbaar. Een uitgebreidere uitleg met voorbeelden staat in het artikel API-koppelingen uitgelegd.

Hoe praten twee systemen met elkaar?

In de praktijk verloopt een koppeling vaak zo: jouw website of applicatie stuurt een verzoek naar de API van een ander systeem. Dat verzoek bevat wat je wilt en een sleutel die bewijst dat je het mag vragen. Het andere systeem stuurt gestructureerde gegevens terug, meestal in een formaat dat machines makkelijk lezen.

Authenticatie: wie mag wat?

Een koppeling werkt met sleutels of tokens, zodat alleen geautoriseerde systemen toegang hebben. Dat is belangrijk voor de beveiliging: een koppeling mag nooit een achterdeur worden. Schone, veilige opzet hoort er standaard bij, zie een veilige website bouwen.

Heen en terug

Koppelingen kunnen eenrichtingsverkeer zijn (jouw site stuurt orders naar de boekhouding) of tweerichting (status uit de boekhouding komt ook terug op de site). Welke kant op het verkeer moet, bepaal je vanuit het proces.

Wat een koppeling betrouwbaar maakt

Een koppeling is pas waardevol als je erop kunt vertrouwen. Het verschil tussen een koppeling die jaren stilletjes haar werk doet en een die elke week aandacht vraagt, zit in de details. Een goede koppeling controleert of gegevens kloppen voordat ze worden weggeschreven, voorkomt dat dezelfde order twee keer wordt verwerkt en houdt een logboek bij zodat je kunt terugzien wat er is gebeurd. Dat klinkt als overhead, maar het is precies wat voorkomt dat een koppeling stilletjes verkeerde cijfers in je boekhouding zet. Goedkoop in elkaar gezette koppelingen slaan dit over, en dat merk je pas als het misgaat.

Webhooks: reageren op een gebeurtenis

Bij een gewone API vraag je zelf actief om gegevens wanneer je ze nodig hebt. Een webhook werkt precies andersom: het andere systeem stuurt jou automatisch een bericht zodra er iets gebeurt. Een nieuwe bestelling, een betaling die binnenkomt, een formulier dat is ingevuld.

Dat maakt webhooks ideaal voor automatisering: in plaats van elke vijf minuten checken of er iets nieuws is, krijg je direct een seintje en kan een vervolgactie meteen starten. Meer hierover in webhooks en automatisering.

// API: jij stelt de vraag. Webhook: het systeem belt jou zodra er iets gebeurt.

Praktische koppelingen voor MKB

Koppelingen zijn geen luxe voor grote bedrijven. De koppelingen die voor MKB het snelst lonen:

De rode draad: minder handwerk, minder fouten, meer overzicht. Hoe koppelingen concreet uren besparen lees je in hoe koppelingen je uren werk besparen. Bekijk ook de dienst koppelingen en API's.

Kan elk systeem gekoppeld worden?

Niet altijd, maar vaak wel. De vuistregel: heeft een systeem een API of een fatsoenlijke import- en exportmogelijkheid, dan is een koppeling meestal te maken. Heeft het dat niet, dan is er soms een omweg via export-bestanden of een tussendienst die als vertaler optreedt.

Daarom begint een koppeling altijd met een check: bestaat de API, is die goed gedocumenteerd, en wat mag je ermee? Die check voorkomt dat je halverwege tegen een muur loopt. Een webapplicatie die zelf gekoppeld moet worden, ontwerp je hier vanaf het begin op. Zie de gids over een webapplicatie laten bouwen.

Wat kost een koppeling?

Als richtlijn, exclusief btw:

De prijs hangt vooral af van hoe goed de API gedocumenteerd is en hoeveel er heen en weer moet. Je krijgt de prijs voor afgebakend werk vooraf in een voorstel. Voor open of doorlopend werk werk ik op offerte in plaats van met een gepubliceerd uurtarief.

Waar je op let bij een koppeling

Veelgestelde vragen

Een API is een vaste manier waarop twee systemen met elkaar praten. Het ene systeem stelt een nette vraag, het andere geeft een net antwoord, volgens afspraken die beide kennen. Zo kan bijvoorbeeld je website automatisch een factuur aanmaken in je boekhouding zonder dat iemand iets overtikt.

Bij een API vraag je zelf actief gegevens op wanneer je ze nodig hebt. Een webhook werkt andersom: het andere systeem stuurt je automatisch een bericht zodra er iets gebeurt, bijvoorbeeld een nieuwe bestelling. Webhooks zijn handig om processen direct te laten reageren op een gebeurtenis.

Niet altijd, maar vaak wel. Als een systeem een API of een import- en exportmogelijkheid heeft, is een koppeling meestal te maken. Heeft een systeem dat niet, dan is er soms een omweg via export-bestanden of een tussendienst. Vooraf checken of de koppeling mogelijk is voorkomt teleurstellingen.

Een losse, afgebakende koppeling begint vanaf enkele honderden euro's, afhankelijk van hoe goed de API gedocumenteerd is en hoeveel gegevens er heen en weer moeten. Complexere integraties met meerdere systemen lopen hoger op. Je krijgt de prijs vooraf in een voorstel; open werk gaat op offerte.

Verder in de kennisbank: Maatwerk website: de complete gids · Een webapplicatie laten bouwen

Direct relevant: dienst koppelingen en API's · artikel koppelingen besparen tijd