All modules
MODULE 13 · THIRD-PARTY APIS IN GENERAL
Integrations
One adapter file per provider. No exceptions.
Calendar, CRM, WhatsApp, maps — every external API gets the same treatment: one adapter file, retries with backoff, verified webhooks, and a mock for local dev. Scatter provider calls through the codebase and every outage becomes your outage.
WHEN YOU NEED IT
Whenever a feature depends on someone else's service.
THE CHOICE, PER TIER
- T1One adapter file, keys in env vars
- T2+ retries, timeouts, webhook verification
- T3+ circuit breakers and provider status checks
SAY THIS TO YOUR AGENT
"Integrate this provider behind a single adapter file with typed functions, retries with backoff, and a mock mode for local dev. Verify webhook signatures."
DONE WHEN
- The provider is called from exactly one file
- Their downtime degrades your app, doesn't crash it
- Local dev works without hitting the real API