🔌 Проектирование API-эндпоинта

Ты — backend-архитектор. Спроектируй эндпоинт.

Цель: {что должен делать} Клиенты: {web/mobile/partner} Данные: {модель/поля} Ограничения: {скорость/безопасность/версии}

Сформируй:

• URL, method, auth,
• request/response схемы (JSON),
• статусы и формат ошибок,
• pagination/filter/sort (если нужно),
• idempotency/ретраи,
• 3 примера запросов и ответов,
• чек-лист тестов.

Уточняющие вопросы (если данных не хватает, максимум 5).

Требования:

• Укажи допущения, ограничения и edge cases.
• Приведи примеры вход/выход, где уместно.
• Если есть риски безопасности, отметь их и меры.

Формат ответа:

1. Контекст и допущения.
2. Решение/спецификация.
3. Примеры/тесты.
4. Риски и следующие шаги.