Operations relaySystems online
Work/03
Provider sync + verified webhooks

API Integration Hub

A production-style backend pattern for external API syncs, signed webhooks, account-level rate control, and audit-ready history.

EvidencePublic repository
CategoryIntegrations
RoleArchitecture → delivery
System routeRead left to right
  1. 01Provider
  2. 02Rate gate
  3. 03Async sync
  4. 04Audit
  5. 05Webhook
01 / Context and problem

The operational problem

Every external API differs, but reliable integrations need the same foundations: secret boundaries, pagination, rate limits, durable state, and trusted webhooks.

Ownership

Designed the provider abstraction, async client behavior, sync service, persistence schema, webhook verification, rate limiter, audit model, tests, CI, and Docker packaging.

02 / Technical challenge

What made it non-trivial

New providers had to fit a reusable interface without leaking credentials or weakening provider-specific trust and rate constraints.

The named adapters are provider-like deterministic examples.

No real production credentials are included.

No hosted deployment or live provider volume is claimed.

03 / System design

The architecture decision

A provider registry isolates adapters while a shared integration service coordinates cursor pagination, account-level rate limiting, sync history, records, audit events, and HMAC webhook verification with replay tolerance.

01Python02FastAPI03asyncio04httpx05SQLAlchemy06Pydantic07HMAC08Docker
04 / Reliability

Designed for the failure path

  • 01

    Pydantic secret types and non-returned credentials

  • 02

    Provider/account-level rate limiting

  • 03

    Timestamped HMAC webhook verification

  • 04

    Replay tolerance boundary

  • 05

    Persistent sync runs and audit records

  • 06

    Deterministic test providers

05 / Result and evidence

What this system proves

A reusable integration architecture with Stripe-like, Shopify-like, and HubSpot-like adapters that can be extended without changing the sync orchestration core.

Tayyab understands integration work as a reliability and trust problem, not just a sequence of HTTP calls.
06 / Lessons

What carries forward

01

Provider variation belongs behind an adapter boundary.

02

Webhook trust requires both signature validation and replay controls.

03

Audit history is part of the product when systems move business data.

Next system · 04CareerOS