API-integraties, getypte clients in, idempotente handlers uit, events die de retries van de partner overleven.
De meeste producten eindigen met integraties tegen acht tot vijftien externe APIs. De eerste is leuk; de vijftiende is technische schuld. We bouwen de integratielaag zodat elke nieuwe partner hetzelfde pattern volgt, getypte client in, idempotente webhook-handler uit, backfill-jobs voor catch-up, replay-tooling voor als er iets slipt.
Wat we bouwen
Getypte clients gegenereerd uit de spec van de partner
Waar de partner een OpenAPI-spec levert op, genereren we de TypeScript-client en checken hem in. Waar niet, schrijven we met de hand een dunne getypte adapter. Hoe dan ook ziet de aanroepende code getypte shapes, geen raw fetch.
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 met een oprichter of ervaren ontwikkelaar. We bepalen wat je nodig hebt en zeggen je eerlijk of Stacklane past.
Plan een gesprekVerwante capabilities