Service Archetypes
Third-Party Integration
Third-party integrations connect business workflows to external systems. They need contract ownership, failure behavior, security review, and clear support paths.
Integration inventory
Track:
- Vendor or partner owner.
- Internal business owner.
- Authentication method.
- Data exchanged and classification.
- Rate limits and quotas.
- Retry and timeout behavior.
- Support and escalation path.
- Contractual availability or notification commitments.
Architecture shape
Reliability practices
- Use explicit timeouts.
- Use queues when external availability should not block users.
- Make writes idempotent where possible.
- Monitor error rates, latency, quota usage, and backlog.
- Document degraded behavior when the third party is unavailable.
Readiness checks
Before production, confirm:
- Vendor support and escalation path are documented.
- Credentials, webhook secrets, and certificates have owners.
- Failure behavior is visible in dashboards and alerts.
- Retries and rate limits are configured intentionally.
- Contract or schema changes have a monitoring path.
Watchouts
- Vendor SLAs do not guarantee your user journey.
- API changes can break integrations without code changes on your side.
- Credentials and webhooks need rotation and ownership.
- Support paths should be tested before major launches.