API koppeling maken of bouwen

Kort antwoord: een API-koppeling laat twee softwaresystemen gecontroleerd gegevens uitwisselen. Wie een API-koppeling wil maken of bouwen, legt eerst bron van waarheid, endpoints, authenticatie, datacontract en foutafhandeling vast. Daarna volgen pas ontwikkeling, testen, monitoring en beheer.

Snelle keuze: gebruik een standaardconnector voor één bekende gegevensstroom, n8n of Make.com voor een overzichtelijke workflow en maatwerk wanneer meerdere systemen, afwijkende regels of bedrijfskritische controles samenkomen.

Wat is een API-koppeling?

API staat voor Application Programming Interface. Een API beschrijft hoe software gegevens mag opvragen, toevoegen of wijzigen. De koppeling gebruikt die afspraken om bijvoorbeeld een webshoporder naar ERP of boekhouding te sturen, een CRM-relatie te synchroniseren of een AI-agent veilig een goedgekeurde actie te laten uitvoeren.

Een API is dus de technische toegang; de API-koppeling is de ingerichte gegevensstroom eromheen, inclusief mapping, rechten, validatie, logging en herstel.

Hoe werkt een API-koppeling met requests en responses?

1. Het bronsysteem verstuurt een request naar een endpoint, bijvoorbeeld met GET, POST, PATCH of DELETE.
2. Authenticatie controleert of de aanvrager toegang heeft, vaak via OAuth 2.0 of een API-token.
3. Het doelsysteem valideert velden en bedrijfsregels en geeft een response met data en een HTTP-statuscode.
4. De integratie logt het resultaat en bepaalt of een fout veilig opnieuw mag worden aangeboden.

Status	Betekenis	Actie
200/201	Verwerkt of aangemaakt	Bewaar bron-id en doel-id in de auditlog.
400/422	Ongeldige invoer	Zet het record met foutreden in de foutwachtrij.
401/403	Authenticatie of rechten	Stop automatische retries en herstel credentials/scopes.
429/5xx	Limiet of tijdelijke storing	Gebruik begrensde retry met back-off en idempotentie.

REST, XML, GraphQL of bestandsuitwisseling?

Techniek	Geschikt voor	Aandachtspunt
REST/JSON	Webshops, CRM, ERP en apps	Endpoints, versies, rate limits en webhooks
SOAP/XML	Legacy ERP, finance en overheidsketens	Schema’s, namespaces en certificaten
GraphQL	Gerichte samengestelde data-opvragen	Querykosten, autorisatie en caching
CSV/SFTP	Batchverwerking zonder realtime API	Bestandsvolgorde, volledigheid en herverwerking

De officiële OpenAPI-specificatie helpt om REST-contracten eenduidig te documenteren. Bekijk voor web-API-basics ook MDN Web API-introductie.

API-koppeling maken of bouwen: welke route past?

Route	Kies deze wanneer	Beheer
Standaardconnector	Eén herkenbare standaardflow zonder afwijkende regels	Controleer leverancier, limieten en uitzonderingen.
n8n of Make.com	Een overzichtelijke workflow met beperkte mapping	Borg credentials, scenario-eigenaarschap en foutmeldingen.
Maatwerk API-integratie	Meerdere bronnen, afwijkende bedrijfsregels of kritieke ketens	Werk met datacontract, testomgeving, monitoring en rollback.

Twijfel je tussen workflow en maatwerk? Vergelijk n8n en Make.com of bekijk wanneer een API-integratie specialist nodig is.

Bron van waarheid, datacontract en beveiliging

Leg per klant, order, product, factuur, betaling en status vast welk systeem eigenaar is. Het datacontract bevat veldnamen, typen, verplichte waarden, identifiers, statussen, tijdzones, valuta, privacyregels en wijzigingsrechten. Gebruik minimale scopes, versleutelde secretopslag en periodieke tokenrotatie. Toets risico’s aan de OWASP API Security Top 10.

API-koppeling testen en veilig herstellen

Test succesroutes én fouten: ontbrekende velden, dubbele callbacks, time-outs, rate limits, verlopen tokens, gedeeltelijke uitval en herstel na een storing. Gebruik idempotente sleutels om dubbele orders of facturen te voorkomen. Een foutwachtrij toont bronrecord, doelrecord, foutcode, eigenaar en herstelactie; de auditlog bewaart wie of welke koppeling data wijzigde.

Voorbeelden: webshop, CRM, ERP en AI-agents

• Webshop naar boekhouding: orders, btw, betalingen, refunds en voorraad naar Exact Online, Twinfield of AFAS.
• CRM naar ERP: organisaties, contactpersonen, deals en contractstatus tussen Pipedrive, HubSpot via een API-koppeling, Salesforce en finance.
• Portaal of bedrijfsapp: klanten laten bestellen, plannen of documenten raadplegen bovenop bestaande systemen.
• AI-agent: alleen goedgekeurde API-acties uitvoeren met rechten, logging, human handoff en limieten.

Wat kost een API-koppeling?

De kosten hangen vooral af van het aantal systemen en objecten, kwaliteit van documentatie, authenticatie, mapping, uitzonderingen, realtime of batch, testdata, beveiliging en beheer. Een kleine standaardflow is goedkoper dan een keten met meerdere administraties, webhooks, historische migratie en finance-controle. Bekijk de actuele beslisfactoren bij kosten van een API-koppeling.

API-koppeling implementeren in 30, 60 en 90 dagen

1. 0–30 dagen: proces, bronnen, eigenaar, datacontract, rechten, risico’s en acceptatiecriteria vastleggen.
2. 31–60 dagen: koppeling bouwen, mappings testen, foutwachtrij en auditlog inrichten en gebruikersacceptatie uitvoeren.
3. 61–90 dagen: gefaseerd live, monitoring en retrybeleid aanscherpen, documentatie overdragen en API-beheer beleggen.

API-beheer na livegang

Controleer beschikbaarheid, foutpercentages, wachtrij, verwerkingstijd, API-limieten, verlopen credentials en schemawijzigingen. Spreek af wie incidenten beoordeelt, wie mappings mag aanpassen en hoe rollback werkt. Lees verder over API-beheer, een API-koppeling laten maken of bespreek de gewenste keten.