Wat is een API (API-koppeling)?

Kort gezegd

Een API (application programming interface) is een vaste afspraak waarmee software gegevens of functies beschikbaar stelt aan andere software. Met een API-koppeling sturen twee systemen elkaar automatisch gegevens, bijvoorbeeld orders van je webshop naar je boekhouding.

Hoe werkt een API?

Een API is een soort loket: het ene programma stelt een vraag in een afgesproken vorm, het andere geeft antwoord. De meeste webapplicaties hebben een REST-API: een programma stuurt een verzoek via internet naar een adres, bijvoorbeeld om alle nieuwe orders op te halen, en krijgt de gegevens terug in een leesbaar formaat als JSON. De documentatie beschrijft welke vragen kunnen; veel leveranciers gebruiken daarvoor de OpenAPI-specificatie.

Voorbeelden van API-koppelingen:

  • orders uit de webshop gaan als factuur naar de boekhouding;
  • een nieuwe klant in het CRM wordt automatisch aangemaakt in het facturatieprogramma;
  • je boekhoudprogramma haalt banktransacties op via de API van de bank (zie PSD2).

Kant-en-klare koppeling of eigen koppeling?

Veel pakketten bieden standaardkoppelingen met bekende software: die zet je met een paar klikken aan. Ontbreekt die, dan kan een ontwikkelaar een koppeling bouwen op beide API's, of gebruik je integratiesoftware die pakketten zonder programmeren verbindt. Tussen handelspartners worden orders en facturen vaak via EDI uitgewisseld.

Waar let je op?

  • Is de API openbaar gedocumenteerd, en zit hij in jouw abonnement of kost hij extra?
  • Welke gegevens kun je lezen en schrijven, en hoeveel verzoeken per minuut zijn toegestaan?
  • Wie beheert de koppeling, en wie merkt het als hij stopt met werken?

Welke software helpt hierbij?

Bestaat er geen kant-en-klare koppeling tussen twee pakketten, dan verbindt integratiesoftware ze via hun API's. Vraag bij elk pakket of de API openbaar gedocumenteerd is en of er extra kosten aan zitten.

Vergelijken in de categorie

Integratie software

Met onder meer LemonForce Studio, Combidesk en Power BI Connector.

Verwante begrippen

Bronnen

  1. OpenAPI Initiative
  2. Developer Overheid: API's van de Nederlandse overheid