API-koppeling laten maken

Wat is een API-koppeling?

Die API is de deur die een systeem daarvoor openzet. De meeste pakketten hebben zo'n deur: AFAS, Exact, en zo ongeveer elke betaaldienst, planningstool en webshop. Wat verschilt, is hoe ver die deur opengaat. Het ene systeem laat alles toe, het andere geeft precies drie dingen mee en verder niets. Dat zoeken we uit voordat we iets beloven.

Of een API-koppeling wat waard is, hangt niet af van het lijntje maar van wat er misgaat. Een leverancier verandert iets aan zijn kant. Een sleutel verloopt. Een bestand heeft opeens een andere vorm. Een koppeling die daar niets mee doet, valt op een dinsdag stil zonder dat iemand het merkt.

Wat een API-koppeling je scheelt

Een koppeling is nooit het doel. Het doel is dat niemand meer zit over te typen, en dat wat je klant op de site ziet ook echt klopt. Dit zijn de vier dingen die je als eerste terugkrijgt.

Niets meer twee keer intypen: Wat op je site binnenkomt, staat meteen in je systeem. Dat scheelt tijd, maar vooral fouten. Eén cijfer verkeerd in een adres of een artikelnummer, en je pallet staat voor de verkeerde deur.

Kloppende cijfers, ook 's nachts: Prijzen, voorraad en de stand van een bestelling komen rechtstreeks uit de bron. Je klant ziet nooit een aantal dat vanochtend nog klopte, en jij hoeft geen tweede lijstje bij te houden.

Je kunt terugzien wat er gebeurd is: Elk berichtje tussen de twee systemen wordt opgeschreven: wat eruit ging en wat er terugkwam. Klopt er iets niet, dan kijk je in dat logboek in plaats van met z'n drieën te gaan gissen.

De tweede koppeling is zo gelegd: Een API-koppeling die goed ligt is het begin van de volgende. Wie zijn boekhoudpakket eenmaal open heeft staan, knoopt daarna zijn webshop of klantportaal er voor een fractie van het werk aan vast.

Voor wie is dit

Een API-koppeling wordt interessant zodra hetzelfde gegeven op twee plekken wordt bijgehouden. Herken je dit?

• Iemand haalt elke week een bestand uit het ene systeem en propt het in het andere
• De voorraad op je site loopt achter op wat er echt in het magazijn ligt
• Bestellingen worden met de hand ingeklopt in je boekhouding
• Je hebt een koppeling die af en toe stilvalt, en je hoort het van een klant
• Je wil een nieuw pakket kopen en weet niet of het met je huidige systemen kan praten

Wat je krijgt

• Een verbinding met een eigen sleutel, die alleen mag wat hij echt moet mogen
• Een vertaling tussen de twee systemen, want geen twee pakketten noemen hetzelfde veld hetzelfde
• Vanzelf opnieuw proberen, zodat een systeem dat even hikt je geen bestelling kost
• Een logboek van elk bericht, doorzoekbaar op datum en op ordernummer
• Een seintje zodra de koppeling stilvalt, zodat jij het merkt voordat je klant het merkt
• Een oefenopstelling die tegen de testomgeving van de andere partij praat

Hoe we het bouwen

Eerst uitzoeken. We lezen de handleiding van de andere partij en proberen het uit in hun testomgeving. Welke gegevens zitten er echt in, hoe vaak mag je iets opvragen, en wat kan er gewoon niet. Die eerste week bepaalt of de rest soepel loopt.

Dan ophalen. We bouwen eerst het ophalen. Gegevens binnenhalen en tonen is te overzien, en het levert al iets op terwijl de rest nog getest wordt.

Dan terugschrijven. Pas als het ophalen klopt, zetten we ook gegevens terug, met controles en dat logboek eromheen. Een API-koppeling die iets verkeerds in je boekhouding zet, is vervelender dan een scherm dat nog niet af is.

Wat kost een API-koppeling?

Wat een API-koppeling kost wordt bepaald door de andere kant. Alleen gegevens ophalen bij een pakket met een nette handleiding: onderkant. Verkeer in twee richtingen met een pakket zonder testomgeving: bovenkant.

De prijs wordt vooral bepaald door de andere partij, niet door ons. Een modern systeem met goede uitleg kost een fractie van een systeem waar je elke nacht een bestand van een server moet plukken. Dat verschil zoeken we uit voordat we een bedrag noemen.

Daarna loopt er onderhoud door, want systemen veranderen. Dat gaat om bewaking en het bijwerken van wat de leverancier aan zijn kant verandert.

Waarom Mediavisie Web

Koppelingen doen we sinds 2008, met pakketten als AFAS en Exact en de voorraad- en planningssystemen die daaromheen hangen. Dat levert kennis op die in geen enkele handleiding staat. Welk pakket zijn datums een uur verschoven teruggeeft, bijvoorbeeld. Of welk systeem zonder te klagen stopt bij duizend regels.

We leggen niet alleen het lijntje, we bouwen ook alles eromheen. Het logboek, het vanzelf opnieuw proberen en het seintje bij stilstand zitten er standaard in. Een API-koppeling zonder die drie is een koppeling die op een dag stilstaat.

En we repareren regelmatig koppelingen van anderen. Dat helpt bij het inschatten van wat je in huis hebt, ook als je ons alleen om een tweede mening vraagt.