DigituraDigitura
Plan een gratis bedrijfsscanBel 06 27 56 83 59

Je krijgt mij aan de lijn, niet een helpdesk.

Wat is een API-koppeling? Uitleg in gewone taal

Een API-koppeling zorgt dat twee programma's elkaar gegevens geven, zodat niemand ze hoeft over te typen. Wat het is, hoe het werkt en waar je op moet letten.

Gerwin Kuijntjes, software-engineer
· 5 min. leestijd

Wat is een API-koppeling? Uitleg in gewone taal

Je krijgt een bestelling in je webshop. Daarna maakt iemand in je boekhouding een factuur met dezelfde gegevens. Als dat gebeurt zonder dat een mens het overtikt, dan zit er een API-koppeling tussen. Dit artikel legt uit wat dat is, hoe het werkt en waar je op moet letten als je er een wilt.

Wat is een API-koppeling?

API staat voor application programming interface. Dat klinkt technisch, maar het idee is eenvoudig: het is de ingang die een programma aanbiedt, zodat andere programma’s er gegevens uit kunnen halen of erin kunnen zetten.

Denk aan een restaurant. Jij zit aan tafel, de keuken maakt het eten. Je loopt niet zelf de keuken in: je geeft je bestelling aan de ober, en die brengt het terug. De API is de ober. De koppeling is het afgesproken werk van die ober: welke bestelling, naar welke keuken, en wat er terugkomt.

Een API-koppeling is dus een verbinding tussen twee programma’s die automatisch gegevens uitwisselt, volgens afspraken die beide programma’s begrijpen.

Webshopheeft de bestellingen
vraagt: nieuwe orders?
APIde ingang van het programma, met een API-sleutel
antwoordt: dit zijn ze
Boekhoudingkrijgt de gegevens
De koppeling vraagt via de API om nieuwe gegevens en zet ze op de andere plek neer, volgens afspraken die beide kanten begrijpen.

Een voorbeeld uit de praktijk

Een webshop en een boekhoudpakket zijn twee losse programma’s die niets van elkaar weten. Zonder koppeling gaat het zo:

  1. Een klant bestelt in de webshop.
  2. Iemand neemt naam, adres, producten en bedragen over in de boekhouding.
  3. Er gaat een factuur de deur uit.

Met een koppeling wordt stap twee overgenomen. De bestelling komt binnen, het programma haalt de gegevens op en zet ze in de boekhouding. Niemand typt iets over, en een typefout kan er niet meer in sluipen.

Hetzelfde kan met een formulier op je website dat een aanvraag rechtstreeks in je planning zet, of met een urenregistratie die cijfers doorgeeft aan je facturatie. Wat je ook koppelt, het gaat om dezelfde vraag: waar worden nu gegevens overgetikt?

Hoe werkt het?

Er zijn een paar manieren waarop een koppeling gegevens verplaatst. De drie die je het vaakst tegenkomt:

  • Op afroep. De koppeling vraagt op vaste tijden: “zijn er nieuwe bestellingen?” Voor veel bedrijven is eens per uur genoeg. Het is eenvoudig en stabiel.
  • Op melding. Het ene programma geeft zelf een seintje wanneer er iets gebeurt, bijvoorbeeld bij een nieuwe order. Dat heet een webhook. Het is sneller, maar vraagt iets meer zorg bij de bouw.
  • Per bestand. Heeft een pakket geen API, dan werkt het soms met een export die de koppeling inleest. Minder elegant, maar het overtikken is weg.

Om te bewijzen dat een koppeling in jouw gegevens mag kijken, gebruikt hij een API-sleutel: een lange code die werkt als een sleutelkaart. Hij opent alleen de deuren die jij hebt aangewezen, en je kunt hem intrekken.

Heeft mijn pakket een API?

Dat is de eerste vraag bij elke koppeling. Zo kom je erachter:

  • Kijk in de instellingen van je pakket naar woorden als koppelingen, integraties, API of ontwikkelaars.
  • Zoek op de website van de leverancier naar de documentatie. Een pakket met een goede API heeft meestal een pagina die uitlegt wat je ermee kunt doen.
  • Vraag het de leverancier. Soms hoort toegang tot de API bij een duurder abonnement, dus vraag meteen wat het kost.

