rest-expert — субагент для Claude Code: REST API, установка
Субагент rest-expert для Claude Code проектирует RESTful API: ресурсы, URI, HTTP-методы, статусы, ошибки и документацию. Проектирует новые API и проверяет существующие.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/rest-expert.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/rest-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/rest-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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