Перейти к основному содержимому
Войти

API для инструкторов

Методы API, доступные для роли "instructor".

Аутентификация​

Authorization: Bearer <your-token>

Управление активностями​

Создать активность​

POST /instructor-activities

Открыть в Swagger

Пример запроса:

{
  "name": "Урок горных лыж для начинающих",
  "category": "лыжи",
  "description": "Обучение основам катания на горных лыжах",
  "difficulty_level": "начинающий",
  "duration_minutes": 120,
  "max_participants": 4,
  "base_price": 3000,
  "equipment_included": true,
  "location": "Склон №1"
}

Обновить активность​

PUT /instructor-activities/{id}

Открыть в Swagger

Получить мои активности​

GET /instructor-activities/my

Открыть в Swagger

Удалить активность​

DELETE /instructor-activities/{id}

Открыть в Swagger

Управление расписанием​

Создать слот для занятий​

POST /instructor-schedule

Открыть в Swagger

Пример запроса:

{
  "activity_id": "uuid",
  "date": "2024-07-15",
  "start_time": "10:00",
  "end_time": "12:00",
  "available_spots": 4,
  "price_override": 2500,
  "special_notes": "Хорошие погодные условия"
}

Обновить расписание​

PUT /instructor-schedule/{id}

Открыть в Swagger

Получить расписание​

GET /instructor-schedule/my

Открыть в Swagger

Управление бронированиями​

Просмотр бронирований​

GET /instructor-bookings/my

Открыть в Swagger

Подтвердить бронирование​

PUT /instructor-bookings/{id}/confirm

Создать бронирование инструктора

Генерируется QR-код для подтверждения посещения.

Отменить бронирование​

PUT /instructor-bookings/{id}/cancel

Открыть в Swagger

Отметить завершение занятия​

PUT /instructor-bookings/{id}/complete

Открыть в Swagger

Профиль инструктора​

Получить профиль​

GET /auth/me

Открыть в Swagger

Обновить профиль инструктора​

PUT /instructor-profile

Открыть в Swagger

Пример запроса:

{
  "name": "Алексей Горнов",
  "description": "Сертифицированный инструктор по горным лыжам",
  "specialization": ["горные лыжи", "сноуборд"],
  "certification_level": "международный",
  "experience_years": 8,
  "languages": ["ru", "en"],
  "hourly_rate": 2000,
  "avatar_url": "https://example.com/avatar.jpg"
}

Сертификация и достижения​

Добавить сертификат​

POST /instructor-certificates

Открыть в Swagger

Получить сертификаты​

GET /instructor-certificates/my

Открыть в Swagger

Отзывы и рейтинг​

Просмотр отзывов​

GET /instructor-reviews/my

Открыть в Swagger

Ответить на отзыв​

POST /instructor-reviews/{id}/reply

Открыть в Swagger

Аналитика инструктора​

Статистика занятий​

GET /analytics/instructor

Открыть в Swagger

Ответ включает:

  • Общее количество активностей
  • Количество проведенных занятий
  • Средний рейтинг
  • Общий доход
  • Популярные активности

Анализ загруженности​

Статистика по дням недели и времени суток.

Сезонная активность​

Анализ спроса по сезонам.

Финансы​

Отчет по доходам​

GET /reports/instructor-revenue

Открыть в Swagger

История выплат​

GET /instructor-payouts

Открыть в Swagger

Уведомления​

Получить уведомления​

GET /notifications

Открыть в Swagger

Отметить уведомление как прочитанное​

PUT /notifications/{id}/read

Открыть в Swagger

Дополнительные возможности​

Групповые занятия​

Организация групповых уроков со скидками.

Абонементы​

Создание пакетных предложений для постоянных клиентов.

Специальные программы​

  • Детские группы
  • Программы для взрослых
  • Корпоративные занятия

Оборудование​

Управление инвентарем для занятий:

  • Лыжи и сноуборды
  • Защитная экипировка
  • Специальное снаряжение

Безопасность​

Правила безопасности​

Соблюдение стандартов безопасности при проведении занятий.

Страхование​

Информация о страховании инструкторской деятельности.

Коды ответов​

  • 200 - Успешно
  • 201 - Создано
  • 400 - Неверный запрос
  • 401 - Не авторизован
  • 403 - Доступ запрещен
  • 404 - Не найдено
  • 500 - Ошибка сервера

Полная документация: https://stage.arkhyz-club.ru/docs#/