К основному содержанию
скилл CX Codex

api-testing · fugazi — скилл для Claude Code: API-тесты

Скилл api-testing помогает проверять контракты REST- и GraphQL-эндпоинтов. Он пригодится для тестов схем, авторизации, ошибок и граничных случаев без управления браузером.

MIT 112 установок ★ 269 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add fugazi/test-automation-skills-agents --skill api-testing -a claude-code
Открыть на GitHub

Что делает api-testing

Скилл предлагает писать отдельные API-тесты на TypeScript с Playwright request fixture или Supertest либо на Java с REST Assured. Он охватывает проверку схем запросов и ответов, авторизацию, коды ошибок, пагинацию, идемпотентность и ограничения частоты запросов. Для браузерных E2E-сценариев он не предназначен.

В комплект входят шаблоны тестов для Playwright и REST Assured, скрипт проверки доступности API и справочные материалы по схемам и контрактам. В стеке TypeScript нужны Node.js 18+ и @playwright/test или supertest, а также zod; для Java — Java 21+, REST Assured 5.x, AssertJ, Jackson и json-schema-validator. Без этих зависимостей примеры и шаблоны не запустятся.

Какие задачи решает

  • проверить схемы ответов REST-эндпоинтов
  • покрыть GraphQL API проверками авторизации
  • проверить обработку ошибок и HTTP-статусов
  • найти проблемы пагинации и граничных значений
  • проверить идемпотентность операций PUT и DELETE

Примеры запросов агенту

  • Создай тесты для REST-эндпоинта: проверь схему ответа, авторизацию и ошибки.
  • Покрой GraphQL API проверками валидных и пустых данных.
  • Добавь для PUT и DELETE проверки идемпотентности и граничных значений.

Как установить api-testing

1Через Skills CLI (Vercel)

npx skills add fugazi/test-automation-skills-agents --skill api-testing -a claude-code

2Вручную: положить файлы

~/.claude/skills/api-testing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/api-testing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об api-testing

Как установить api-testing в Claude Code?

Выполните npx skills add fugazi/test-automation-skills-agents --skill api-testing -a claude-code. Файл скилла находится по пути ~/.claude/skills/api-testing/SKILL.md.

Что делает api-testing?

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

Что нужно для тестов на TypeScript и Java?

Для TypeScript нужны Node.js 18+, @playwright/test или supertest и zod. Для Java требуются Java 21+, REST Assured 5.x, AssertJ, Jackson и json-schema-validator.

Исходный текст

SKILL.md · MIT
---
name: api-testing
description: 'Test REST and GraphQL endpoint contracts using Playwright request fixture (TypeScript) or REST Assured (Java). Use for standalone API tests covering schemas, auth, status/error handling, pagination, idempotency, rate limits, or contract checks; not for browser E2E specs. Keywords: REST, GraphQL, API contract, schema validation, REST Assured.'
license: 'Complete terms in LICENSE.txt'
---

# API Testing (Playwright + REST Assured)

Comprehensive API testing skill covering both Playwright TypeScript (request fixture, Supertest, Zod) and Java (REST Assured, AssertJ, JSON Schema Validator).

## When to Use This Skill

- Create API tests for REST or GraphQL endpoints
- Validate request/response schemas (Zod, JSON Schema)
- Test authentication flows (OAuth2, JWT, API keys, Bearer tokens)
- Verify error handling (400, 401, 403, 404, 409, 422, 500)
- Test pagination, filtering, sorting edge cases
- Validate idempotency for PUT/DELETE operations
- Contract testing between services
- Rate limiting validation

### Do NOT Use For

- Browser-driven UI flows (use `playwright-e2e-testing` for Playwright specs, or `webapp-selenium-testing` for Selenium)
- Live interactive browser sessions or snapshots (use `playwright-cli`)
- Visual/layout regression (out of scope — no DOM)
- End-to-end journeys that must drive a real browser across pages

## Prerequisites

| Stack      | Requirements                                                          |
| ---------- | --------------------------------------------------------------------- |
| TypeScript | Node.js 18+, `@playwright/test` or `supertest`, `zod`                 |
| Java       | Java 21+, REST Assured 5.x, AssertJ, Jackson, `json-schema-validator` |

## Core Principles

1. **Schema validation on every response** — never trust an unvalidated response
2. **Test all HTTP status codes** — happy path AND error states
3. **Auth testing is mandatory** — verify 401/403 for protected endpoints
4. **Data-driven** — test with valid, invalid, boundary, and empty values
5. **Stateless where possible** — each test cleans up or uses unique data

## Quick Reference — Playwright

```typescript
import { test, expect } from "@playwright/test";

test("GET /api/users returns 200 with valid schema", async ({ request }) => {
  const response = await request.get("/api/users");
  expect(response.ok()).toBeTruthy();
  const body = await response.json();
  expect(body).toMatchObject({ data: expect.any(Array) });
});
```

## Quick Reference — REST Assured

```java
import static io.restassured.RestAssured.*;
import static org.hamcrest.Matchers.*;

import java.util.List;

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

@Test
@DisplayName("GET /api/users returns 200 with valid schema")
void getUsers() {
    String token = "test-token";

    given()
        .header("Authorization", "Bearer " + token)
    .when()
        .get("/api/users")
    .then()
        .statusCode(200)
        .body("data", is(instanceOf(List.class)))
        .body("data.size()", greaterThan(0));
}
```


