DigituraDigitura
Plan een gratis bedrijfsscanBel 06 27 56 83 59

Je krijgt mij aan de lijn, niet een helpdesk.

Software en koppelingen

API-koppeling: korte uitleg en voorbeelden

Kort gezegd

Een API-koppeling is een verbinding waarmee twee programma's automatisch gegevens aan elkaar doorgeven, zodat niemand ze hoeft over te typen.

Ook geschreven of gezegd als: koppeling, systeemkoppeling, integratie, software koppelen

Door Gerwin Kuijntjes, software-engineer ·

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.

Liever dat iemand meekijkt?

Ik laat je programma's elkaar bijwerken, zodat niemand nog gegevens overtypt.

Koppelingen tussen systemen

Veelgestelde vragen

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

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

Kost een API-koppeling veel onderhoud?

Een goed gebouwde koppeling vraagt weinig. Het onderhoud zit vooral in veranderingen bij de pakketten zelf: een leverancier past zijn API aan of stopt met een oude versie. Reken daarom op een paar keer per jaar controleren.

Wat als een pakket geen API heeft?

Dan is er vaak nog een export of import van bestanden waarmee een koppeling kan werken. Dat is minder elegant dan een echte API, maar het overtikken is dan ook weg.

Alle begrippen

Wil je dit laten uitzoeken?

Je kunt veel zelf nakijken. Wil je dat iemand het voor je regelt, dan doe ik dat. Na oplevering is het werk van jou.

Gratis bedrijfsscan