Uitleg · API-koppeling

Wat is een API-koppeling?

Een API-koppeling laat twee softwaresystemen automatisch gegevens uitwisselen, zodat niemand ze hoeft over te typen. Een order uit je webshop komt vanzelf in je boekhouding, een aanvraag van je website staat direct in je CRM. Hieronder lees je wat API betekent, hoe zo’n koppeling werkt en wanneer je er een nodig hebt.

Door Sina Sadegh Esfahani · Praktijkpagina van OmniTechs, Resedastraat 39 in Groningen; bedragen volgen de gepubliceerde prijzen · Beoordeeld op .

In het kort

API staat voor Application Programming Interface: een afgesproken ingang waarlangs software gegevens kan opvragen of versturen. Een API-koppeling gebruikt de ingangen van twee systemen om gegevens van het ene naar het andere te brengen, volgens regels die je vooraf afspreekt: welke gegevens, in welke richting, hoe vaak en wat er gebeurt bij een fout.

  • Geen overtypen tussen systemen
  • Minder fouten en dubbele gegevens
  • Gegevens zijn sneller bijgewerkt
  • Werkt alleen als beide systemen een bruikbare API hebben

Voorbeelden van API-koppelingen

Veelvoorkomende koppelingen tussen systemen
VanNaarWat er automatisch gebeurt
Webshop (Shopify, WooCommerce)Boekhouding (Exact Online, Moneybird)Elke order wordt een verkoopboeking met de juiste btw
Contactformulier op je websiteCRMEen aanvraag staat direct als lead in je CRM, met de bron erbij
CRMBoekhoudingEen gewonnen deal wordt een klant en een factuur
Planning of werkbon-appBoekhoudingAfgeronde werkbonnen worden facturen
BoekhoudingKlantportaalKlanten zien hun facturen en betalingen zelf

API, webhook of export?

Drie manieren om gegevens tussen systemen uit te wisselen
ManierHoe het werktWanneer
API opvragenHet ene systeem vraagt op een vast moment aan het andere: is er iets nieuws?Gegevens hoeven niet direct over, of het systeem kan zelf niets melden
WebhookHet systeem waar iets gebeurt, stuurt direct een bericht naar het andereEen order of aanvraag moet meteen verwerkt worden
Export en importIemand downloadt een bestand en leest het in het andere systeem inHet gebeurt zelden, of een systeem heeft geen API

Hoe een API-koppeling werkt

Een systeem stuurt een verzoek naar de API van een ander systeem, bijvoorbeeld ‘geef de orders van vandaag’ of ‘maak deze klant aan’. Het andere systeem antwoordt met de gegevens, meestal in het formaat JSON: tekst met vaste veldnamen zoals naam, e-mailadres en bedrag. De koppeling zet de velden van het ene systeem om naar die van het andere, want een ‘klant’ in je webshop heet in je boekhouding vaak ‘relatie’ of ‘debiteur’.

Een goede koppeling legt ook vast wat er gebeurt als iets misgaat: een systeem is even niet bereikbaar, een veld ontbreekt of een klant bestaat al. Dan probeert hij het opnieuw of meldt hij het aan iemand die het kan oplossen.

Hoe kom je aan een API-key?

Een API-key of token is de sleutel waarmee een koppeling namens jou toegang krijgt tot een systeem. Je maakt hem meestal aan in de instellingen van het systeem zelf, bij een onderdeel als ‘API’, ‘Ontwikkelaars’ of ‘Koppelingen’. Bij WooCommerce staat het onder Instellingen, Geavanceerd, REST API. Sommige systemen, zoals Exact Online, werken in plaats daarvan met een app-registratie en een inlogscherm waarin je toestemming geeft.

Deel een API-key alleen met wie de koppeling bouwt, en geef hem niet meer rechten dan nodig: een koppeling die alleen orders leest, hoeft geen klanten te kunnen verwijderen.

Wat is een WordPress API-koppeling?

WordPress heeft een ingebouwde REST API waarmee andere systemen berichten, pagina’s en, met WooCommerce, producten en orders kunnen lezen of aanmaken. Een WordPress-koppeling verbindt je website zo met bijvoorbeeld je voorraad, je CRM of je boekhouding, zonder dat iemand gegevens overneemt.

Wanneer heb je een API-koppeling nodig?

Als iemand in je team elke dag of week dezelfde gegevens van het ene systeem in het andere zet. Als er fouten ontstaan omdat gegevens op twee plekken staan. Of als klanten moeten wachten tot iemand iets heeft overgenomen. Bestaat er al een kant-en-klare koppeling in de app-winkel van je pakket, kijk dan eerst of die volstaat: dat is vaak goedkoper dan maatwerk.

Wat kost een API-koppeling?

Bij OmniTechs begint een koppeling tussen twee systemen met een gedocumenteerde API vanaf €1.500 eenmalig excl. btw (indicatie van de calculator). Is een van de systemen lastig te koppelen, dan begint het met een Solution Sprint van €1.250 excl. btw, waarna de prijs vast is.

Een goede koppeling

  • Doet één afgesproken ding: welke gegevens, welke richting, hoe vaak
  • Gebruikt een API-key met alleen de rechten die nodig zijn
  • Probeert het opnieuw als een systeem even niet bereikbaar is
  • Meldt fouten aan iemand die ze begrijpt
  • Is beschreven, zodat ook een ander hem kan beheren

Veelgestelde vragen

Wat betekent API?

Application Programming Interface: een afgesproken ingang waarlangs software gegevens opvraagt of verstuurt, zonder dat iemand een scherm gebruikt.

Hoe kom ik aan een API-key?

Meestal in de instellingen van het systeem zelf, bij ‘API’, ‘Ontwikkelaars’ of ‘Koppelingen’. Bij WooCommerce onder Instellingen, Geavanceerd, REST API. Systemen zoals Exact Online gebruiken een app-registratie met een toestemmingsscherm.

Wat is het verschil tussen een API en een webhook?

Bij een API vraagt het ene systeem actief om gegevens. Bij een webhook stuurt het systeem waar iets gebeurt zelf een bericht zodra er iets verandert, bijvoorbeeld bij een nieuwe order.

Wat is een WordPress API-koppeling?

Een koppeling die de ingebouwde REST API van WordPress gebruikt om berichten, pagina’s of WooCommerce-producten en -orders uit te wisselen met andere systemen.

Wat kost een API-koppeling?

Bij OmniTechs vanaf €1.500 eenmalig excl. btw voor een koppeling tussen twee systemen met een gedocumenteerde API (indicatie). Bij onzekerheid eerst een Solution Sprint van €1.250 excl. btw.

Welke systemen wil je koppelen?

Stuur de namen van je systemen en welke gegevens nu worden overgetypt. Je hoort wat een koppeling kost en of er al een kant-en-klare oplossing bestaat.