Op deze pagina
Hoe werkt een API-koppeling?
Vergelijk een API met de bediening in een restaurant. Je gaat als gast niet zelf de keuken in; je geeft je bestelling aan de bediening, die het doorgeeft en het gerecht terugbrengt. Een API werkt hetzelfde: een systeem vraagt via de API om gegevens of een actie, en krijgt het resultaat terug, zonder dat het de binnenkant van het andere systeem hoeft te kennen.
In de praktijk werkt een koppeling zo:
- Een gebeurtenis start de koppeling, bijvoorbeeld een nieuwe bestelling in de webshop.
- Het eerste systeem stuurt de gegevens via de API naar het tweede systeem, of het tweede systeem haalt ze op.
- Het tweede systeem verwerkt de gegevens, bijvoorbeeld door een verkoopfactuur aan te maken in de boekhouding.
- Gaat er iets mis, dan krijgt iemand een melding en worden de gegevens niet zomaar weggegooid.
Om toegang te krijgen tot een API is meestal een sleutel of een inlog nodig, zodat alleen bevoegde systemen erbij kunnen. De meeste moderne API's werken via internet, volgens een vaste opbouw die REST heet, en wisselen gegevens uit in een gestructureerd formaat zoals JSON. Daardoor kunnen systemen van verschillende leveranciers met elkaar praten, ook als ze in een andere programmeertaal zijn gebouwd.
Voorbeelden van API-koppelingen
| Koppeling | Wat er automatisch gebeurt |
|---|---|
| Webshop met boekhouding | Bestellingen worden verkoopfacturen in Exact Online of Moneybird |
| CRM met e-mail | Mails en afspraken worden vastgelegd bij de juiste klant in HubSpot of Pipedrive |
| HR-systeem met salarissoftware | Mutaties van medewerkers gaan van AFAS of Personio naar Nmbrs |
| Formulier met CRM | Een aanvraag op de website wordt een lead met de juiste gegevens |
| Planning met klantcommunicatie | Een gewijzigde afspraak stuurt de klant automatisch een bericht |
| AI met je systemen | Een AI-assistent zoekt een orderstatus op of maakt een ticket aan |
Een voorbeeld: van getekende offerte tot factuur
Een installatiebedrijf werkt met een CRM, een planningssysteem en Exact Online. Zonder koppelingen typt de binnendienst na elke getekende offerte de gegevens drie keer over. Met API-koppelingen gaat het zo: de klant tekent de offerte digitaal, het CRM zet de deal op gewonnen, de klant en de klus komen automatisch in de planning, en na afronding van de klus maakt Exact Online de factuur aan met de juiste bedragen. De binnendienst controleert alleen nog de uitzonderingen. Dit is een illustratief voorbeeld.
Wat levert een API-koppeling op?
- Geen dubbel werk: gegevens worden één keer ingevoerd.
- Minder fouten: geen tikfouten bij het overtypen.
- Sneller: gegevens staan direct in het volgende systeem, niet pas aan het eind van de dag.
- Overzicht: alle systemen hebben dezelfde, actuele gegevens.
- Schaalbaar: meer orders of klanten zonder meer administratief werk.
Benieuwd wat dit voor jouw bedrijf oplevert?
In 45 minuten kijken we samen waar AI in jouw bedrijf tijd oplevert. Gratis en vrijblijvend.
Soorten koppelingen
| Soort | Hoe het werkt | Past bij |
|---|---|---|
| Standaardkoppeling | Een kant-en-klare koppeling die de leverancier aanbiedt | Veelgebruikte combinaties, zoals een webshop met een bekend boekhoudpakket |
| Koppeling via een workflowtool | Make, n8n, Zapier of Power Automate verbinden systemen zonder veel code | Processen met een paar stappen tussen moderne systemen |
| Maatwerkkoppeling | Een ontwikkelaar bouwt de koppeling met de API's van beide systemen | Afwijkende processen, grote volumes of speciale eisen |
| Webhook | Een systeem stuurt direct een seintje als er iets gebeurt | Realtime reageren, bijvoorbeeld op een nieuwe bestelling |
| EDI | Een vaste standaard voor uitwisseling tussen bedrijven | Grote klanten en leveranciers in handel en logistiek |
Lees meer over het kiezen van een tool in n8n, Make of een custom AI-workflow.
API-koppelingen en AI
Een AI-model kan uit zichzelf niets in je systemen. Pas met API-koppelingen kan AI echt werk doen: een factuur klaarzetten in het boekhoudpakket, een klant opzoeken in het CRM of een afspraak plannen. Een AI-agent gebruikt daarvoor dezelfde API's als andere software, steeds vaker via de open standaard MCP. Het verschil met een gewone koppeling: de AI kan ook ongestructureerde informatie verwerken, zoals een e-mail of pdf, voordat de gegevens via de API worden doorgestuurd. Lees meer over AI-workflows en API-koppelingen.
Wat als een systeem geen API heeft?
Sommige oudere systemen hebben geen API, of een API die weinig mogelijk maakt. Er zijn dan drie opties:
- een export en import van bestanden, bijvoorbeeld elke nacht een CSV-bestand
- RPA: een softwarerobot die de schermen bedient zoals een medewerker. Lees meer over robotic process automation
- het systeem vervangen, als het toch al aan vervanging toe is
Waar let je op bij een API-koppeling?
- Veiligheid: geef een koppeling alleen toegang tot de gegevens die nodig zijn, en bewaar sleutels veilig.
- Foutafhandeling: wat gebeurt er als een systeem even niet bereikbaar is? Gegevens mogen niet verloren gaan.
- Monitoring: zorg dat iemand een melding krijgt als een koppeling stopt.
- Limieten: veel API's hebben een maximum aantal verzoeken per minuut of per dag.
- Onderhoud: API's veranderen soms. Iemand moet de koppeling bijhouden.
- Privacy: bij persoonsgegevens gelden de regels van de AVG, inclusief een verwerkersovereenkomst met elke partij.
Veelgestelde vragen over API-koppelingen
Wat is een API-koppeling in eenvoudige woorden?
Een API-koppeling is een automatische verbinding tussen twee programma's, zodat ze gegevens uitwisselen zonder dat iemand iets hoeft over te typen.
Wat kost een API-koppeling?
Een standaardkoppeling of een eenvoudige koppeling via een workflowtool kost vaak weinig, soms alleen een abonnement. Een maatwerkkoppeling kost meer, afhankelijk van het aantal systemen, de complexiteit en de eisen aan beveiliging. Wat het voor jouw situatie oplevert, reken je uit met de ROI-tool; het bedrag voor jouw traject bepalen we na het eerste gesprek.
Heeft Exact Online een API?
Ja. Exact Online heeft een API waarmee andere systemen gegevens kunnen lezen en schrijven, zoals relaties, facturen en boekingen. Lees ook Exact Online koppelen aan AI.
Wat is het verschil tussen een API en een API-koppeling?
Een API is de mogelijkheid die een systeem aanbiedt om ermee te communiceren. Een API-koppeling is de daadwerkelijke verbinding die van die mogelijkheid gebruikmaakt om twee systemen te laten samenwerken.
Kan ik zelf een API-koppeling maken?
Eenvoudige koppelingen kun je zelf maken met tools als Zapier, Make of n8n. Voor koppelingen met veel stappen, grote volumes of gevoelige gegevens is een ontwikkelaar of gespecialiseerde partij verstandig.
Hoe lang duurt het om een API-koppeling te maken?
Een standaardkoppeling staat vaak binnen een dag. Een koppeling via een workflowtool binnen een paar dagen. Een maatwerkkoppeling met meerdere systemen en uitzonderingen duurt meestal een paar weken, inclusief testen.
Wat is een webhook?
Een webhook is een seintje dat een systeem automatisch stuurt als er iets gebeurt, zoals een nieuwe bestelling. Het andere systeem hoeft dan niet steeds zelf te vragen of er iets nieuws is.