API-koppeling laten maken

API-koppelingen die blijven werken, ook als er iets misgaat

Twee systemen koppelen is makkelijk op een goede dag. Het echte werk zit in de slechte dagen: verlopen tokens, rate limits, dubbele webhooks en een API die zonder waarschuwing verandert. Wij bouwden en onderhouden koppelingen met Stripe, Moneybird, Instagram, YouTube, X, TikTok, Etsy, Printful, Gmail, OpenAI en meer, allemaal in gebruik in onze eigen producten.

  • OAuth, API-sleutels en webhooks veilig afgehandeld
  • Retries, idempotency en dubbele berichten opgevangen
  • Monitoring die alarm slaat voordat klanten iets merken

Zo ziet een betrouwbare koppeling eruit

  1. Authenticeren

    OAuth met tokens die ververst worden voordat ze verlopen, of API-sleutels in versleutelde credentials.

    • OAuth 2.0
    • PKCE
    • API-sleutels
  2. Synchroniseren

    Achtergrondtaken halen en sturen data volgens een schema dat past bij de rate limits van elke API.

  3. Webhooks ontvangen

    Handtekeningen gecontroleerd en events ontdubbeld, zodat een event dat twee keer binnenkomt één keer verwerkt wordt.

  4. Herstellen

    Retries met een oplopende wachttijd, row locks tegen race conditions en een duidelijke foutmelding als er een mens nodig is.

  5. Monitoren

    Foutmonitoring en alerts als het slagingspercentage daalt, zodat problemen opvallen voordat klanten ze merken.

Het patroon achter elke koppeling die we draaien.
Wat we bouwen

Wat we koppelen

De koppelingen die we het vaakst bouwden, en die we ook voor jouw systemen kunnen bouwen.

Betalingen en billing

Stripe Checkout, Billing, Connect en Tax, met webhooks die abonnementen, facturen, terugbetalingen en betwiste betalingen synchroon houden.

Boekhouding

Stripe-facturen, uitbetalingen, kosten en terugbetalingen gesynchroniseerd met Moneybird, op de juiste grootboekrekeningen en btw-tarieven.

Social media

Publiceren, reacties en statistieken via de officiële API's van Instagram, YouTube, X en TikTok, inclusief de app-reviews.

Marktplaatsen en leveranciers

Listings, orders en track-and-trace met Etsy, en print-on-demand-orders die automatisch naar Printful gaan, zo gebouwd dat andere marktplaatsen hetzelfde patroon kunnen volgen.

Google-diensten

Versturen en inboxsynchronisatie via de Gmail API, adressen aanvullen met Google Places, data uit Search Console en server-side conversies voor Google Ads.

AI-aanbieders en openbare data

OpenAI, Fal, Replicate en ElevenLabs achter één interface, en adresgegevens verrijkt uit openbare Nederlandse registers zoals de BAG en het Kadaster.

Bewezen in de praktijk

Koppelingen die we in productie draaien

In Postcrest, Twelve Lumens en Salestreak draaien koppelingen met betaalproviders, boekhouding, social netwerken, marktplaatsen, Google-diensten, openbare Nederlandse registers en een lange lijst AI-aanbieders. Ze synchroniseren orders, publiceren posts, verversen tokens en verwerken webhooks, dag en nacht.

Elke koppeling is weleens misgegaan. Juist daarom zijn ze gebouwd zoals ze gebouwd zijn.

  • Stripe-checkouts beschermd met idempotency keys, webhook-events ontdubbeld op event-ID
  • OAuth-tokens ververst voordat ze verlopen, met een row lock zodat twee taken nooit tegelijk verversen
  • Webhooks van AI-aanbieders gecontroleerd met ED25519-handtekeningen
  • Een synchronisatie van Stripe naar Moneybird met een logboek van elke push
  • Een alarm in Sentry als het aandeel geslaagde koppelingen daalt

Diensten die we hebben gekoppeld

  1. Betalingen en boekhouding

    • Stripe Billing
    • Stripe Connect
    • Stripe Tax
    • Moneybird
  2. Social media

    • Instagram
    • YouTube
    • X
    • TikTok
  3. Commerce

    • Etsy
    • Printful
  4. Google

    • Gmail API
    • Places
    • Search Console
    • Ads Data Manager
  5. AI-aanbieders

    • OpenAI
    • Google Gemini
    • ElevenLabs
    • Fal
    • Replicate
    • Runway
  6. Data en e-mail

    • BAG
    • Kadaster
    • MillionVerifier
    • Resend
    • PostHog
Koppelingen die in onze eigen producten draaien.
externe API's in productie
20+
social media-API's gekoppeld
4
tussen twee ordersyncs met marktplaatsen
10 min
tussen twee inboxsyncs
5 min
Voor wie

Voor wie we systemen koppelen

Mkb'ers met tools die langs elkaar heen werken

Je webshop, boekhouding, CRM en mail hebben elk een deel van de waarheid. Wij koppelen ze, zodat gegevens maar één keer ingevoerd worden.

SaaS-bedrijven

