Riotbyte

Een API koppeling laten maken zonder dat het een project wordt

Twee systemen die elkaar niet kennen, en iemand ertussen die data overtikt. Een API koppeling haalt dat werk weg, maar de drempel is vaak het probleem: voor één koppeling wil je geen traject van maanden. Riotbyte bouwt koppelingen tussen de systemen die je al gebruikt, en begint klein als dat kan.

Maak kennis met je toekomstige tech-team
Onze klanten

Waarom koppelingen blijven liggen terwijl iedereen ze wil

  • De koppeling kost meer dan hij oplost

    Dit is de reden die we het vaakst horen. Je weet precies welke twee systemen moeten praten, je weet wat het je oplevert, maar een offerte voor eenmalig maatwerk staat niet in verhouding tot het probleem. Dus blijft iemand het handmatig doen, en blijft de koppeling op de wensenlijst staan.

  • Niemand weet wat er aan de andere kant mogelijk is

    Je eigen systeem ken je. Dat andere systeem is van een leverancier, en wat daar kan hangt af van documentatie die je niet hebt, een API die je niet kunt inzien, of een accountmanager die het antwoord moet opzoeken. Zonder dat antwoord kun je niet beginnen en kan niemand een inschatting maken.

  • Eén handmatige stap houdt het hele proces tegen

    Een proces is zo snel als zijn traagste schakel. Als orders automatisch binnenkomen maar iemand ze met de hand in de boekhouding zet, schaalt het geheel niet. Die ene stap bepaalt hoeveel werk erbij kan voordat je iemand moet aannemen.

Hoe wij een API koppeling bouwen

  • Eerst uitzoeken wat er aan beide kanten echt kan

    Voordat we iets bouwen zoeken we uit wat beide systemen toelaten. Welke data is beschikbaar, in welke vorm, hoe vaak, en wat gebeurt er bij een wijziging. Dat is zelden een technische vraag en vaak een kwestie van de juiste documentatie of de juiste persoon bij de leverancier te pakken krijgen. Uit dat antwoord volgt wat de koppeling kan worden.

  • De juiste vorm kiezen, niet de snelste

    Een koppeling kan data ophalen op vaste momenten of direct reageren op een wijziging. Dat eerste is simpeler, het tweede is actueler. Welke je kiest hangt af van hoe vers de data moet zijn en wat het systeem aan de andere kant aankan. Bij een koppeling met Exact Online werken we bijvoorbeeld met een lokale catalogus voor stamdata, zodat Exact niet voor elke vraag live bevraagd wordt, terwijl wijzigingen wel direct terugkomen.

  • Bouwen zodat het blijft draaien als er iets verandert

    APIs veranderen, leveranciers doen updates, en soms ligt er iets plat. Een koppeling die daar niet tegen kan, is een koppeling die je over een half jaar opnieuw moet laten maken. We bouwen met het uitgangspunt dat er iets misgaat: berichten die in een wachtrij blijven staan in plaats van verdwijnen, en opnieuw proberen zonder dat dingen dubbel landen.

  • Jij wordt eigenaar van de koppeling

    Na oplevering is de koppeling van jou. Code, documentatie, toegang. Dat is geen principekwestie maar praktisch: bij een koppeling tussen jouw specifieke systemen hebben wij er zelf weinig aan, en jij moet er jaren mee verder kunnen. Of wij het onderhoud doen is daarna een keuze, geen noodzaak.

Het lastigste aan een koppeling is zelden de techniek

Als een koppeling uitloopt, ligt dat bijna nooit aan de code. Het ligt aan documentatie die niet klopt of niet bestaat, aan een leverancier die eerst intern moet goedkeuren dat er data naar buiten mag, of aan een systeem waar maar n persoon iets van weet en die persoon heeft het druk.

Dat is geen detail, dat is het echte werk. Wij plannen er daarom op. We beginnen met uitzoeken wat er aan de andere kant mogelijk is voordat we een inschatting geven, en we zorgen dat de gesprekken met die derde partij op tijd lopen. Een koppeling die technisch in twee weken te bouwen is kan drie maanden duren omdat iemand anders een vinkje moet zetten. Dat weten we, en daar sturen we op.

Waarom wij Zapier, Make en n8n meestal afraden

Er bestaan tools die beloven dat je elk systeem aan elk ander systeem knoopt zonder code. Voor een simpele actie werken ze prima, en als dat je vraag is moet je ze zeker gebruiken.

Maar bij bedrijfskritische data lopen ze in onze ervaring altijd tegen dezelfde grens aan. Een one size fits all oplossing werkt tot aan de drempel, en daarna niet meer. Je loopt vast op volume, op een veld dat net anders moet, op foutafhandeling die je niet kunt inregelen, of op kosten die meelopen met je groei. Op dat moment moet je alsnog bouwen, maar dan met een proces dat er al van afhankelijk is.

Ons advies is dan ook: bouw of koop een specifieke koppeling voor wat echt belangrijk is. Gebruik de generieke tools voor wat dat niet is.

Klantverhaal · Volkswagen

