Claude Код 👁 8

Дизайн REST API по best practices — эндпоинты, статусы, версии

REST API: эндпоинты с параметрами и статус-кодами, версионирование, примеры ответов по RFC 7807.

Промпт Запустить → 
Я описываю ресурс и операции, ты возвращаешь спецификацию REST API.

Ресурс: [НАЗВАНИЕ_РЕСУРСА]
Операции: [CRUD/поиск/фильтрация/пагинация]
Ограничения: [роли/rate limit/scopes]

Верни:
1. Список эндпоинтов в формате METHOD /path
2. Для каждого — описание query/body параметров и статус-коды 2xx/4xx/5xx
3. Версионирование (URL vs header — обоснуй выбор)
4. Пример успешного и ошибочного ответа в JSON

Используй стандарты: kebab-case в URL, ISO 8601 для дат, RFC 7807 для ошибок.
Запустить промпт →

Пример результата

GET /api/v1/orders — список (?page, ?status, ?from, ?to) POST /api/v1/orders — создание (body: OrderCreate) GET /api/v1/orders/{id} — детали PATCH /api/v1/orders/{id} — частичное обновление DELETE /api/v1/orders/{id} — отмена (soft delete) GET /orders: 200 | 401 (нет auth) | 429 (rate limit) POST /orders: 201 | 400 (валидация) | 422 (бизнес-правило) Версия в URL: проще миграция, явно видно версию. Ошибка (RFC 7807): { "type": "validation_error", "title": "Bad Request", "status": 400, "detail": "amount must be > 0" }

Похожие промпты

Рефакторинг легаси-модуля в Kimi: карта, план, код по шагам
Kimi
Рефакторинг легаси-модуля в Kimi: карта, план, код по шагам
Kimi
Сайт-визитка с 3D одним промптом — Kimi K3
Claude
Системный промпт для AI Agent ноды n8n — Claude
DeepSeek
Телеграм-бот на n8n в DeepSeek: схема нод, которую можно собрать за вечер

Полезные статьи

Как сделать мультфильм нейросетью по сценарию: промты и замеры
Дипсик и фото: как загрузить, что умеет и почему не грузится
Локальные нейросети для видео: замеры на карте 12 ГБ

Все гайды →