Een API (Application Programming Interface) is een vaste set regels waarmee het ene softwareprogramma gegevens of functies van een ander programma gebruikt, zonder tussenkomst van een mens. Waar een gebruikersinterface bedoeld is voor mensen, is een API bedoeld voor software.
Een API werkt met verzoeken en antwoorden: software stuurt een verzoek naar een vast adres en krijgt gegevens of een bevestiging terug.
Een API-koppeling verbindt twee systemen via hun API’s, zodat gegevens automatisch overkomen in plaats van via een export of overtypen. Zulke koppelingen vormen de basis onder AI agents en automatisering op kantoor.
Toegang loopt via een API-sleutel of token. Wie die sleutels beheert en welke rechten ze geven, is een vraag voor het kantoor, niet alleen voor de leverancier.
Waar staat API voor?
API staat voor Application Programming Interface, letterlijk een programmeerinterface voor applicaties: een set functies en regels waarmee software met een programma communiceert. MDN, de documentatie van Mozilla, beschrijft een API als een contract tussen het programma dat de API aanbiedt en de software die hem gebruikt.
Zo’n contract legt vast welke vragen een programma accepteert, in welk formaat en wat het terugstuurt. Zolang beide kanten zich eraan houden, werkt de uitwisseling, ongeacht in welke programmeertaal de software is geschreven.
Hoe werkt een API?
Een API werkt met een verzoek en een antwoord: software stuurt een verzoek naar een endpoint, een vast webadres voor één soort gegevens of handeling, en ontvangt daarop een antwoord.
Een voorbeeld: een offertetool vraagt via de API van het CRM de contactgegevens van een klant op. Daarna controleert het CRM of de tool daar recht op heeft en stuurt het de naam, het adres en het e-mailadres terug.
Taalmodellen zijn op dezelfde manier bereikbaar. Via de Claude API stuur ik vanuit Python-scripts op mijn VPS teksten naar Claude en krijg ik het resultaat terug in mijn eigen werkstroom.
Wat stuur je naar een API?
Naar een API stuur je een verzoek met vier onderdelen: een methode, een adres, je sleutel en eventueel inhoud. De methode geeft het soort verzoek aan: GET haalt gegevens op, POST stuurt gegevens en verandert vaak iets aan de kant van de server.
De inhoud staat meestal in JSON, een licht en tekstgebaseerd formaat dat volgens de standaard RFC 8259 los staat van elke programmeertaal. JSON legt gegevens vast als paren van naam en waarde, bijvoorbeeld een veld klantnaam met de naam van de klant als waarde.
Wat krijg je terug van een API?
Een API stuurt gegevens terug plus een statuscode die aangeeft of het verzoek is gelukt. Vijf statuscodes kom je vaak tegen:
- 200: het verzoek is gelukt en het antwoord bevat de gevraagde gegevens.
- 401: de authenticatie ontbreekt of is ongeldig, meestal door een verkeerde of verlopen sleutel.
- 404: het gevraagde adres of record bestaat niet.
- 429: te veel verzoeken in korte tijd, omdat de API rate limiting toepast.
- 500: er ging iets mis aan de kant van de server.
In een productieworkflow op mijn VPS liep ik bij bulk-analyses via de Claude API tegen rate limits aan. Mijn scripts wachten daarom bij een 429, een 500 of een overbelaste server en proberen het daarna opnieuw.
Wat is een REST API?
Een REST API is een API volgens de architectuurstijl REST (Representational State Transfer), die werkt met gewone webadressen en de standaardmethodes van HTTP. Roy Fielding beschreef REST in 2000 in zijn proefschrift aan de University of California, Irvine.
In een REST API heeft elk soort gegevens een eigen adres, zoals een adres voor klanten en een adres voor facturen. Met GET lees je, met POST maak je iets aan; het antwoord komt meestal in JSON.
SOAP is een ouder protocol met strikte XML-berichten. GraphQL is een querytaal waarmee de vrager zelf bepaalt welke velden terugkomen.
Wat is een API-koppeling?
Een API-koppeling is een verbinding tussen twee systemen die via hun API’s automatisch gegevens uitwisselen. Een nieuwe klant in het CRM komt zo vanzelf in het boekhoudpakket terecht, zonder dat iemand hem overtypt.
Zonder koppeling zijn er twee alternatieven. Bij exporteren en importeren zet je gegevens in een bestand, vaak een CSV, en lees je dat bestand in het andere systeem in. Bij overtypen doet een medewerker het met de hand.
Een export geeft een momentopname, een koppeling houdt beide systemen gelijk zonder handwerk.
Wat zijn de voordelen van een API-koppeling?
Een API-koppeling heeft vijf voordelen ten opzichte van exporteren of overtypen:
- Actualiteit: gegevens staan direct in beide systemen, in plaats van pas na de volgende export.
- Minder overtypfouten: geen verwisselde cijfers, ontbrekende velden of verkeerd gespelde namen door handwerk.
- Eén bron: elk gegeven wordt op één plek ingevoerd en beheerd, waarna de koppeling het verspreidt.
- Herleidbaarheid: elk verzoek is te loggen, zodat achteraf zichtbaar is wie wat heeft veranderd.
- Basis voor automatisering: AI-toepassingen en no-code tools werken met dezelfde API’s om taken over te nemen.
Een koppeling maakt je wel afhankelijk van de aanbieder. Wijzigt die zijn API, dan stopt de koppeling totdat iemand hem aanpast.
Hoe krijg je toegang tot een API?
Toegang tot een API krijg je met een sleutel of token die bewijst wie het verzoek doet en welke rechten daarbij horen. Een verzoek zonder geldige sleutel of token krijgt doorgaans statuscode 401 terug.
Wat is een API-sleutel?
Een API-sleutel (API key) is een lange geheime code die je bij de aanbieder aanmaakt en die je software bij elk verzoek meestuurt. Er bestaat geen algemene standaard voor; elke aanbieder bepaalt zelf hoe zijn sleutels werken.
Wie de sleutel heeft, handelt namens het account waaraan hij gekoppeld is. Een gelekte sleutel geeft een buitenstaander dus dezelfde toegang, en bij een betaalde API komen de kosten op jouw rekening.
Wat is een API-token?
Een API-token is meestal een access token: volgens de OAuth 2.0-standaard (RFC 6749, oktober 2012) een tekenreeks die een verleende autorisatie vertegenwoordigt, met een afgebakende reikwijdte en looptijd. Een token verloopt dus, waar een sleutel vaak blijft werken tot je hem intrekt.
OAuth is het raamwerk waarmee je een toepassing beperkte toegang geeft tot je account zonder je wachtwoord te delen. De toepassing krijgt daarvoor een token met alleen de rechten die jij hebt goedgekeurd.
Hoe beheer je API-sleutels binnen een kantoor?
API-sleutels beheer je binnen een kantoor met een vaste eigenaar, beperkte rechten en een procedure voor intrekken. Vijf afspraken dekken het grootste risico:
- Maak per toepassing een aparte sleutel aan, zodat je bij een lek alleen die ene koppeling stillegt.
- Geef elke sleutel alleen de rechten die de koppeling gebruikt, bijvoorbeeld lezen zonder wijzigen.
- Deel sleutels nooit via e-mail, chat of een gedeeld document, maar via een wachtwoordbeheerder.
- Trek sleutels direct in wanneer een medewerker vertrekt of een sleutel ergens openbaar is geworden.
- Houd een overzicht bij van welke sleutel bij welke koppeling en welke medewerker hoort.
Bij mijn eigen automatiseringen staat veiligheid voorop: welke data erin gaat, waar die terechtkomt en wie er toegang toe heeft. Een API-sleutel is precies het punt waar die drie vragen samenkomen.
Wat is het verschil tussen een API en een webhook?
Een API en een webhook verschillen in wie het initiatief neemt. Bij een API vraagt jouw software om gegevens, bij een webhook stuurt het andere systeem zelf een bericht zodra er iets gebeurt.
Zonder webhook vraagt software met vaste tussenpozen of er iets nieuws is; dat heet polling. Een webhook maakt polling overbodig, al haal je na een melding vaak alsnog details op via de API.
Wat is het verschil tussen een API en MCP?
Een API en MCP verschillen in reikwijdte: elke API heeft eigen regels per aanbieder, terwijl MCP één open standaard is waarmee een AI-toepassing allerlei systemen op dezelfde manier aansluit.
Via MCP (Model Context Protocol) praat een AI-assistent met een MCP-server, en die server roept op zijn beurt vaak de bestaande API van het pakket aan. MCP vervangt API’s dus niet, maar maakt ze bruikbaar voor AI-toepassingen zonder maatwerkkoppeling per combinatie.
Moet je kunnen programmeren om een API te gebruiken?
Nee, om een API te gebruiken hoef je niet te programmeren. No-code tools zoals Zapier, Make en Power Automate verbergen de verzoeken achter blokken die je aan elkaar klikt.
Voor wat verder gaat dan zulke tools, laat je een taalmodel de code schrijven. Ik bouw mijn eigen automatiseringen met AI als bouwpartner en test de code door hem te draaien.
Heeft elk softwarepakket een API?
Nee, niet elk softwarepakket heeft een API, en een bestaande API dekt niet altijd alle gegevens. Je herkent een API aan ontwikkelaarsdocumentatie, een pagina met koppelingen of een instelling waarin je API-sleutels aanmaakt.
Ontbreekt een API, dan blijft een export over. Voor automatiseringen hanteer ik die grens zelf: een proces komt alleen in aanmerking als het bronsysteem een API of een export heeft.
Hoe leer je een API-koppeling met AI bouwen?
Een API-koppeling met AI bouw je vanuit één terugkerende taak, met de API van een taalmodel als schakel. In de AI automatisering cursus doe je je eerste API-aanroep, maak je een API-sleutel veilig aan en vang je fouten en rate limits op.
Wie liever zonder code werkt, koppelt Claude in dezelfde cursus via Make of Zapier. Zo zie je in de praktijk hoe een API-koppeling werkt: sleutel, verzoek, statuscode en antwoord.
