api-testing · laurigates — скилл для Claude Code: тестирование HTTP API
Скилл api-testing для написания тестов REST и GraphQL API через Supertest (TypeScript) и httpx/pytest (Python). Проверяет статусы, схемы ответов, аутентификацию и обработку ошибок.
MIT 106 установок ★ 60 обновлён 2026-10-25
npx skills add laurigates/claude-plugins --skill api-testing -a claude-codeЧто делает api-testing
Скилл даёт агенту знание двух стеков тестирования HTTP API: Supertest для Node.js (Express, Fastify) и httpx с pytest для Python (FastAPI). Агент пишет тесты на запросы и ответы — валидирует статус-коды, заголовки, JSON-схемы, проверяет Bearer-токены, куки, OAuth-потоки. Покрывает сценарии ошибок (4xx, 5xx) и интеграции с базами и внешними сервисами.
Внутри — примеры кода для всех HTTP-методов (GET, POST, PUT, PATCH, DELETE), работы с заголовками и query-параметрами, ассертов тела ответа. Для Python показаны FastAPI TestClient и асинхронные тесты через pytest-asyncio; для TypeScript — связка Supertest с Vitest или Jest. Скилл инвоцируется автоматически, когда упомянуты Supertest, httpx, валидация REST или ошибки HTTP-ответов.
Перед запуском тестов нужны установленные зависимости: для TypeScript — пакеты supertest и @types/supertest, для Python — httpx и pytest-asyncio. Установка через npm, bun, pip или uv в зависимости от проекта.
Какие задачи решает
- написать Supertest-тесты для Express или Fastify API
- проверить статус-коды, заголовки и JSON-схему ответа
- протестировать аутентификацию через Bearer-токены и куки
- покрыть тестами обработку 4xx и 5xx ошибок
- написать httpx + pytest тесты для FastAPI эндпоинтов
Примеры запросов агенту
- Напиши Supertest-тесты для эндпоинтов
/api/usersи/api/healthв Express - Добавь pytest-тесты для FastAPI роута
/api/orders, проверь статус 201 и схему ответа - Покрой тестами обработку ошибок 400 и 404 в
/api/products/:id
Как установить api-testing
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill api-testing -a claude-code2Вручную: положить файлы
~/.claude/skills/api-testing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-testing/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill api-testing -a codex2Вручную: положить файлы
.agents/skills/api-testing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill api-testing -a cursor2Вручную: положить файлы
.cursor/skills/api-testing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install laurigates/claude-plugins api-plugin/skills/api-testing2Вручную: положить файлы
.github/skills/api-testing/SKILL.md1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill api-testing -a gemini-cli2Командой платформы
gemini skills install https://github.com/laurigates/claude-plugins --path api-plugin/skills/api-testingВручную: положить файлы
.devin/skills/api-testing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill api-testing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об api-testing
Как установить api-testing в Claude Code?
Выполни npx skills add laurigates/claude-plugins --skill api-testing -a claude-code, скилл появится в ~/.claude/skills/api-testing/SKILL.md.
Что делает скилл api-testing?
Даёт агенту экспертизу в написании HTTP API тестов через Supertest (TypeScript) и httpx/pytest (Python). Покрывает валидацию запросов, ответов, аутентификации и обработку ошибок.
Какие зависимости нужны для работы api-testing?
Для TypeScript нужны пакеты supertest и @types/supertest (установка через npm install -D или bun add -d). Для Python — httpx и pytest-asyncio (через pip install или uv add --dev).
Исходный текст
SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-07-05
reviewed: 2026-04-25
name: api-testing
description: HTTP API testing with Supertest (TS) and httpx/pytest (Python). Use when the user mentions API testing, Supertest, httpx, REST/GraphQL validation, or HTTP response errors.
user-invocable: false
allowed-tools: Bash(curl *), Bash(http *), Bash(jq *), Read, Edit, Write, Grep, Glob, TodoWrite
---
# API Testing
Expert knowledge for testing HTTP APIs with Supertest (TypeScript/JavaScript) and httpx/pytest (Python).
## When to Use This Skill
| Use this skill when... | Use `configure-plugin:configure-api-tests` instead when... |
|---|---|
| Writing Supertest endpoint tests against an Express/Fastify app | Setting up Pact consumer/provider contract testing infrastructure |
| Writing httpx + pytest tests for a Python REST/GraphQL API | Validating an OpenAPI specification or wiring schema (Zod/AJV) checks into CI |
| Validating request/response shapes, status codes, and auth flows in test code | Auditing or scaffolding API contract testing tooling for a project |
| Asserting error handling (4xx/5xx) and integration state in functional tests | Adding breaking-change detection workflows to CI |
## Core Expertise
**API Testing Capabilities**
- **Request testing**: Headers, query params, request bodies
- **Response validation**: Status codes, headers, JSON schemas
- **Authentication**: Bearer tokens, cookies, OAuth flows
- **Error handling**: 4xx/5xx responses, validation errors
- **Integration**: Database state, external services
- **Performance**: Response times, load testing basics
## TypeScript/JavaScript (Supertest)
### Installation
```bash
# Using Bun
bun add -d supertest @types/supertest
# Using npm
npm install -D supertest @types/supertest
```
### Basic Setup with Express
```typescript
// app.ts
import express from 'express'
export const app = express()
app.use(express.json())
app.get('/api/health', (req, res) => {
res.json({ status: 'ok' })
})
app.post('/api/users', (req, res) => {
const { name, email } = req.body
if (!name || !email) {
return res.status(400).json({ error: 'Missing required fields' })
}
res.status(201).json({ id: 1, name, email })
})
```
```typescript
// app.test.ts
import { describe, it, expect } from 'vitest'
import request from 'supertest'
import { app } from './app'
describe('API Tests', () => {
it('returns health status', async () => {
const response = await request(app)
.get('/api/health')
.expect(200)
expect(response.body).toEqual({ status: 'ok' })
})
it('creates a user', async () => {
const response = await request(app)
.post('/api/users')
.send({ name: 'John Doe', email: '[email protected]' })
.expect(201)
expect(response.body).toMatchObject({
id: expect.any(Number),
name: 'John Doe',
email: '[email protected]',
})
})
it('validates required fields', async () => {
const response = await request(app)
.post('/api/users')
.send({ name: 'John Doe' })
.expect(400)
expect(response.body.error).toBeDefined()
})
})
```
### Request Methods
```typescript
import request from 'supertest'
import { app } from './app'
// GET request
await request(app).get('/api/users').expect(200)
// POST request with body
await request(app).post('/api/users')
.send({ name: 'John', email: '[email protected]' }).expect(201)
// PUT request
await request(app).put('/api/users/1')
.send({ name: 'Jane' }).expect(200)
// PATCH request
await request(app).patch('/api/users/1')
.send({ email: '[email protected]' }).expect(200)
// DELETE request
await request(app).delete('/api/users/1').expect(204)
```
### Headers and Query Parameters
```typescript
// Set headers
await request(app)
.get('/api/protected')
.set('Authorization', 'Bearer token123')
.set('Content-Type', 'application/json')
.expect(200)
// Query parameters
await request(app)
.get('/api/users')
.query({ page: 1, limit: 10 })
.expect(200)
```
### Response Assertions
```typescript
describe('Response validation', () => {
it('validates status code', async () => {
await request(app).get('/api/users').expect(200)
})
it('validates headers', async () => {
await request(app).get('/api/users')
.expect('Content-Type', /json/).expect(200)
})
it('validates response body', async () => {
const response = await request(app).get('/api/users/1').expect(200)
expect(response.body).toEqual({
id: 1,
name: 'John Doe',
email: '[email protected]',
createdAt: expect.any(String),
})
})
it('validates array responses', async () => {
const response = await request(app).get('/api/users').expect(200)
expect(response.body).toBeInstanceOf(Array)
expect(response.body).toHaveLength(5)
expect(response.body[0]).toHaveProperty('id')
})
})
```
## Python (httpx + pytest)
### Installation
```bash
# Using uv
uv add --dev httpx pytest-asyncio
# Using pip
pip install httpx pytest-asyncio
```
### Basic Setup with FastAPI
```python
# main.py
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
app = FastAPI()
class User(BaseModel):
name: str
email: str
@app.get("/api/health")
def health_check():
return {"status": "ok"}
@app.post("/api/users", status_code=201)
def create_user(user: User):
return {"id": 1, "name": user.name, "email": user.email}
@app.get("/api/users/{user_id}")
def get_user(user_id: int):
if user_id == 999:
raise HTTPException(status_code=404, detail="User not found")
return {"id": user_id, "name": "John Doe", "email": "[email protected]"}
```
```python
# test_main.py
from fastapi.testclient import TestClient
from main import app
client = TestClient(app)
def test_health_check():
response = client.get("/api/health")
assert response.status_code == 200
assert response.json() == {"status": "ok"}
def test_create_user():
response = client.post(
"/api/users",
json={"name": "John Doe", "email": "[email protected]"}
)
assert response.status_code == 201
data = response.json()
assert data["name"] == "John Doe"
assert "id" in data
def test_validation_error():
response = client.post("/api/users", json={"name": "John"})
assert response.status_code == 422 # FastAPI validation error
def test_not_found():
response = client.get("/api/users/999")
assert response.status_code == 404
```
For detailed examples including authentication testing, file uploads, cookie testing, database integration, schema validation, GraphQL testing, performance testing, best practices, and troubleshooting, see [REFERENCE.md](REFERENCE.md).
## Agentic Optimizations
| Context | Command |
|---------|---------|
| Quick test (Bun) | `bun test --dots --bail=1 api` |
| Quick test (pytest) | `pytest -x --tb=short tests/api/` |
| Run single test file | `bun test --dots path/to/test.ts` |
| Verbose on failure | `bun test --bail=1 api` |
## See Also
- `vitest-testing` - Unit testing framework
- `python-testing` - Python pytest patterns
- `playwright-testing` - E2E API testing
- `test-quality-analysis` - Test quality patterns
## References
- Supertest: https://github.com/ladjs/supertest
- httpx: https://www.python-httpx.org/
- FastAPI Testing: https://fastapi.tiangolo.com/tutorial/testing/
- Node.js Testing Best Practices: https://github.com/goldbergyoni/nodejs-testing-best-practices
© laurigates · MIT · laurigates/claude-plugins
Похожие скиллы
Все скиллы по теме «Тесты и QA» →Сначала — api-testing от других авторов.