# api-integration-specialist

Скилл для Claude, который ведёт агента по подключению сторонних API: авторизация, повторы, лимиты запросов и вебхуки.

- скилл · `type=skill` · Claude Code · 2978 установок
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/api-integration-specialist
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/api-integration-specialist

## Что делает

Скилл подсказывает агенту, как строить клиент к чужому API: хранить ключи в переменных окружения, а не в коде, собирать OAuth 2.0 по схеме authorization code, приводить ответы сервиса к внутренней модели данных. Внутри — примеры на JavaScript: класс `APIClient`, обёртка над `fetch`, разбор ответа и преобразование полей.

Отдельный блок про сбои. Агент получает шаблон класса `APIError` со статусом и телом ответа, функцию повтора с экспоненциальной задержкой и клиентский ограничитель частоты запросов. Повторяются только серверные ошибки, клиентские не трогаются. Есть и проверка подписи вебхука через HMAC.

Скилл пригодится, когда вы подключаете Stripe, Twilio или SendGrid и не хотите каждый раз вспоминать, где ставить таймаут и как не выстрелить в лимит. Учтите: примеры написаны на JavaScript, для другого стека агенту придётся переносить логику самому.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --skill development/api-integration-specialist
```

2. **Через Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill api-integration-specialist -a claude-code
```

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates api-integration-specialist
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/api-integration-specialist
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/api-integration-specialist

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

## Примеры запросов агенту
- подключи Stripe к проекту, ключи возьми из переменных окружения
- сделай клиент к этому API с повторами и обработкой 429
- настрой вебхук и проверку подписи через HMAC

## Похожие
- [bfl-api](https://affpapa.org/nevibecode/skills/bfl-api.md) — скилл · 1000 установок
- [api-integration-surface-strategy](https://affpapa.org/nevibecode/skills/api-integration-surface-strategy.md) — скилл · 8000 установок
- [api-rate-limiting](https://affpapa.org/nevibecode/skills/secondsky-api-rate-limiting.md) — скилл · 491 установка
- [mcp-integration](https://affpapa.org/nevibecode/skills/mcp-integration.md) — скилл · 6994 установки
- [webhook-integration](https://affpapa.org/nevibecode/skills/webhook-integration.md) — скилл · 1100 установок
- [build-zoom-phone-integration](https://affpapa.org/nevibecode/skills/anthropics-build-zoom-phone-integration.md) — скилл · 2100 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 205 карточек

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