API

Hoe werkt een API?

Een veelgebruikte vergelijking is die van een ober in een restaurant. Jij (de applicatie) geeft je bestelling aan de ober (de API), die het doorgeeft aan de keuken (het andere systeem). De keuken bereidt het antwoord en de ober brengt het terug. Jij hoeft niet te weten hoe de keuken werkt, alleen wat je kunt bestellen.

Technisch werkt het zo: een applicatie stuurt een verzoek (request) naar de API van een ander systeem. De API verwerkt dat verzoek, haalt de gevraagde gegevens op of voert een actie uit, en stuurt een gestructureerd antwoord (response) terug. Dat antwoord is meestal opgemaakt in JSON of XML, zodat beide systemen het begrijpen ongeacht hun programmeertaal.

Een belangrijk onderscheid: een API is de toegangslaag tot de functies van een systeem, niet het systeem zelf. Veel uitleg gebruikt "bibliotheek" en "API" alsof ze hetzelfde zijn, maar de API is de deur naar de bibliotheek, niet de collectie erachter.

Welke soorten API's zijn er?

De meest voorkomende API's op het web zijn web-API's die via HTTP werken en in drie hoofdtypen voorkomen.

• REST (Representational State Transfer) is veruit het meest gebruikt. REST-API's werken met standaard HTTP-methoden (GET, POST, PUT, DELETE) en gebruiken vaak JSON als dataformaat. De meeste koppelingen die je als ondernemer tegenkomt, zoals betalingssystemen of e-mailtools, draaien op REST.
• SOAP (Simple Object Access Protocol) is een ouder, strikter protocol dat XML gebruikt. Het komt nog veel voor bij banken, overheden en verzekeraars waar beveiliging en standaardisatie prioriteit hebben.
• RPC (Remote Procedure Call) laat een applicatie een functie op een ander systeem aanroepen alsof het een lokale functie is.

In onderstaande tabel staan de drie hoofdtypen naast elkaar.

Wat is een API-koppeling?

Een API-koppeling is een concrete verbinding tussen twee systemen die via een API automatisch gegevens uitwisselen. Denk aan je webshop die via een API-koppeling bestellingen doorstuurt naar je boekhoudsoftware, of je CRM dat nieuwe leads automatisch ontvangt vanuit een contactformulier. Het verschil: de API is het mechanisme, de koppeling is de toepassing ervan.

Voor MKB-ondernemers zijn API-koppelingen de motor achter procesautomatisering. Tools als n8n, Make en Zapier maken het mogelijk om API-koppelingen in te richten zonder zelf code te schrijven. Wil je weten wat API-koppelingen voor jouw bedrijf kunnen betekenen? Bekijk onze dienst voor API-koppelingen of lees meer over AI-automatisering.