Een API-koppeling laten bouwen die tegen de praktijk kan

De koppeling die "niet kan"

Soms is er geen kant-en-klare oplossing. Het systeem is maatwerk van jaren geleden, de leverancier levert alleen een export, of de partij aan de overkant verwerkt aanvragen in batches en antwoordt wanneer het uitkomt. De standaardtools haken af, en het werk blijft handwerk.

Voor ons is dit het gewone werk. Alles met een API, berichtenverkeer of een exportmogelijkheid is te koppelen; de vraag is nooit óf het kan, maar wat de betrouwbare route is.

Gebouwd op het lastige geval

Het verschil tussen een koppeling die werkt in de demo en één die werkt in productie, zit in de vervelende momenten. De partij aan de overkant is even onbereikbaar. Het antwoord komt niet na een seconde maar na drie dagen. Er komt een bericht binnen dat nergens in past.

Onze koppelingen zijn op die momenten gebouwd. Ze wachten netjes, raken niets kwijt en pakken de draad weer op zodra het antwoord er is. Wat niet automatisch verwerkt kan worden, komt bij een mens terecht in plaats van in een logbestand dat niemand leest. En elke uitvoering laat een verslag achter, zodat je achteraf precies kunt zien wat er is gebeurd.

Dezelfde eisen stellen we aan ons eigen werk: ons workflowplatform Supertaak is er juist op gebouwd dat integraties snel uit te breiden zijn en dat elke uitvoering verantwoord kan worden. Die lat leggen we ook bij jouw koppeling.

Typische gevallen

Een eigen applicatie die met een pakket moet praten. Twee bedrijfssystemen die na een fusie samen verder moeten. Een leverancier of overheidsloket dat aanvragen asynchroon verwerkt. Een oud systeem dat niemand meer durft aan te raken, maar waar de data wel uit moet. Orders, facturen, voorraad, documenten: de inhoud verschilt, de aanpak niet.

Veelgestelde vragen

Ons systeem heeft alleen een exportmogelijkheid, geen API. Kan er dan iets?

Ja. Een koppeling hoeft niet per se over een API te lopen: ook berichtenverkeer of een periodieke export is een bruikbare basis. We hebben alleen een manier nodig om gegevens uit het systeem te krijgen of erin te zetten; de betrouwbaarheid bouwen wij eromheen.

Het antwoord van onze partij komt soms pas na dagen. Werkt een koppeling dan?

Ja, dit is precies waar wij op zijn ingericht. Onze koppelingen wachten netjes, raken niets kwijt en pakken de draad weer op zodra het antwoord er is, of dat nu na een minuut of na drie dagen komt. Er blijft niets hangen in een mailbox of takenlijst.

Wat kost een maatwerk API-koppeling?

Ter indicatie: een koppeling met een gangbare API begint rond €500. Asynchrone of trage systemen, meerdere partijen of veel uitzonderingen: meestal tussen €1.500 en €5.000. Vooraf afgebakend, met een vaste prijs.

Hoe weet ik wat de koppeling heeft gedaan?

Elke uitvoering laat een verslag achter: wat er is verstuurd, wat er is ontvangen, en wat er met uitzonderingen is gebeurd. Bij vragen van een klant of accountant zoek je het op, in plaats van het te reconstrueren.

Verwant: de dienstpagina systemen koppelen, of terug naar alle koppelingen.

Welke koppeling kan bij jou "niet"?

Beschrijf de systemen en wat er tussen moet stromen. We zeggen binnen twee werkdagen wat de betrouwbare route is en wat die kost.