Wat is een API — uitleg voor niet-technische opdrachtgevers

Vroeg of laat hoor je het woord in een gesprek met een softwarepartner, een IT-afdeling, of een leverancier van een systeem: API. "We kunnen dat via een API regelen." "Heeft dat systeem een API?" "De kosten hangen af van hoeveel API-calls je doet."

Het is een van de meest gebruikte technische termen in zakelijke software, en ook een van de meest slecht uitgelegd. Dit is wat het werkelijk betekent en waarom het voor jouw bedrijf relevant is.

De restaurantanalogie

Het beste begrip van een API begint niet met code maar met een restaurant.

Jij zit aan tafel. Je weet wat je wilt eten. Je gaat niet zelf naar de keuken om het te vragen — de kok werkt aan een kant die voor jou niet toegankelijk is. In plaats daarvan gebruik je de ober. Jij bestelt bij de ober, de ober communiceert jouw verzoek naar de keuken, de keuken bereidt het, en de ober brengt het resultaat terug naar jouw tafel.

Een API is de ober in dit verhaal. Het is een gestandaardiseerde manier voor twee systemen om met elkaar te communiceren: systeem A doet een verzoek, de API vertaalt dat verzoek naar een formaat dat systeem B begrijpt, systeem B verwerkt het en stuurt een antwoord terug.

Concreet: jouw webshop wil weten of een product op voorraad is in je magazijnsysteem. Jouw webshop stuurt een API-verzoek naar het magazijnsysteem. Het magazijnsysteem stuurt het antwoord terug — "47 stuks beschikbaar" — via dezelfde API. Jouw webshop toont die informatie aan de klant, in realtime, zonder dat iemand er handmatig iets voor hoeft te doen.

Een tweede analogie: het stopcontact

Een andere manier om APIs te begrijpen is via het stopcontact in de muur.

Jij hoeft niet te weten hoe elektriciteit werkt, hoe de kabels in de muren liggen, of wat er in de meterkast gebeurt. Je steekt een stekker in het stopcontact en krijgt stroom. Het stopcontact is de gestandaardiseerde interface tussen het elektriciteitsnet en jouw apparaat.

APIs zijn de stopcontacten van de digitale wereld. Als Mollie (een betalingsprovider) een API aanbiedt, kunnen duizenden webshops betalingen verwerken zonder te hoeven begrijpen hoe Mollie's systemen werken. Ze "steken de stekker in" door de API te integreren, en betalingen stromen.

Waarom elk modern bedrijf uiteindelijk APIs nodig heeft

Dertig jaar geleden gebruikte een gemiddeld mkb-bedrijf één of twee softwaresystemen. Tegenwoordig werken bedrijven gemiddeld met tientallen: een CRM, een boekhoudpakket, een e-mailmarketingtool, een klantenportaal, een ordermanagementsysteem, een HR-pakket, een BI-dashboard.

Al die systemen werken in isolatie tenzij ze aan elkaar worden gekoppeld. Zonder koppelingen betekent dat: data handmatig overtypen tussen systemen, exporteren en importeren van Excel-bestanden, rapportages samenstellen uit vijf verschillende exports, klantinformatie die in drie systemen staat maar in geen enkel systeem compleet is.

Dit kost tijd. Het introduceert fouten. En het maakt het onmogelijk om realtime inzicht te hebben in je eigen bedrijf.

APIs zijn de oplossing. Ze maken het mogelijk dat systemen automatisch data uitwisselen, zonder menselijke tussenkomst.

Concrete voorbeelden van bedrijfsprocessen die API-koppelingen gebruiken:

Een nieuwe klant aanmaken in je CRM wordt automatisch ook aangemaakt in je boekhoudpakket — geen dubbel invoeren meer.

Een betaling die binnenkomt via je webshop triggert automatisch een factuur in Exact en past de voorraad in je systeem aan.

Een medewerker die in je HR-systeem uit dienst gaat, verliest automatisch toegang tot alle bedrijfssystemen — geen handmatige deactivering nodig.

Klantgedrag uit je app wordt automatisch doorgestuurd naar je marketing automation tool voor gepersonaliseerde opvolging.

