Wat is een API-koppeling?
Je webshop en je boekhouding zijn twee losse programma’s die niets van elkaar weten. Zonder koppeling typt iemand elke bestelling over. Met een API-koppeling haalt een klein programma de bestelling op bij de webshop en zet de gegevens in de boekhouding. Het programma spreekt met beide pakketten via hun API: de ingang die elk pakket aanbiedt voor andere software.
De koppeling is dus het werk dat gebouwd is rond die ingangen. De API is er al, de koppeling moet iemand maken.
Hoe werkt het?
Er zijn twee gangbare manieren. De koppeling kan op vaste tijden vragen of er iets nieuws is, bijvoorbeeld elk uur. Dat is eenvoudig en stabiel. Of het ene pakket geeft zelf een seintje wanneer er iets gebeurt, via een webhook. Dat is sneller, maar vraagt iets meer zorg bij de bouw, want wat gebeurt er als het seintje onderweg verloren gaat?
Om te bewijzen dat de koppeling in jouw account mag kijken, gebruikt hij een API-sleutel. Die werkt als een sleutelkaart: hij opent alleen de deuren die jij aanwijst en je kunt hem intrekken.
Wanneer is een koppeling de moeite waard?
Als je ziet dat iemand dezelfde gegevens in twee systemen invoert. Dat kost tijd, en elke keer overtikken is een kans op een fout. Reken eens uit hoeveel minuten het per week is, vermenigvuldig dat met je uurtarief en je weet wat het je nu kost. Hoe je dat uitrekent, staat in wat dubbel overtypen je kost.
Voor een eenvoudige koppeling met een paar stappen volstaat soms een dienst als Zapier. Bij veel regels, gevoelige gegevens of hoog volume is een eigen koppeling meestal betrouwbaarder, omdat je zelf bepaalt wat er gebeurt als iets misgaat.
In de praktijk
Als eerste vraag ik wat de bron van de waarheid is, nog voor we het over technologie hebben. Staat een klantadres in twee systemen, dan moet één van de twee leidend zijn. Anders overschrijven ze elkaar en heb je een nieuw probleem. Dat idee heet de single source of truth en het bepaalt meer van het ontwerp dan de techniek zelf.
Elke koppeling die ik bouw krijgt ook een logboek, zodat je kunt nakijken wat er wanneer is doorgegeven. Een koppeling die stilletjes faalt is erger dan geen koppeling.
Wil je alles weten over de achtergrond, lees dan Wat is een API-koppeling? Uitleg in gewone taal. Wil je weten wat ik voor je kan bouwen, kijk dan bij koppelingen tussen systemen.