De koppelingen waar je klanten om vragen, gebouwd als betrouwbaar onderdeel van je product in plaats van een wankele uitbreiding.

Webshops

Orders, voorraad, facturen en verzending die vanzelf doorstromen tussen je shop, marktplaatsen, leveranciers en boekhouding.

Teams met kwetsbare koppelingen

Scripts of no-code-flows die stilletjes stukgaan. Wij vervangen ze door koppelingen die het opnieuw proberen, alles loggen en alarm slaan.

Zo werkt het

Zo bouwen we een koppeling

We plannen eerst voor wat er mis kan gaan, want daar kosten koppelingen geld.

  1. 1

    Datastromen in kaart brengen

    Welk systeem eigenaar is van welke data, wat een synchronisatie start en wat er moet gebeuren als twee systemen het oneens zijn.

  2. 2

    De API's checken

    Limieten, rechten, webhooks en reviewprocessen van elke betrokken API, voordat we een aanpak kiezen.

  3. 3

    De koppeling bouwen

    Authenticatie, datamapping, synchronisatie op de achtergrond en webhooks, met idempotency vanaf het begin.

  4. 4

    De foutgevallen testen

    Verlopen tokens, timeouts, dubbele events en half mislukte acties, bewust getest.

  5. 5

    Monitoren in productie

    Logs, foutmonitoring en alerts op slagingspercentages, zodat niets stilletjes misgaat.

  6. 6

    Actueel houden

    API's krijgen nieuwe versies en schrappen oude. Wij houden koppelingen bij als aanbieders iets veranderen.

Tooling die we gebruiken

Koppelingen draaien als achtergrondtaken naast je applicatie, met dezelfde logging, monitoring en tests als de rest van de code.

  • REST API's
  • Webhooks
  • OAuth 2.0
  • Ruby on Rails
  • Solid Queue
  • PostgreSQL
  • Stripe
  • Moneybird
  • Gmail API
  • Sentry
Kosten en doorlooptijd

Wat kost een API-koppeling?

Eén koppeling tussen twee goed gedocumenteerde API's is een klein project. Deze factoren maken het groter:

Aantal systemen
Elk extra systeem brengt authenticatie, datamapping en eigen manieren om mis te gaan met zich mee.
Richting en volume
Af en toe één kant op synchroniseren is eenvoudiger dan realtime twee kanten op bij grote aantallen.
Kwaliteit van de API's
Goed gedocumenteerde API's met webhooks gaan snel. Magere documentatie, strenge rate limits of helemaal geen API kosten meer werk.
Goedkeuring door platforms
Sommige platforms, zoals Meta, TikTok en Google, beoordelen je app voordat die live mag.
Data opschonen
Dubbele en inconsistente gegevens in bestaande systemen moeten vaak eerst rechtgezet worden.
Veelgestelde vragen

Vragen over een API-koppeling laten maken

Wat kost een API-koppeling?

Dat hangt af van het aantal systemen, of data één kant op of twee kanten op gaat, het volume en de kwaliteit van de betrokken API's. Na een gratis kennismaking krijg je een scope en kostenraming op papier.

Hoe lang duurt het om een koppeling te laten maken?

Dat hangt af van de systemen en de API's. We plannen het werk in fases en starten platformreviews bij Meta, TikTok of Google vroeg, omdat die wachttijd toevoegen. De kostenraming na de kennismaking bevat een planning.

Kunnen jullie onze webshop koppelen aan onze boekhouding?

Meestal wel. We bouwden een synchronisatie tussen Stripe en Moneybird voor onze eigen producten, en koppelen andere webshops en boekhoudpakketten via hun API.

Wat als een systeem geen API heeft?

Dan zoeken we naar alternatieven, zoals geplande exports en imports, het uitlezen van e-mail of een partnerprogramma, en vertellen we je eerlijk hoe robuust elke optie is.

Waarom niet gewoon Zapier of Make?

Voor eenvoudige flows met weinig volume zijn ze prima. Zodra een koppeling bedrijfskritisch wordt, veel volume heeft of complexe logica nodig heeft, is een gebouwde koppeling met retries, logging en tests betrouwbaarder, en op termijn vaak goedkoper.

Wie onderhoudt de koppeling als een API verandert?

Dat kunnen wij doen. API's krijgen nieuwe versies en schrappen oude endpoints, en wij houden koppelingen bij. Of we documenteren alles, zodat je eigen team het kan overnemen.

Regelen jullie ook de app-reviews van platforms?

Ja. Koppelingen met Meta, Google, X en TikTok vragen vaak om een goedgekeurde developer-app. Die reviews bereiden we voor en dienen we in als onderdeel van het project.

Systemen die met elkaar moeten praten?

Vertel welke tools je gebruikt en waar data blijft hangen. Je krijgt een eerlijk beeld van wat er te koppelen valt en hoe robuust dat wordt.

martin@balk.dev

Je hoort meestal binnen één werkdag van ons.

Handig om te noemen

  • Wat je wilt bouwen, in een paar zinnen
  • Wie het gaat gebruiken
  • Een eventuele deadline of lanceerdatum
  • Systemen en tools waar het mee moet samenwerken