🎮 Tamagotchi API (1.0.0)

Современный API для игры-тамагочи с системой управления стрессом и тревожностью.

API использует JWT Bearer токены для аутентификации.

После успешного логина или регистрации вы получите токен:

Authorization: Bearer YOUR_JWT_TOKEN

Все ответы API имеют единообразную структуру:

{
  "success": true,
  "message": "Операция выполнена успешно",
  "data": {
    // Данные ответа
  },
  "player_state": {
    // 🎮 СТАНДАРТИЗИРОВАННЫЙ ОБЪЕКТ ИГРОКА
    // Присутствует во ВСЕХ эндпоинтах (кроме auth)
    "id": 123,
    "level": 5,
    "experience": {...},
    "energy": {...},
    "stress": {...}
    // Полное описание см. ниже
  }
}

При ошибках валидации:

{
  "success": false,
  "message": "Ошибки валидации", 
  "errors": {
    "email": ["Введите корректный email"],
    "password": ["Пароль слишком короткий"]
  }
}

Объект player_state присутствует во ВСЕХ API ответах (кроме auth). Фронтенд получает полное состояние игрока в каждом запросе:

{
  "success": true,
  "data": { ... },
  "player_state": {
    "level": 5,
    "energy": { "current": 120, "percentage": 60.0, "status": {"color": "#2196F3"} },
    "stress": { "current": 35, "level": {"value": "normal", "color": "#2196F3"} },
    "capabilities": { "can_perform_micro_actions": true, "can_start_situations": true }
  }
}

🆔 Базовая информация

• id - Уникальный ID профиля игрока (integer)
• user_id - ID пользователя-владельца профиля (integer)
• level - Текущий уровень игрока (integer, min: 1)

⭐ Система опыта (experience)

• total - Общее количество опыта за всё время (integer, min: 0)
• current_level - Опыт в пределах текущего уровня, 0-99 (integer)
• to_next_level - Сколько опыта нужно до следующего уровня (integer, 1-100)
• progress_percentage - Процент прогресса до следующего уровня (float, 0-100)

⚡ Система энергии (energy)

• current - Текущее количество энергии (integer, 0-200)
• max - Максимальное количество энергии (integer, всегда 200)
• percentage - Процент от максимальной энергии (float, 0-100)
• status.level - Уровень энергии для UI:
  • "critical" (0-24%) - 🔴 Красный, игрок не может выполнять действия
  • "low" (25-49%) - 🟠 Оранжевый, ограниченные возможности
  • "medium" (50-74%) - 🔵 Синий, нормальное состояние
  • "high" (75-100%) - 🟢 Зеленый, отличное состояние
• status.label - Текстовое описание для UI (string)
• status.color - HEX цвет для индикаторов (string, например "#2196F3")

😰 Система стресса (stress)

• current - Текущий уровень стресса (integer, 0-100)
• percentage - Стресс в процентах (float, 0-100)
• level.value - Категория стресса для логики:
  • "low" (0-20) - 🟢 Спокойное состояние, можно браться за сложные задачи
  • "normal" (21-50) - 🔵 Обычное состояние, всё под контролем
  • "elevated" (51-80) - 🟠 Повышенная тревожность, нужна релаксация
  • "high" (81-100) - 🔴 Высокий стресс, срочно нужен отдых
• level.label - Русское название уровня стресса (string)
• level.color - HEX цвет для UI индикаторов (string)
• level.recommended_actions - Массив рекомендаций (array of strings)

😟 Тревожность (anxiety)

• current - Текущий уровень тревожности (integer, 0-100)
• percentage - Тревожность в процентах (float, 0-100)

🕐 Активность игрока (activity)

• last_login - Время последнего входа (ISO 8601 datetime)
• consecutive_days - Количество дней подряд в игре (integer, min: 0)
• can_claim_daily_reward - Можно ли получить ежедневную награду (boolean)

🎮 Возможности игрока (capabilities)

• can_perform_micro_actions - Может ли выполнять микродействия (boolean)
  • true если energy >= 10
  • Для UI: если false - кнопки микродействий неактивны, показать "Недостаточно энергии"
• can_start_situations - Может ли начинать ситуации (boolean)
  • true если energy >= 20 AND stress <= 80
  • Для UI: если false - показать причину (энергия/стресс) и рекомендации

⏰ Временные метки (timestamps)

• created_at - Дата создания профиля (ISO 8601 datetime)
• updated_at - Дата последнего обновления (ISO 8601 datetime)

🎯 Инструкции для фронтендеров:

• 🎨 Цвета: используйте energy.status.color и stress.level.color для индикаторов
• 🚫 Блокировки: проверяйте capabilities.* для активации/деактивации кнопок
• 📊 Прогресс: experience.progress_percentage для прогресс-баров
• 💡 Рекомендации: stress.level.recommended_actions для подсказок пользователю
• ⚡ Статусы: energy.status.level и stress.level.value для логики UI

1. Зарегистрируйтесь: POST /auth/register
2. Получите токен: Используйте его в заголовке Authorization
3. Исследуйте API: Все эндпоинты доступны с токеном

🎯 Основные возможности:

• 🔐 Полная аутентификация (регистрация, логин, сброс пароля)
• 👤 Управление игроком (профиль, статистика, прогресс)
• 🎭 Игровые ситуации (случайные, по категориям, с выбором решений)
• ⚡ Микродействия (дыхательные упражнения, физическая активность)
• 📊 Аналитика (статистика игры, поведение игроков)
• 👑 Админ-панель (управление контентом, конфигурации)

Регистрация, авторизация и управление аккаунтом

Профиль игрока, статистика и прогресс

Игровые ситуации и их прохождение