# api-testing-patterns

Скилл с готовыми паттернами тестирования REST и GraphQL API: контракты, авторизация, идемпотентность, гонки. Пригодится, когда пишете тесты или выбираете стратегию.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 605 установок · ★ 515
- Автор: proffesor-for-testing
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/proffesor-for-testing/agentic-qe/tree/HEAD/assets/skills/api-testing-patterns/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/api-testing-patterns

## Что делает

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

Внутри — готовые примеры кода на JavaScript. Проверка авторизации: запрос без токена, с просроченным токеном, доступ к чужим данным. Валидация входа: обязательные поля, типы, диапазоны. Идемпотентность через заголовок `Idempotency-Key` и гонки при параллельных заказах. Отдельный блок — CRUD-цикл для REST: создать, прочитать, обновить, удалить.

Скилл координирует четырёх субагентов: `qe-api-contract-validator` ищет ломающие изменения в контрактах, `qe-test-generator` собирает тесты из OpenAPI-спеки, `qe-performance-tester` грузит эндпоинты, `qe-security-scanner` проверяет безопасность. Для контрактов предлагаются Pact и Spring Cloud Contract, для REST — Supertest, REST-assured и Playwright, для нагрузки — k6, Artillery и JMeter. Скилл советует проверять контракт со стороны потребителя и не привязываться к порядку полей в ответе.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add proffesor-for-testing/agentic-qe --skill api-testing-patterns -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add proffesor-for-testing/agentic-qe --skill api-testing-patterns -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add proffesor-for-testing/agentic-qe --skill api-testing-patterns -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install proffesor-for-testing/agentic-qe api-testing-patterns
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add proffesor-for-testing/agentic-qe --skill api-testing-patterns -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/proffesor-for-testing/agentic-qe --path assets/skills/api-testing-patterns
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add proffesor-for-testing/agentic-qe --skill api-testing-patterns -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/proffesor-for-testing/agentic-qe/tree/HEAD/assets/skills/api-testing-patterns/SKILL.md

## Когда брать
- проверить, что провайдер не сломал контракт после релиза
- написать тесты на 401 и 403 для защищённых эндпоинтов
- поймать гонку при параллельном списании товара со склада
- сгенерировать тесты из OpenAPI-спеки
- выбрать между контрактным и интеграционным уровнем тестирования

## Примеры запросов агенту
- проверь контракт эндпоинта /orders по openapi.yaml и найди ломающие изменения
- сгенерируй тесты для REST API из openapi.yaml
- напиши тест на идемпотентность создания заказа с Idempotency-Key

## Похожие
- [contract-testing](https://affpapa.org/nevibecode/skills/contract-testing.md) — скилл · 1100 установок
- [api-testing](https://affpapa.org/nevibecode/skills/api-testing.md) — скилл · 1300 установок
- [conducting-api-security-testing](https://affpapa.org/nevibecode/skills/conducting-api-security-testing.md) — скилл · 643 установки
- [api-integration-surface-strategy](https://affpapa.org/nevibecode/skills/api-integration-surface-strategy.md) — скилл · 8000 установок
- [api-designer](https://affpapa.org/nevibecode/skills/zhaono1-api-designer.md) — скилл · 698 установок
- [api-contract-testing](https://affpapa.org/nevibecode/skills/api-contract-testing.md) — скилл · 913 установок

Из того же набора: [proffesor-for-testing/agentic-qe](https://affpapa.org/nevibecode/by/proffesor-for-testing/agentic-qe.md) — 4 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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