Конечные точки API для получения

Наша система предоставляет несколько конечных точек, возвращающих детали сеанса — включая URL обработанного (проанализированного) видео. Используйте конечную точку, соответствующую активности вашего сеанса:

A. Конечные точки, специфичные для сеансов

Сеансы прыжков

• Конечная точка: GET /jumping/sessions/{session_id}/

• Описание: Получает подробные данные о сеансе прыжков. Ответ включает analyzed_video_url (публичный URI, указывающий на проанализированное видео) вместе с оригинальным video_url и другими метриками сеанса.

• Пример фрагмента ответа:

{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}

GET /jumping/sessions/{session_id}/export/ Экспортирует полные данные о сеансе прыжков. Эта конечная точка предоставляет ключевые точки, данные об углах и другие метрики, полезные для глубокого анализа.

---

Сеансы бега

• Конечная точка: GET /running/sessions/{session_id}/

• Описание: Возвращает детали сеанса бега. Ответ включает analyzed_video_url вместе с метриками, углами, временными метками и другими соответствующими данными.

• Пример фрагмента ответа:

{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}

• GET /running/sessions/{session_id}/export/ Экспортирует данные о сеансе бега для дальнейшего анализа. Включает ключевые точки, углы, временные метки и дополнительные метрики производительности.

• GET /sessions/{session_id}/analyzed-video/ Получает URL проанализированного видео. Если видео еще недоступно, эта конечная точка может инициировать его генерацию.

---

Сеансы тяжелой атлетики

• Конечная точка: GET /weightlifting/sessions/{session_id}/

• Описание: Получает детали сеанса тяжелой атлетики. В дополнение к специфичным для упражнения метрикам и углам, ответ возвращает analyzed_video_url, показывающий обработанный подъем.

• Пример фрагмента ответа:

{
  "session_id": "abcd1234",
  "analyzed_video_url": "https://storage.googleapis.com/your-bucket/analyzed_video.mp4",
  "video_url": "https://storage.googleapis.com/your-bucket/original_video.mov",
  "created_at": { "date": "05/02/2025", "time": "06:00 PM" },
  ...
}

• GET /weightlifting/sessions/{session_id}/export/ Экспортирует данные о сеансе тяжелой атлетики, включая ключевые точки, углы, временные метки и числовые метрики.

• GET /weightlifting/sessions/{session_id}/lift-analysis/ Получает подробные изображения анализа и рекомендации для подъема. Эта конечная точка возвращает результаты анализа на нескольких языках для дальнейшего рассмотрения.

---

Управление сеансами — Проанализированное видео

• Конечная точка: GET /session-management/sessions/{session_id}/analyzed-video/

• Описание: Эта конечная точка либо извлекает URL проанализированного видео для сеанса (если обработка завершена), либо инициирует процедуру поиска/создания, если видео еще недоступно.

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

GET /session-management/sessions/abcd1234/analyzed-video/ HTTP/1.1
Host: api.example.com
API-KEY: <token>

B. Безопасность и использование

• Аутентификация: Каждый вызов получения требует действительный токен в заголовке API-KEY.

• Контроль доступа: Только аутентифицированные пользователи (с соответствующими привилегиями) могут получать детали сеанса. Неавторизованные запросы возвращают ответ HTTP 401 с четким сообщением об ошибке.