Een API (Application Programming Interface) is een vaste manier waarop het ene computerprogramma gegevens opvraagt of verstuurt bij een ander programma. Het werkt als een loket: jij of je software stelt een duidelijke vraag, bijvoorbeeld welke facturen er openstaan, en het systeem geeft precies dat antwoord terug. Zo kunnen boekhoudpakketten, webshops en dashboards automatisch gegevens uitwisselen, zonder dat iemand iets hoeft te exporteren of over te typen.
Je hoort het vaak: “dat kan via de API”. Voor wie niet technisch is, klinkt dat als een verhulde manier om te zeggen dat het ingewikkeld is. In werkelijkheid is een API een eenvoudig idee. Dit stuk legt uit wat een API is, wat hij doet en waarom je er iets aan hebt.
Een API als loket
Zie een API als het loket van een gemeentehuis. Je loopt er niet zelf de archiefkast in; je vraagt iets aan het loket en je krijgt het antwoord terug. Er zijn regels voor welke vragen je mag stellen en in welke vorm. De medewerker achter het loket weet waar alles ligt, jij hoeft dat niet te weten.
Bij software gaat het precies zo. Een boekhoudpakket heeft een API met vaste vragen, zoals “geef me alle verkoopfacturen van deze maand”. Een ander programma stuurt die vraag, krijgt de facturen terug en kan er iets mee doen, bijvoorbeeld ze tonen in een dashboard.
Wat er achter de schermen gebeurt
Een API-aanroep bestaat uit drie delen: een adres, een vraag en een antwoord. Het adres zegt welk gegeven je wilt hebben, bijvoorbeeld facturen of klanten. De vraag kan filters bevatten, zoals een periode. Het antwoord komt terug in een gestructureerde vorm die een programma makkelijk kan lezen.
Meestal moet je je daarbij bekend maken, zodat het systeem weet wie er vraagt en wat die mag zien. Dat gebeurt met een inlog of een sleutel; lees er meer over in wat is een API-sleutel. Zonder die controle zou iedereen bij je gegevens kunnen.
Waarom een API bij je werk past
Zonder API haal je gegevens op door in een systeem in te loggen, een export te maken en die in een ander programma te plakken. Dat kost tijd en gaat gemakkelijk fout. Met een API gebeurt dat automatisch en altijd op dezelfde manier.
Dat is de basis van elke koppeling. Een systeem als Moneybird of Exact Online biedt zijn gegevens aan via een API, en een platform haalt ze daarmee op. Hoe dat in zijn werk gaat, staat bij koppelingen beheren en in wat is data-integratie.
Zelf met een API werken of een platform gebruiken
Je kunt zelf een koppeling met een API bouwen, maar dat vraagt kennis van de API van elk systeem. Elk pakket heeft eigen regels voor inloggen, voor het ophalen van grote hoeveelheden gegevens en voor wijzigingen in de loop van de tijd. Dat is werk dat je bij elke nieuwe bron opnieuw doet.
Een platform neemt dat werk over. Je koppelt je systeem, en het platform haalt de gegevens op en legt ze gestandaardiseerd klaar. Wil je de afweging maken, lees dan een API-koppeling zelf bouwen of een platform gebruiken.
Een voorbeeld: facturen in een dashboard
Stel dat je de facturen uit je boekhoudpakket in een dashboard wilt tonen. Het programma dat het dashboard vult, stuurt via de API een vraag: geef alle verkoopfacturen sinds 1 januari. Het boekhoudpakket controleert eerst wie er vraagt, en stuurt dan de facturen terug, bijvoorbeeld in pagina’s van duizend rijen. Het programma vraagt net zo lang de volgende pagina op tot alles binnen is en zet de rijen in een tabel.
Dit gebeurt in seconden en op een vast moment, bijvoorbeeld elke dag. Handmatig zou je elke keer moeten inloggen, exporteren en plakken. Let wel op de limieten: een API staat maar een bepaald aantal vragen per periode toe, zodat het systeem niet overbelast raakt. Een goede koppeling houdt daar rekening mee.
Een API geeft bovendien alleen terug wat je mag zien. Heb je in het bronsysteem beperkte rechten, dan geldt dat meestal ook voor de gegevens die de API teruggeeft.
Onze tip: je hoeft een API niet te begrijpen om er gebruik van te maken. Weet vooral welke gegevens je uit welk systeem wilt halen, en laat de techniek over aan wie dat dagelijks doet.