---

## Red Flags

Stop and reconsider if you see any of these in generated API tests:

- Assertions only on status code with no body/schema validation — an unvalidated response hides contract drift.
- Hardcoded secrets/tokens committed to the test file — read from env or a secrets manager.
- Tests sharing mutable state with no cleanup — flaky and order-dependent.
- Skipping auth tests (no 401/403 assertions on protected endpoints) — security regression risk.
- No coverage of error states (only happy-path 200s) — error handling is untested.

---

## References

| Document                                                         | Content                                             |
| ---------------------------------------------------------------- | --------------------------------------------------- |
| [REST API Patterns](./references/rest-api-patterns.md)           | CRUD, pagination, filtering, error patterns         |
| [Playwright API Testing](./references/playwright-api-testing.md) | Request fixture, Supertest, TypeScript patterns     |
| [REST Assured Testing](./references/rest-assured-testing.md)     | REST Assured, AssertJ, Java patterns                |
| [Schema Validation](./references/schema-validation.md)           | Zod (TS), JSON Schema (Java), strict vs loose       |
| [Contract Testing](./references/contract-testing.md)             | Request/response contracts, idempotency, versioning |

## Templates

- [Playwright API Spec](./templates/playwright-api-spec.ts) — starter test file for API testing
- [REST Assured Test](./templates/rest-assured-test.java) — starter Java test class

## Scripts

- [API Health Check](./scripts/api-health-check.sh) — validate API endpoints respond correctly

## Troubleshooting

| Issue                          | Solution                                                                       |
| ------------------------------ | ------------------------------------------------------------------------------ |
| 401 on authenticated endpoints | Verify token is fresh; check expiry; re-authenticate                           |
| Flaky API tests                | Add retry logic; check for rate limiting; use unique test data                 |
| Schema validation too strict   | Use `.passthrough()` (Zod) or `additionalProperties: true` for flexible fields |
| Timeout on slow endpoints      | Increase `timeout` in request options; check for server load                   |

---

## Verification

- [ ] **Schema validation in place** — Every response validated against a schema (Zod or JSON Schema)
- [ ] **Authentication tested** — 401 returned for protected endpoints without valid credentials
- [ ] **Idempotency verified** — PUT/DELETE produce same result when called multiple times
- [ ] **Edge cases covered** — Empty payloads, invalid types, boundary values, SQL injection attempts

© fugazi · MIT · fugazi/test-automation-skills-agents

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

Сначала — api-testing от других авторов.

api-testing kindlmann Скилл api-testing для Claude Code помогает писать тесты REST- и GraphQL API. Включается при проверке схемы ответа, авторизации, ошибок и пагинации. CX Codex +1 1 800установок api-testing secondsky Скилл api-testing для Claude Code учит агента писать тесты HTTP API на Supertest (TypeScript) и httpx (Python). Покрывает REST, GraphQL, проверку ошибок и авторизацию. CX Codex +1 921установок api-testing laurigates Скилл api-testing для написания тестов REST и GraphQL API через Supertest (TypeScript) и httpx/pytest (Python). Проверяет статусы, схемы ответов, аутентификацию и обработку ошибок. CX Codex +1 106установок api-testing oakoss Скилл api-testing для Claude Code помогает писать интеграционные тесты REST API и проверять ответы эндпоинтов. Включается при настройке HTTP-моков или тестировании ошибок. CX Codex +1 149установок playwright-api-testing-cursorrules-prompt-file PatrickJS Правило playwright-api-testing-cursorrules-prompt-file настраивает Cursor для генерации API-тестов на Playwright с плагином pw-api-plugin. Помогает проверять статус-коды и валидировать схемы данных с Zod. CX Codex +1 ★ 41 178звёзд репо playwright-testing laurigates Скилл playwright-testing помогает писать E2E-тесты для веб-приложений в Playwright: проверять браузеры, мобильные viewport, API и визуальные снимки. CX Codex +1 106установок api-security-testing usestrix Скилл api-security-testing помогает проверить REST, GraphQL и gRPC API с помощью Strix: агенты ищут уязвимости и прикладывают запрос для проверки находки. CX Codex +1 17 500установок testing-api-security-with-owasp-top-10 mahipal Скилл testing-api-security-with-owasp-top-10 прогоняет REST, GraphQL и gRPC эндпоинты по OWASP API Security Top 10 (2023) через Burp Suite и Postman. Пригодится на авторизованном пентесте и перед выкаткой новых эндпоинтов. CX Codex +1 931установок conducting-api-security-testing mahipal Скилл conducting-api-security-testing для Claude Code проверяет REST, GraphQL и gRPC API на ошибки доступа, аутентификации, валидации и бизнес-логики. Выполняет авторизованные проверки API. CX Codex +1 715установок api-testing-patterns proffesor-for-testing Скилл api-testing-patterns для Claude Code с готовыми паттернами тестирования REST и GraphQL API: контракты, авторизация, идемпотентность, гонки. Покрывает написание тестов и выбор стратегии. CX Codex +1 618установок

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой