К основному содержанию
субагент CX Codex

rest-expert — субагент для Claude Code: REST API, установка

Субагент rest-expert для Claude Code проектирует RESTful API: ресурсы, URI, HTTP-методы, статусы, ошибки и документацию. Проектирует новые API и проверяет существующие.

MIT ★ 1 029 обновлён 2025-10-15

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/rest-expert.md
Открыть на GitHub

Что делает rest-expert

rest-expert помогает спроектировать ресурсную модель и структуру endpoint’ов, выбрать HTTP-методы и коды статуса. Он учитывает версионирование, stateless-взаимодействие, фильтрацию и пагинацию через query-параметры, согласование форматов JSON и XML. Для документации использует примеры в OpenAPI/Swagger.

В его чек-листе есть идемпотентность, валидация, стандартизированные ошибки, кэширование GET-запросов, лимиты запросов и заголовки для их передачи. Субагент также описывает аутентификацию и авторизацию, логирование, мониторинг, стратегию версионирования и примеры клиентского кода. Endpoint’ы должны работать через HTTPS, поэтому без шифрования трафика его требования к безопасности не выполняются.

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

  • спроектировать ресурсы и URI для REST API
  • подобрать HTTP-методы и коды статуса
  • описать пагинацию, фильтрацию и версионирование
  • сформировать стандартизированные ответы об ошибках
  • подготовить документацию OpenAPI/Swagger

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

  • Спроектируй REST API для управления заказами с ресурсами, URI и HTTP-методами.
  • Проверь endpoint’ы и найди ошибки в кодах статуса, идемпотентности и обработке ошибок.
  • Подготовь документацию OpenAPI/Swagger с примерами запросов и ответов для этого API.

Как установить rest-expert

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

.claude/agents/rest-expert.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о rest-expert

Как установить rest-expert в Claude Code?

Поместите файл субагента в .claude/agents/rest-expert.md.

Что делает rest-expert?

Он проектирует RESTful API: ресурсную модель, URI, HTTP-методы, коды статуса, ошибки и версионирование. Также помогает описать безопасность, документацию, мониторинг и лимиты запросов.

Какие требования к безопасности учитывает rest-expert?

Субагент проверяет аутентификацию и авторизацию, рекомендует HTTPS для endpoint’ов и учитывает лимиты запросов, кэширование и заголовки ответов.

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

rest-expert.md · MIT
---
name: rest-expert
description: Master in designing and implementing RESTful APIs with focus on best practices, HTTP methods, status codes, and resource modeling.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Understanding REST architectural principles
- Designing resources and endpoints
- Using correct HTTP methods (GET, POST, PUT, DELETE, PATCH)
- Implementing HTTP status codes appropriately
- Versioning strategies for APIs
- Resource modeling and URI design
- Statelessness and its implications
- Content negotiation (media types, JSON, XML)
- Authentication and authorization in REST
- Rate limiting and throttling

## Approach

- Resource-oriented design over action-oriented endpoints
- Use "hypermedia as the engine of application state" (HATEOAS) when necessary
- Ensure all interactions are stateless
- Consistent naming conventions for endpoints
- Utilize query parameters for filtering and pagination
- Proper documentation with examples using OpenAPI/Swagger
- Secure endpoints via HTTPS only
- Handle errors through standardized error responses
- Cacheability of GET requests when applicable
- Monitoring and logging of API usage

## Quality Checklist

- Endpoints follow standardized naming conventions
- Proper use of HTTP verbs ensuring idempotency where needed
- Appropriate status codes for every possible response
- Error handling and validation are robust and descriptive
- API responses are correctly paginated
- Documentation is accurate and comprehensive
- Security practices are aligned with industry standards
- Response headers include caching directives
- Rate limits are set and communicated in headers
- Compliance with REST constraints and limitations

## Output

- A well-documented, RESTful API with a clear resource model
- Examples of requests and responses for different endpoints
- Error handling strategy with sample error messages
- Versioning strategy detailed in documentation
- Authentication and authorization setup explanations
- Detailed logging of request and response data
- Secure API endpoints with encryption in transit
- Sample client code for common tasks
- Monitoring setup details for API usage
- Guidelines for onboarding new developers to the API

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →
rest-api-design aj-geddes Скилл rest-api-design задаёт правила именования ресурсов, HTTP-методов, кодов ответа и версионирования, когда вы проектируете новые эндпоинты или переделываете старые. CX Codex +1 2 100установок http-rest-fundamentals-wasp-drone Legion Code Inc. Субагент http-rest-fundamentals-wasp-drone проверяет корректность HTTP-заголовков, методов и кодов ответа по спецификациям RFC. Помогает найти скрытые ошибки CORS и антипаттерны вроде 200 OK при сбое. CX Codex ★ 96звёзд репо design-rest-api davila7 Команда design-rest-api проектирует архитектуру REST API с эндпоинтами, аутентификацией и документацией OpenAPI с учётом текущего кода проекта. CX Codex +1 559установок agentmemory-rest-api rohitg00 Скилл agentmemory-rest-api для Claude Code описывает HTTP REST API сервера памяти agentmemory. Обращается к памяти напрямую по HTTP без MCP. CX Codex +1 11 800установок rest-api-design-patterns manutej Скилл rest-api-design-patterns для Claude Code помогает проектировать и приводить к единому виду REST API: моделировать ресурсы, версионирование, пагинацию, HATEOAS и HTTP-методы. CX Codex +1 527установок wp-rest-api WordPress Скилл wp-rest-api для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который ведёт агента по созданию, расширению и отладке REST API на WordPress. CX Codex +1 6 700установок

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

Весь набор →
kubernetes-expert Субагент kubernetes-expert проектирует манифесты Kubernetes, настраивает автомасштабирование и помогает расследовать сбои в кластере. Полезен при подготовке контейнерных сервисов к запуску. CX Codex ★ 1 029звёзд репо ocaml-expert Субагент ocaml-expert помогает писать, проверять и рефакторить OCaml-код с опорой на типовую систему, функциональный стиль и анализ производительности. CX Codex ★ 1 029звёзд репо tauri-expert Субагент tauri-expert для Tauri-приложений: разбирает конфигурацию, команды Rust, IPC и фронтенд, проверяет сборку по чек-листу. CX Codex ★ 1 029звёзд репо fastify-expert Субагент fastify-expert настраивает бэкенд на Fastify, описывает схемы валидации и управляет хуками жизненного цикла. Пригодится при сборке модульных API на Node.js. CX Codex ★ 1 029звёзд репо laravel-expert Субагент laravel-expert для Claude Code помогает разбирать Laravel-код, запросы Eloquent и тесты. Подключается к задачам по оптимизации, отладке и рефакторингу Laravel-проектов. CX Codex ★ 1 029звёзд репо prometheus-expert Субагент prometheus-expert для Claude Code помогает настраивать мониторинг в Prometheus: писать метрики, составлять запросы PromQL и подключать алерты. CX Codex ★ 1 029звёзд репо sns-expert Субагент sns-expert помогает проектировать и настраивать Amazon SNS: темы, подписки, фильтрацию сообщений и доступ. Подключайте его к задачам маршрутизации уведомлений и интеграций с AWS Lambda или SQS. CX Codex ★ 1 029звёзд репо owasp-top10-expert Субагент owasp-top10-expert для Claude, который проходит код и конфигурацию по десяти категориям OWASP Top 10 и выдаёт отчёт с рисками и способами их закрыть. CX Codex ★ 1 029звёзд репо

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

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