# api-integration-builder

Скилл api-integration-builder для Claude Code ведёт агента при сборке интеграции со сторонним API. Описывает OAuth, повторы, лимиты частоты и вебхуки, включая ответы 429 и 401.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 244 установки · ★ 39 у репозитория
- Автор: daffy0208
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/daffy0208/ai-dev-standards/tree/HEAD/skills/api-integration-builder/SKILL.md
- Обновлён: 2025-12-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/api-integration-builder

## Что делает

Скилл задаёт схему, по которой агент собирает интеграцию со сторонним API: слой авторизации, менеджер запросов, обработчик вебхуков, синхронизация данных и восстановление после сбоев. Внутри — примеры на TypeScript: OAuth 2.0 с проверкой `state`, обмен кода на токен, хранение токенов в зашифрованном виде и обновление за минуту до истечения срока.

Часть про сбои расписана конкретнее всего. Клиент ограничивает частоту через `RateLimiter` из пакета `limiter`, на 429 читает заголовок `Retry-After`, а если его нет — ждёт по `Math.pow(2, attempt)`. Ошибки делятся на повторяемые и нет: 4xx обычно не повторяют, 5xx повторяют. 401 не роняет запрос: токен обновляется, и запрос уходит снова, поэтому `refresh_token` должен быть сохранён заранее.

Ещё скилл требует идемпотентности: повторная доставка вебхука или retry не должны плодить дубли. Пользователю вместо «API Error 429» показывают понятное сообщение. По сути это инструкция для агента плюс примеры кода, которые он подгоняет под ваш сервис.

## Требования
- Работает с: Slack, Gmail, Stripe

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daffy0208/ai-dev-standards --skill api-integration-builder -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/api-integration-builder/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/api-integration-builder/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daffy0208/ai-dev-standards --skill api-integration-builder -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/api-integration-builder/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daffy0208/ai-dev-standards --skill api-integration-builder -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/api-integration-builder/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install daffy0208/ai-dev-standards skills/api-integration-builder
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/api-integration-builder/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add daffy0208/ai-dev-standards --skill api-integration-builder -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/daffy0208/ai-dev-standards --path skills/api-integration-builder
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/api-integration-builder/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add daffy0208/ai-dev-standards --skill api-integration-builder -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/daffy0208/ai-dev-standards/tree/HEAD/skills/api-integration-builder/SKILL.md

## Когда брать
- подключить OAuth 2.0 с проверкой `state` и обменом кода на токен
- пережить ответ 429 и не уронить синхронизацию
- хранить токены зашифрованными и обновлять их до истечения
- отличить повторяемую ошибку API от той, которую повторять бессмысленно
- защитить обработчик вебхуков от дублей при повторной доставке

## Примеры запросов агенту
- Сделай интеграцию со Slack через OAuth: сохранение токенов, обновление и повтор на 401.
- Добавь в клиент Stripe обработку 429 с `Retry-After` и повторами.
- Проверь мой обработчик вебхуков: что будет при повторной доставке события.

## Похожие
- [api-integration-specialist](https://affpapa.org/nevibecode/skills/api-integration-specialist.md) — скилл · 2978 установок
- [encore-webhook](https://affpapa.org/nevibecode/skills/encore-webhook.md) — скилл · 472 установки
- [recoup-platform-api-access](https://affpapa.org/nevibecode/skills/recoup-platform-api-access.md) — скилл · 5500 установок
- [slack](https://affpapa.org/nevibecode/skills/vercel-labs-slack.md) — скилл · 212 установок
- [bfl-api](https://affpapa.org/nevibecode/skills/bfl-api.md) — скилл · 1200 установок
- [authsome](https://affpapa.org/nevibecode/skills/authsome.md) — скилл · 3000 установок

Из того же набора: [daffy0208/ai-dev-standards](https://affpapa.org/nevibecode/by/daffy0208/ai-dev-standards.md) — 63 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
