Koppelingen

Wat is een API-koppeling

Een API-koppeling laat twee systemen gegevens uitwisselen zonder dat iemand ze overtypt. Een boekhoudpakket, een webshop, een planning en een CRM hebben elk een deur voor andere software, en een koppeling is het verkeer door die deur. Dit is hoe het werkt en waar het misgaat.

Waarom bijna elk bedrijf er een nodig heeft

Volgens het CBS gebruikte in 2025 de helft van de bedrijven met tien of meer werkzame personen ERP-software en 54 procent CRM-software. Bij bedrijven met 100 tot 250 mensen is dat 78 en 73 procent. Elk van die pakketten kent een deel van het bedrijf. Wat het ene weet en het andere niet, wordt overgetypt, tenzij er een koppeling ligt.

Hoe een koppeling werkt

Een API is een afgesproken manier waarop software met andere software praat. Het ene systeem stelt een vraag, het andere geeft antwoord, in een vaste vorm.

Ophalen: de eigen software vraagt om de tien minuten of er nieuwe orders zijn. Eenvoudig, maar altijd iets te laat.
Webhooks: het systeem meldt zelf dat er iets gebeurd is, op het moment zelf. Sneller, maar elke melding moet ontvangen en bewaard kunnen worden.
Vertalen: elk systeem noemt dingen anders. Een klant, een relatie en een debiteur zijn vaak hetzelfde. Dat vertalen is het echte werk.

Toegang en limieten

Een pakket geeft andere software toegang via een sleutel of via OAuth, waarbij de gebruiker eenmalig toestemming geeft. Daarna gelden limieten. Business Central laat per gebruiker 6.000 verzoeken per vijf minuten toe en antwoordt daarboven met een foutcode. Een koppeling die daar geen rekening mee houdt, valt stil op het drukste moment.

Veilig houden

OWASP houdt een lijst bij van de tien grootste risico's van API's. Bovenaan staan geen exotische aanvallen, maar gaten in wie wat mag zien.

Rechten per object: gebruiker A mag order 100 zien, niet order 101.
Sleutels die niet in code of in mail staan, en die in te trekken zijn.
Een grens op hoeveel een koppeling mag opvragen, zodat een fout geen storing wordt.
Een lijst van alle koppelingen die er zijn, met wie ze beheert. Vergeten koppelingen staan op de OWASP-lijst.

Waar het meestal misgaat

Niet in de techniek.

Gegevens die in twee systemen anders zijn: een adres met een typefout, een artikelnummer dat is veranderd.
Een wachtwoord dat verloopt of een medewerker die vertrekt, waardoor de koppeling stilvalt.
Niemand die ziet dat het stilstaat. Een koppeling hoort een lampje te hebben.

Veelgestelde vragen

Heeft mijn pakket een API?

Bijna elk pakket van de laatste tien jaar heeft er een. Exact Online, AFAS, Business Central, Shopify en WooCommerce hebben er allemaal een met documentatie. Bij een pakket zonder API is er vaak een export of een database die we kunnen lezen.

Wat is het verschil tussen een API en een koppeling?

De API is de deur die de leverancier maakt. De koppeling is de software die door die deur gaat en gegevens vertaalt naar het andere systeem.

Kan een koppeling gegevens beschadigen?

Ja, als hij verkeerd is gebouwd. Daarom: testen op een kopie, een controle inbouwen voordat iets wordt weggeschreven, en een logboek bijhouden van wat er is veranderd.