REST en webhooks: twee manieren waarop APIs werken

Technisch gezien zijn er verschillende soorten APIs, maar voor niet-technische opdrachtgevers is het zinvol om twee smaken te begrijpen.

REST APIs (het meest voorkomend): Jouw systeem vraagt actief om informatie wanneer het die nodig heeft. "Wat is de huidige status van bestelling 4471?" — het systeem stuurt een verzoek, krijgt een antwoord. Dit werkt goed voor situaties waarbij je op een bepaald moment data wilt ophalen.

Webhooks: Het omgekeerde principe. In plaats van dat jouw systeem vraagt, stuurt het andere systeem automatisch een bericht als er iets verandert. "De betaling is geslaagd" — het betalingssysteem stuurt direct een notificatie naar jouw systeem. Webhooks zijn ideaal voor realtime reacties op events, zonder dat jouw systeem constant hoeft te pollen.

Beide methoden zijn tegenwoordig standaard en worden door vrijwel alle professionele softwareproducten ondersteund.

Wat API-integraties kosten

De kosten van een API-integratie variëren sterk, afhankelijk van drie factoren: de kwaliteit van de API's aan beide kanten, de complexiteit van de data die wordt uitgewisseld, en of er transformatie of mapping nodig is.

Eenvoudige integraties (€3.000–€10.000):

Een koppeling tussen twee systemen met goede documentatie, standaard dataformaten, en een beperkte scope. Mollie koppelen aan een webshop, een nieuwsbriefsysteem koppelen aan een CRM, of Google Analytics integreren in een applicatie vallen in deze categorie.

Middelmatige integraties (€10.000–€30.000):

Koppelingen waarbij data moet worden getransformeerd, meerdere systemen betrokken zijn, of waarbij de API van een van de partijen slecht gedocumenteerd is. ERP-koppelingen, integraties met overheidsAPI's, of bidirectionele synchronisatie tussen complexe systemen.

Complexe integraties (€30.000–€80.000+):

Enterprise-niveau integraties, realtime synchronisatie van grote datahoeveelheden, of systemen die zelf geen API hebben en waarbij middleware of maatwerk bridges nodig zijn.

Naast de eenmalige bouwkosten zijn er vaak ook doorlopende kosten: sommige API's rekenen per verzoek (Mollie per transactie, Google Maps per kaartweergave), en sommige providers hanteren maandelijkse toegangskosten boven een bepaald volume.

Vragen die je altijd moet stellen als een bureau een API-integratie voorstelt

Heeft het andere systeem een publieke, gedocumenteerde API? Als het antwoord nee is, of "we moeten dat uitzoeken", dan is het risico op onverwachte complexiteit hoog. Sommige systemen — met name oudere ERP-systemen — hebben geen API of een API die alleen met een dure enterprise-licentie beschikbaar is.

Is de API-koppeling bidirectioneel? Stroomt data alleen van A naar B, of ook terug? Bidirectionele synchronisatie is aanzienlijk complexer dan een eenrichtingskoppeling, en vereist zorgvuldig nadenken over conflictoplossing (wat als dezelfde data op twee plaatsen tegelijk wordt aangepast?).

Wie is verantwoordelijk als de API van de externe partij wijzigt? API's veranderen. Leveranciers brengen nieuwe versies uit en deprecaten oude. Als de integratie breekt omdat de externe API is gewijzigd, wie repareert dat dan? Wat zijn de responstijden? Is dit onderdeel van het onderhoudscontract?

Wat zijn de volumekosten? Als je API-kosten per verzoek betaalt, wat kost dat bij jouw verwachte volume? En bij vijfmaal dat volume?

Een API is geen detail. Het is de infrastructuur die jouw bedrijfssystemen laat samenwerken. Goed gedaan, is het onzichtbaar en vanzelfsprekend. Slecht gedaan, is het een bron van errors, datastoringen en gefrustreerde medewerkers. Neem er de tijd voor om het goed te begrijpen — en de juiste vragen te stellen aan de partij die het voor je bouwt.