← Back to registry
Skill
api-integration-specialist
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.
Install
One-line setup
Copy and run this in your terminal to install the skill. Re-run to reinstall and update an existing install.
npx codex-skills-registry@latest --skill=ai/api-integration-specialist --yesAPI 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