Api Openapi Generic CI B2

---
name: api-openapi-generic
description: How to integrate external APIs safely; how to store and query OpenAPI without polluting context.
---

# API Integration (Generic)

- Prefer finding OpenAPI/Swagger spec; store it in `references/` (not pasted into chat).
- Implement:
  - timeouts
  - retries with backoff
  - idempotency where required
  - clear error classification (retryable vs non-retryable)
- Keep a project overlay skill `api-<vendor>` with endpoints used by the project.

## Setup API Environment

Securely manage API credentials before integration. Run the following to initialize environment variables:

```bash
python scripts/api_key_manager.py
```

This script ensures proper credential handling for API operations.