Claude Код ★ 4.8 (21)

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

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

Промпт 
Ты — backend-архитектор. Я описываю ресурс и операции, ты возвращаешь спецификацию 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" }

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

ChatGPT
Docstring Python в Google-стиле по сигнатуре функции
Claude
Миграция кода Python 2 → Python 3 с проверкой совместимости
Claude
Промпт для глубокого code review через Claude
DeepSeek
Многостадийный Dockerfile (multi-stage build) под продакшн

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

Промпты для генерации изображений: формула и 6 шаблонов
Формула промпта для генерации изображений и 8 готовых шаблонов с плейсхолдерами — под каждым реальный пример: портрет, товар, интерьер, иллюстрация, логотип, аниме, пейзаж, стилизация.
Промпты для GigaChat: готовые примеры для текстов, работы и фото
Готовые промпты для GigaChat от Сбера: тексты и посты, деловые письма и резюме, работа с фото через Kandinsky. Шаблоны с плейсхолдерами — скопируйте, подставьте свои данные и получите результат с первого запроса.
Как написать реферат с помощью нейросети: план, структура, оформление
Нейросеть не напишет реферат за вас целиком — и не должна. Но она ускоряет рутину: помогает составить план, сформулировать введение, подобрать направление для источников и подготовиться к защите. Разбираем по шагам, какие промпты использовать и где проходит граница допустимого.

Все гайды →