Een API-koppeling laat twee systemen automatisch gegevens uitwisselen, zonder dat iemand iets overtypt. Het ene systeem stuurt een verzoek naar een vast adres van het andere systeem (een endpoint), bewijst wie het is met een sleutel of token, en krijgt gestructureerde data terug, meestal in JSON. Voor een MKB-bedrijf betekent dat bijvoorbeeld: een webformulier dat direct een lead in het CRM zet, of een webshop die bestellingen naar het boekhoudpakket stuurt.
Hoe een API-koppeling werkt: endpoint en authenticatie
Een API (application programming interface) is de set afspraken waarmee een systeem zijn functies voor andere software openstelt: welke endpoints er zijn, welke parameters ze accepteren en wat ze teruggeven.
- Endpoint: een URL plus HTTP-methode, zoals
GET /wp-json/wp/v2/postsin de WordPress REST API. - Authenticatie: een API-sleutel, een OAuth-token of, bij WordPress, een applicatiewachtwoord met Basic Auth over HTTPS.
- Autorisatie: wat die sleutel mag. Geef een koppeling alleen de rechten die hij nodig heeft.
curl -u 'koppeling:xxxx xxxx xxxx xxxx xxxx xxxx' \
https://www.domein.nl/wp-json/wp/v2/posts?per_page=5REST, webhooks en polling
|
Mechanisme |
Hoe het werkt |
Wanneer |
|---|---|---|
|
REST-verzoek |
Systeem A vraagt data op of stuurt data naar B |
Op een moment dat A bepaalt, bijv. bij een formulierinzending |
|
Webhook |
Systeem B stuurt zelf een bericht naar een URL van A als er iets gebeurt |
Direct reageren op een gebeurtenis, bijv. betaling geslaagd |
|
Polling |
A vraagt periodiek aan B of er iets nieuws is |
Als B geen webhooks ondersteunt |
Webhooks zijn efficiënter dan polling, maar je moet de ontvangende URL beveiligen: controleer een handtekening of geheim in de header, zodat niet iedereen berichten kan sturen.
Schema dat het verschil laat zien tussen een REST-verzoek, een webhook en polling bij een API-koppeling.
Voorbeelden uit het MKB
- CRM: een ingevuld offerteformulier wordt direct een lead met bron en campagne in je CRM.
- Boekhouding: een betaalde bestelling in WooCommerce wordt een verkoopfactuur in je boekhoudpakket.
- Voorraad: een voorraadsysteem werkt de beschikbaarheid in je webshop bij, zodat je niet verkoopt wat er niet is.
- Formulieren en e-mail: een nieuwsbriefinschrijving gaat direct naar je e-mailmarketingtool, met consent-vlag.
- Planning: een online boeking verschijnt in de agenda van de juiste medewerker.
Veel van dit soort koppelingen bouw je in WordPress met een plugin. Waar geen plugin bestaat, of waar je eigen logica nodig hebt, wordt het maatwerk. Zie WordPress API-integratie.
Wat een koppeling kost en wie hem onderhoudt
De bouwkosten hangen af van de kwaliteit van de API-documentatie, het aantal gegevenstypen, de mapping tussen velden en de foutafhandeling. Een koppeling is daarna nooit klaar: API's krijgen nieuwe versies, velden veranderen en tokens verlopen. Spreek dus af wie de koppeling bewaakt, wie een melding krijgt als hij faalt en wie hem aanpast bij een nieuwe API-versie.
Risico's: rate limits, versiewijzigingen en foutafhandeling
- Rate limits: veel API's beperken het aantal verzoeken per tijdseenheid en geven dan een
429 Too Many Requests. Bouw een wachtrij met herhaalpogingen in plaats van alles tegelijk te versturen. - Versiewijzigingen: leveranciers zetten oude API-versies uit. Gebruik een vaste versie in je verzoeken en volg de aankondigingen.
- Foutafhandeling: een verlopen token geeft een
401. Zonder logging en melding merk je pas weken later dat er geen leads meer in je CRM komen. - Sleutels: zet API-sleutels nooit in front-endcode of in een repository. Bewaar ze op de server, bijvoorbeeld als omgevingsvariabele.
Een koppeling die stil faalt, is erger dan geen koppeling. Logging en een melding bij fouten zijn daarom geen extra's, maar onderdeel van de bouw. Voor grotere systemen, zie een webapplicatie laten maken.
Klaar voor actie?
Wil je dit toepassen op jouw website?
Ik help je de keuzes uit dit artikel om te zetten in een werkende setup, meetbaar en zonder technische ruis.