Het bestaande proces tussen de fabrikant en het dealernetwerk stuurde elke paar minuten de complete historie opnieuw door, zonder te weten wat al gesynct was. Informatie vanuit de fabrikant kwam niet terug, en wat binnenkwam matchte vaak niet met de bestaande registratie. Wij hebben dat vervangen door een realtime koppeling waarbij alleen wijzigingen doorstromen, in beide richtingen. De pilot draait live bij de eerste dealer en de softwareleverancier rolt de rest zelf uit, zonder afhankelijkheid van ons.

Lees de volledige case

Zo verloopt een koppelingstraject

  1. Je vraag, niet eerst een traject

    Weet je al welke twee systemen moeten praten? Dan hoeft daar geen discovery van twee weken voor. We zoeken uit wat er mogelijk is en wat het kost.

  2. Uitzoeken aan beide kanten

    Documentatie, toegang, en waar nodig contact met de leverancier van het andere systeem. Dit bepaalt de doorlooptijd meer dan het bouwen zelf. Loopt dit uit, dan weet je dat vroeg.

  3. Bouwen en live

    We bouwen de koppeling, testen hem met echte data en zetten hem live. Je ziet hem werken voordat alles af is.

  4. Overdracht

    Je krijgt de code, de documentatie en de toegang. Onderhoud bij ons is een keuze, geen afhankelijkheid.

Veelgestelde vragen over API koppelingen

  • Wat is een API koppeling?

    Een API koppeling laat twee systemen rechtstreeks met elkaar praten, zonder dat iemand data overtikt. Het ene systeem stelt gegevens beschikbaar via een API, het andere haalt ze op of krijgt ze toegestuurd zodra er iets verandert. Denk aan orders uit je webshop die automatisch in je boekhouding belanden, of voorraad die op beide plekken klopt.

  • Wat kost een API koppeling?

    Dat hangt vooral af van wat er aan de andere kant mogelijk is. Een koppeling met een systeem dat een goede, gedocumenteerde API heeft is een kwestie van dagen. Een systeem zonder documentatie waarbij de leverancier moet meewerken kan weken kosten, waarvan het meeste geen bouwtijd is. We zoeken dat eerst uit en geven daarna pas een inschatting.

  • Met welke systemen kunnen jullie koppelen?

    We bouwen koppelingen met onder andere Exact Online, Shopify, WooCommerce, Magento, PostNL, DPD en interne applicaties. Als een systeem een API heeft, is een koppeling vrijwel altijd mogelijk. De vraag is niet zozeer of het kan, maar wat het systeem aan de andere kant toelaat.

  • Wat als een systeem geen API heeft?

    Dan kijken we naar alternatieven. Bestandsuitwisseling via SFTP werkt nog steeds, al is het niet meer van deze tijd. Soms is een tussenlaag de oplossing. Wat we zelden doen is scrapen: dat is technisch mogelijk maar juridisch grijs gebied en vaak in strijd met de voorwaarden van de leverancier.

  • Hoe lang duurt het bouwen van een koppeling?

    Het bouwen zelf is meestal het kortste deel. Wat de doorlooptijd bepaalt is hoe snel we antwoord krijgen op wat er aan de andere kant mogelijk is. Bij een systeem met goede documentatie gaat dat snel. Moet er een engineer van de leverancier aanschuiven, dan loopt het op.

  • Blijft de koppeling werken als de leverancier iets verandert?

    Daar bouwen we op. Berichten blijven in een wachtrij staan in plaats van verloren te gaan, en we proberen opnieuw zonder dat dingen dubbel landen. Gaat er aan de andere kant iets structureel om, dan is aanpassing nodig. Omdat je eigenaar bent van de code kun je dat door ons laten doen of door iemand anders.

Eerlijk: wanneer wij niet de juiste keuze zijn

Liever vooraf nee dan halverwege uit elkaar. We werken het best met opdrachtgevers die ruimte laten om mee te sturen op de richting, niet alleen op de uitvoering. Herken je dit niet, dan zijn wij waarschijnlijk niet de juiste partij.

  1. 01Wanneer een bestaande plug-in het gewoon doet. Voor veel standaardcombinaties bestaat al een kant-en-klare koppeling. Als die past, gebruik hem. Maatwerk is pas interessant als je merkt dat je eromheen moet werken.Wanneer de koppeling de investering niet waard is. Soms kost het meer dan het bespaart. We rekenen dat liever vooraf met je door dan dat je er achteraf achterkomt.
  2. 02Wanneer de koppeling de investering niet waard is. Soms kost het meer dan het bespaart. We rekenen dat liever vooraf met je door dan dat je er achteraf achterkomt.
  3. 03Wanneer je een vaste prijs wilt voordat we weten wat er aan de andere kant kan. Juist bij koppelingen zit de onzekerheid buiten ons. We zoeken dat eerst uit, daarna weten we allebei waar we aan beginnen.
  4. 04Wanneer je een platform zoekt waarmee je zelf tientallen koppelingen gaat beheren. Dan heb je geen development partner nodig maar een integratieplatform. Dat is een ander product dan wat wij doen.

Vertel ons wat je bouwt

Geen pitch decks nodig. Een paar zinnen over je project is genoeg om een gesprek te starten.

Plan direct een 30-min kennismaking

Liever direct een founder mailen? Daniël · Maarten · Niels

Liever algemeen mailen? [email protected]