# design-rest-api

Команда design-rest-api задаёт правила проектирования RESTful API на Express.js с версионированием маршрутов, валидацией через Joi и выносом логики в контроллеры.

- команда · `type=command` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI · ★ 3785 у репозитория
- Автор: BuildWithClaude Community
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-commands/commands/design-rest-api.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/buildwithclaude-community-design-rest-api

## Что делает

Команда инструктирует агента строить архитектуру REST API по чётким правилам: выделять сущности и выстраивать версионирование маршрутов вроде `/routes/api/v1/` с промежуточным ПО для авторизации. В качестве примера взят стек Node.js и Express.js, где каждый ресурс вынесен в отдельный модуль маршрутов с вложенными путями.

Для валидации параметров строки запроса и тела сообщения команда предписывает использовать библиотеку Joi. Логика обработки распределяется по контроллерам и сервисам, а промежуточный слой проверки перехватывает ошибки и отдаёт стандартизированный JSON со статусом 400.

Шаблон жёстко ориентирован на Express.js и Joi. Если в проекте используется Fastify или NestJS, сгенерированные файлы придётся переписывать под нужные схемы и декораторы.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add davepoon/buildwithclaude
```
В чате агента (не в терминале):
```text
/plugin install all-commands@buildwithclaude
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/design-rest-api.md` — Вызов — /design-rest-api. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/design-rest-api.md` — Вызов — /prompts:design-rest-api. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/design-rest-api.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/design-rest-api.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-commands/commands/design-rest-api.md

## Когда брать
- спроектировать структуру эндпоинтов и вложенных маршрутов REST API
- настроить схему валидации входящих параметров через Joi
- разделить маршрутизацию, промежуточное ПО и логику контроллеров в Express.js
- стандартизировать ответы при ошибках валидации и пагинации

## Примеры запросов агенту
- Спроектируй REST API для интернет-магазина с ресурсами users и orders по команде design-rest-api
- Опиши структуру маршрутов Express и валидацию через Joi для профиля пользователя с пагинацией

## Похожие
- [rest-api-design](https://affpapa.org/nevibecode/skills/rest-api-design.md) — скилл · 2100 установок
- [rest-api-design-patterns](https://affpapa.org/nevibecode/skills/rest-api-design-patterns.md) — скилл · 527 установок
- [express-rest-api](https://affpapa.org/nevibecode/skills/express-rest-api.md) — скилл · 904 установки
- [api-designer](https://affpapa.org/nevibecode/skills/api-designer.md) — скилл · 7100 установок
- [public-api-design-review](https://affpapa.org/nevibecode/skills/public-api-design-review.md) — скилл · 10200 установок
- [api-design](https://affpapa.org/nevibecode/skills/api-design.md) — скилл · 7500 установок

## Другие версии с тем же именем
- [design-rest-api · davila7](https://affpapa.org/nevibecode/commands/design-rest-api.md) — 559 установок

Из того же набора: [davepoon/buildwithclaude](https://affpapa.org/nevibecode/by/davepoon/buildwithclaude.md) — 235 карточек

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

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