Wat is een API? Uitleg in gewone taal voor ondernemers

Je leverancier zegt "dat kan via de API" en je knikt. Dit artikel zorgt dat je de volgende keer de juiste vervolgvraag stelt, want achter dat ene woord zit het verschil tussen een koppeling van een dag en een project van een maand.

Wat is een API in gewone taal?

API staat voor application programming interface. Vergeet die woorden; denk aan een bestelluik.

In een restaurant loop je niet de keuken in om zelf iets te pakken. Je geeft je bestelling door aan het luik, in een vorm die de keuken begrijpt, en je krijgt terug wat je vroeg. Je weet niet hoe ze het klaarmaken en dat hoeft ook niet.

Een API is dat luik tussen twee stukken software. Het ene programma vraagt iets ("geef me de gegevens van klant 4821"), het andere antwoordt in een vast formaat. De regels liggen vooraf vast: welke vragen mogen, wat je terugkrijgt, en wie überhaupt mag aankloppen.

Het belangrijkste gevolg voor jou: als twee systemen een API hebben, kunnen ze gegevens uitwisselen zonder dat iemand iets overtypt.

Waar kom je API's tegen zonder het te weten?

Vaker dan je denkt. Elke keer als één scherm informatie toont die ergens anders vandaan komt:

• Een webshop die bij het afrekenen controleert of je betaalpas gedekt is.
• Een bezorgpagina die de status van je pakket bij de vervoerder ophaalt.
• Een boekingssite die beschikbaarheid bij tientallen aanbieders tegelijk opvraagt.
• Een contactformulier dat de aanvraag meteen in je CRM zet.
• Een chatbot die opzoekt wanneer jouw bestelling wordt geleverd.

In al die gevallen praat software met software. De technische uitleg hiervan staat uitgebreid beschreven in de documentatie van MDN↗, de naslagbron die webontwikkelaars gebruiken.

Wat moet je weten voordat je een koppeling bespreekt?

Vier vragen. Daarmee kun je elk gesprek met een leverancier voeren.

1. Heeft het systeem een API, en is die openbaar? Niet elk pakket heeft er een, en sommige hebben er wel een maar geven die alleen aan partners. Vraag naar documentatie: bestaat die niet, dan bestaat de koppeling in de praktijk ook niet.

2. Mag hij lezen, schrijven of beide? Een API die alleen gegevens teruggeeft, is veel eenvoudiger en veiliger dan een die ook gegevens mag aanpassen. Begin bij lezen.

3. Zitten er limieten op? Veel API's staan een beperkt aantal verzoeken per minuut toe. Bij een chatbot met honderden gesprekken per dag is dat een reële grens.

4. Zit het in mijn abonnement? API-toegang zit regelmatig alleen in een duurder pakket. Dat is zelden een technisch probleem en bijna altijd een factuur.

Wat gaat er mis bij API-koppelingen?

De velden passen niet op elkaar. Jouw systeem kent één adresveld, het andere kent straat, nummer en toevoeging apart. Dit is het saaiste en meest tijdrovende deel van elke koppeling.

Er is geen plan voor storingen. Als het andere systeem er even uit ligt, moet jouw kant netjes wachten en het later opnieuw proberen, niet stilletjes gegevens laten verdwijnen.

De API verandert. Leveranciers brengen nieuwe versies uit en zetten oude uit. Een koppeling heeft onderhoud nodig, net als een auto.

Toegang is te ruim. Een sleutel die alles mag, is een sleutel die alles kan stukmaken. Geef precies de rechten die nodig zijn en niet meer. Het Digital Trust Center↗ van de overheid heeft hier praktische richtlijnen voor ondernemers over.

API, connector of webhook: wat is het verschil?

Drie woorden die in hetzelfde gesprek vallen en iets anders betekenen:

Kort gezegd: de API is de deur, de connector is de kant-en-klare brug erover, en de webhook is het belletje dat gaat als er iets verandert.

Voor AI-toepassingen is dit onderscheid belangrijker geworden. Een chatbot die alleen je documenten leest, heeft geen API nodig. Een chatbot die de status van een order opzoekt, wel. Hoe je dat opbouwt staat in AI koppelen aan je bestaande software en, als je wil laten inrichten, bij AI-chatbot installeren.