Wat is een API?
De afgesproken deur waarlangs twee programma’s gegevens uitwisselen zonder menselijke tussenkomst.
Een API laat software met software praten
Wie over koppelingen spreekt, hoort al snel het woord API. De afkorting staat voor application programming interface, maar die vertaling helpt weinig. Eenvoudig gezegd is het een toegang die een programma openzet voor andere programma’s, met vaste regels over wat er gevraagd en aangeleverd mag worden. Hier leest u hoe dat werkt, waarom het ertoe doet en welke vragen u een softwareleverancier best stelt.
Het loket van een softwarepakket
Stel u een programma voor als een kantoor. Medewerkers komen binnen langs de voordeur: de schermen. Andere programma’s gebruiken een loket aan de zijkant: de API. Aan dat loket gelden strikte formulieren. Een webshop vraagt bijvoorbeeld de voorraad van een artikel op en krijgt een getal terug, of levert een nieuwe bestelling af in een vast formaat. Het loket controleert wie er aanklopt en wat die mag. Het andere programma hoeft niet te weten hoe het kantoor vanbinnen werkt. Het moet alleen de formulieren kennen, en die staan beschreven in de documentatie.
Waarom dit voor een zaakvoerder telt
Zonder API blijven er twee manieren over om gegevens van het ene systeem naar het andere te krijgen: overtypen, of bestanden exporteren en weer inlezen. Beide zijn traag en foutgevoelig. Met een API kan een order uit de webshop vanzelf in het ordersysteem belanden, een betaalde factuur de klantenfiche bijwerken of een werkbon uit een app een factuurvoorstel aanmaken. Software zonder degelijke API sluit u op: u kunt er alleen mee werken via de schermen. Daarom is de vraag of er een API bestaat even belangrijk als de vraag wat het pakket kan.
Niet elke API is even bruikbaar
Dat een leverancier een API vermeldt, zegt weinig over de kwaliteit. Sommige laten alleen lezen toe en niet schrijven. Andere dekken slechts een deel van de gegevens, zodat net het veld dat u nodig hebt ontbreekt. Er kunnen beperkingen gelden op het aantal aanvragen, of de toegang zit in een duurdere formule. Ook documentatie verschilt sterk in volledigheid. En een API kan wijzigen: wanneer de leverancier een nieuwe versie uitbrengt, moet de koppeling mee aangepast worden. Een koppeling is dus nooit helemaal af. Ze vraagt opvolging.
Wat er komt kijken bij een koppeling
De API is de deur, de koppeling is het verkeer dat erdoor gaat. Iemand moet bepalen welke gegevens wanneer verstuurd worden, hoe velden van het ene systeem vertaald worden naar het andere en wat er gebeurt als iets misloopt. Wat als de webshop een klant doorstuurt die al bestaat? Wat als het andere systeem even onbereikbaar is? Een degelijke koppeling probeert opnieuw, houdt een logboek bij en verwittigt iemand wanneer een bericht blijft hangen. Net dat stuk, de foutafhandeling, onderscheidt een koppeling die jaren meegaat van één die geregeld stilvalt.
Kort samengevat
- 01Een API is een vaste toegang waarlangs programma’s gegevens opvragen en aanleveren.
- 02Software zonder bruikbare API dwingt u tot overtypen of bestanden heen en weer sturen.
- 03Vraag na welke gegevens de API ontsluit en of schrijven ook mogelijk is.
- 04Een koppeling heeft foutafhandeling, een logboek en opvolging nodig om betrouwbaar te blijven.
Drie vaste afspraken
- U kiest waar het draaitZelf hosten op uw eigen server of in een private cloud. Uw gegevens blijven onder uw controle, niet op een gedeeld platform.
- Maatwerk is niet duurderSoftware op maat kost bij ons niet meer dan standaardsoftware. Geen licentie per gebruiker, en u betaalt niet voor functies die u nooit opent.
- U bent baas over het eindproductWat we bouwen, is van u. U beslist wat er verandert en wanneer, zonder te wachten op de planning van een softwareleverancier.
Is uw bedrijf toe aan betere software?
Vijf vragen, één minuut. U krijgt meteen een eerlijk beeld, ook als het antwoord is dat u goed zit.
Uw basis zit goed.
Uw systemen doen wat ze moeten doen. Grote ingrepen zijn nu niet nodig. Eén gerichte verbetering of koppeling kan wel nog tijd opleveren: leg ze ons gerust voor.
Er lekt tijd weg.
U werkt, maar met omwegen: overtypen, zoeken, nakijken. Dat zijn precies de plekken waar een koppeling of een stuk software op maat het snelst iets oplevert. Laten we samen bekijken waar te beginnen.
Uw software houdt u tegen.
Uw bedrijf is zijn hulpmiddelen ontgroeid. Dat kost elke dag tijd en maakt u afhankelijk van enkele mensen. Een korte analyse toont waar de grootste winst zit en in welke volgorde u het aanpakt.
Veelgestelde vragen
Hoe weet ik of mijn huidige software een API heeft?
Zoek op de website van de leverancier naar termen als API, integraties of ontwikkelaarsdocumentatie, of stel de vraag rechtstreeks aan de helpdesk. Vraag meteen welke gegevens beschikbaar zijn en of de toegang in uw formule zit. Bestaat er geen API, dan zijn er soms omwegen via exportbestanden of de onderliggende databank. Bij maatwerk stelt die vraag zich niet: de toepassing is van u, dus u kiest zelf wat de API openstelt.
Is gegevens uitwisselen via een API veilig?
Een goed opgezette API werkt met versleutelde verbindingen en met sleutels die bepalen wie wat mag. De veiligheid hangt daarna af van hoe die sleutels bewaard worden en hoe ruim de rechten zijn. Geef een koppeling alleen toegang tot wat ze nodig heeft, en trek sleutels in zodra een koppeling niet meer gebruikt wordt.
Kunnen twee programma’s gekoppeld worden als er maar één een API heeft?
Vaak wel. Het programma zonder API kan soms bestanden in- en uitvoeren, of zijn databank is rechtstreeks benaderbaar. Een tussenlaag vertaalt dan tussen beide werelden. Zulke oplossingen zijn wel kwetsbaarder bij updates en vragen extra controle. Soms is vervanging van het oude programma op termijn de verstandigste keuze.