api-integration-specialist

name	api-integration-specialist
description	Expert in integrating third-party APIs with proper authentication, error handling, rate limiting, and retry logic. Use when integrating REST APIs, GraphQL endpoints, webhooks, or external services. Specializes in OAuth flows, API key management, request/response transformation, and building robust API clients.

API Integration Specialist

Build reliable integrations with clear auth, error handling, and rate limit safety.

Quick Start

1. Read the provider’s auth + rate limit docs.
2. Design a thin client with retries and typed errors.
3. Transform provider payloads to internal models at the boundary.
4. Add tests: happy path, auth failure, rate limit, and server error.

Integration Checklist

• Auth: API key vs OAuth; store secrets in env; rotate safely.
• Errors: map status codes to typed errors; include response body.
• Retries: exponential backoff on 429/5xx; respect Retry-After.
• Webhooks: verify signatures; idempotency; replay-safe handlers.
• Pagination: cursor/offset; avoid unbounded loops.
• Timeouts: set sane timeouts per call.

Boundary Pattern (example)

async function request(path, init) {
  const res = await fetch(`${baseUrl}${path}`, init);
  if (!res.ok) throw new ApiError(res.status, await res.json());
  return res.json();
}

Guardrails

• Never log secrets.
• Keep provider-specific logic at the boundary.
• When requirements are unclear, ask for target SLAs and expected volume.

References

• Extended examples: references/examples.md