API-integraties, schone clients in, idempotente handlers uit, events die de retries van de partner overleven.
De meeste producten eindigen met integraties tegen acht tot vijftien externe API's. De eerste is leuk; de vijftiende is technische schuld. We bouwen de integratielaag zodat elke nieuwe partner hetzelfde patroon volgt, schone client in, idempotente webhook-handler uit, backfill-jobs voor catch-up, replay-tooling voor als er iets slipt.
Wat we bouwen
Clients gegenereerd uit de spec van de partner
Waar de partner een OpenAPI-spec levert, genereren we de client en checken hem in. Waar niet, schrijven we met de hand een dunne adapter. Hoe dan ook ziet de aanroepende code typeerde shapes tegen het contract van de partner, geen raw HTTP.
Webhook-ingestion als één gedeelde service
Stripe-webhooks, Plaid-webhooks, Shopify-webhooks, Twilio-webhooks, landen allemaal in één webhook-service die signatures verifieert, dedupet op event ID, raw payload persisteert, en naar getypte handlers dispatcht. Signature-verificatie is niet optioneel.
Idempotency op elke state-veranderende handler
Elke handler is veilig om twee keer te draaien. Replays tijdens incident response corrupteren state niet; retry-storms van een partner ook niet. Het pattern wordt door het framework afgedwongen, niet door hoop per handler.
Backfill-jobs voor de geschiedenis van de partner
Als je een klant onboardt met drie jaar Stripe-historie, moet je hem importeren. We bouwen gepagineerde backfill-jobs met checkpoints, rate-limit-awareness en resume-from-failure. De job draait één keer; de klant merkt nooit dat hij draaide.
Replay-tooling voor de slips
Webhooks worden gedropt. Netwerken hikken. Partners hebben outages. We bouwen replay-endpoints die de event-historie van de partner opnieuw kunnen ophalen en door dezelfde handlers heen dispatchen. Reconciliatie is een one-command operatie, geen meerdaags onderzoek.
Observability per partner
Per-partner dashboards die webhook-ingest-rate, handler-latency, failure-rate en replay-activity tonen. Als een partner-integratie raar wordt, zien we het voor klanten dat doen.
Waar dit past
Je integreert met een vierde of vijfde externe API en de bestaande code is drie copy-pasted webhook-handlers achter elkaar.
Je reconciliatie-jobs zijn spreadsheets en ad-hoc SQL, en de volgende compliance-review wil een ander antwoord.
Je hebt een partner-outage gehad die data verloor en er is geen replay-pad; de kosten waren klantvertrouwen.
Tech stack
- TypeScript
- OpenAPI Clients
- Webhooks
- BullMQ
- Idempotency Keys
Wil je dit voor je team?
30 minuten om vast te stellen wat je nodig hebt. Geen pitchdeck, geen verplichtingen. We zeggen je eerlijk of Stacklane past.
Plan een gesprek