De meeste gangbare pakketten voor boekhouding, webshops, planning en klantbeheer hebben een API. De kwaliteit verschilt wel. Een goed gedocumenteerde API is snel gekoppeld, een beperkte of ontbrekende kost meer werk.

Wat kan er misgaan?

Een koppeling is zelden het probleem als alles werkt. Het gaat om wat er gebeurt als iets niet werkt: het ene pakket is even niet bereikbaar, een veld ontbreekt, of dezelfde order komt twee keer binnen. Een goede koppeling vangt dat op:

  • Een gegeven wordt eerst opgeslagen, en dan pas doorgestuurd, zodat er niets verloren gaat als de ontvanger stilligt.
  • Een mislukte overdracht wordt opnieuw geprobeerd, en jij ziet dat er iets hangt.
  • Dezelfde order wordt maar één keer verwerkt.
  • Er is een logboek: wat is er wanneer overgezet en wat is blijven hangen?

Een koppeling die stilletjes stopt is erger dan geen koppeling, want je vertrouwt erop dat het werkt. Vraag dus aan iedereen die een koppeling bouwt hoe je merkt dat hij niet meer werkt.

Zelf doen of laten maken?

Voor een eenvoudige koppeling met een paar stappen en weinig volume kun je vaak een dienst gebruiken zoals Zapier of Make. Dat is snel ingericht en goedkoop. Een eigen koppeling wordt interessant als:

  • de koppeling veel regels kent, bijvoorbeeld andere afspraken per klant;
  • er gevoelige gegevens doorheen gaan die je liever niet via een derde partij laat lopen;
  • het volume oploopt;
  • je wilt dat een fout betrouwbaar wordt opgevangen en gemeld.

Of een standaardoplossing voor jou past, hangt af van je situatie. Past hij, dan raad ik dat aan. Meer over die afweging staat in standaardpakket of maatwerk.

Wat kost een API-koppeling laten maken?

Dat hangt af van het aantal systemen, of gegevens één kant op gaan of twee kanten, de kwaliteit van hun API, het aantal uitzonderingen en wat er bij een fout moet gebeuren. Een koppeling tussen twee systemen is meestal een van de kleinere klussen: reken op weken, niet op maanden.

Ik werk met een vaste prijs per afgebakend stuk werk. Wil je weten wat dat voor jouw situatie wordt, kijk dan bij API-koppeling laten maken, of plan een gratis bedrijfsscan. Ik kijk een uur mee, zie waar gegevens worden overgetikt en zeg eerlijk of een koppeling de moeite waard is. Hoe je dat overtikken in kaart brengt, staat in wat dubbel overtypen je kost.

Liever dat iemand meekijkt?

Tijdens de gratis bedrijfsscan kijk ik een uur mee en reken ik met jouw getallen.

Plan de scan

Veelgestelde vragen

Wat is het verschil tussen een API en een API-koppeling?

Een API is de ingang die een programma aanbiedt om gegevens op te halen of weg te schrijven. Een API-koppeling is wat er gebouwd wordt om die ingang te gebruiken, zodat twee programma's elkaar automatisch gegevens geven.

Wat is een API-sleutel?

Een API-sleutel is een lange code die bewijst dat een koppeling mag meekijken in jouw account bij een pakket. Zie het als een sleutelkaart die alleen bepaalde deuren opent. Je geeft hem niet aan iedereen en je kunt hem intrekken.

Heeft elk programma een API?

Niet elk, maar de meeste gangbare pakketten voor boekhouding, webshops, planning en klantbeheer wel. Soms hoort toegang tot de API bij een duurder abonnement. Heeft een pakket er geen, dan is er vaak nog een export waarmee je kunt werken.

Kan ik een API-koppeling zelf maken?

Voor een eenvoudige koppeling met een paar stappen kun je een dienst als Zapier of Make gebruiken. Bij veel regels, gevoelige gegevens of hoog volume is een eigen koppeling vaak betrouwbaarder.

Begrippen bij dit artikel

Gerwin Kuijntjes

Geschreven door Gerwin Kuijntjes

Software-engineer uit Ochten. Ik bouw software die werk uit handen neemt, en schrijf hier over wat dat oplevert, in gewone taal.

Meer over mij

Wil je dit laten uitvoeren?

Je kunt de stappen uit dit artikel zelf uitvoeren. Wil je het uitbesteden, dan bouw en beheer ik je website of software. Na oplevering is het werk van jou.

Gratis bedrijfsscan