Night Mode LabsBlue Book
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.

On this page