Анализированное видео

Запросы GET и POST для получения ссылки на проанализированное видео

Получить URL анализированного видео

get

Получает URL анализированного видео для конкретной сессии или пытается создать его, если он не существует.

Параметр пути

• session_id (строка, обязательно): Уникальный идентификатор сессии.

Параметры запроса

Эти необязательные флаги определяют тип анализа, если видео не существует:

• is_jump (логический, опционально): Указывает, является ли эта сессия для анализа прыжка.

• is_weight (логический, опционально): Указывает, является ли эта сессия для анализа тяжелой атлетики.

• download (логический, опционально): Если true, возвращает подписанный URL, который заставляет браузер скачать видео вместо его отображения.

Ответ (HTTP 200)

Возвращает JSON-объект с ключом analyzed_video_url при успехе:

  "analyzed_video_url": "https://storage.googleapis.com/.../analyzed_video.mp4"
} ```
### Обработка ошибок
- **400 Bad Request**: Некорректные параметры (например, отсутствующий или неверный UID администратора).
- **401 Unauthorized**: Токен отсутствует или недействителен.
- **403 Forbidden**: У пользователя нет необходимых прав или плана.
- **404 Not Found**: Данные сессии или ресурсы не найдены.
- **500 Internal Server Error**: Непредвиденная ошибка на сервере.
### Безопасность
В заголовке `Authorization` должен быть указан действительный API-KEY токен.

Authorizations

BearerApiKeyAuth

AuthorizationstringRequired

Укажите ваш Bearer-токен (Firebase auth) в формате: Bearer <токен>

Path parameters

session_idanyRequired

Query parameters

is_jumpbooleanOptional

Указывает, является ли эта сессия для анализа прыжка.

is_weightbooleanOptional

Указывает, является ли эта сессия для анализа тяжелой атлетики.

downloadbooleanOptional

Если true, возвращает подписанный URL, который заставляет скачать видео.

Responses

200

URL анализированного видео успешно получен.

application/json

analyzed_video_urlstring · uriOptional

URL анализированного видео.

400

Bad Request - Возможно, некорректные параметры.

application/json

401

Unauthorized - Токен недействителен или отсутствует.

application/json

403

Forbidden - У пользователя нет прав или плана.

application/json

404

Not Found - Данные сессии или ресурс не найдены.

application/json

500

Internal Server Error - Ошибка на сервере.

application/json

get

/session-management/sessions/{session_id}/analyzed-video/

HTTPcURLJavaScriptPython

GET /session-management/sessions/{session_id}/analyzed-video/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Accept: */*

{
  "analyzed_video_url": "https://example.com"
}

Загрузить/сгенерировать анализированное видео

post

Загружает или генерирует анализированное видео для конкретной сессии, возвращая его URL.

Параметр пути

• session_id (строка, обязательно): Уникальный идентификатор сессии.

Тело запроса (JSON)

  "is_jump": true,
  "is_weight": false
} ```
- **is_jump** *(логический, опционально)*: Если true, обрабатывать как сессию прыжка.
- **is_weight** *(логический, опционально)*: Если true, обрабатывать как сессию тяжелой атлетики.
### Структура ответа (HTTP 200)
При успехе возвращает JSON-объект с `analyzed_video_url`:
```json {
  "analyzed_video_url": "https://storage.googleapis.com/.../analyzed_video.mp4"
} ```
### Обработка ошибок
- **400 Bad Request**: Некорректные параметры или сессия уже анализирована.
- **401 Unauthorized**: Токен отсутствует или недействителен.
- **403 Forbidden**: У пользователя нет действительного плана.
- **404 Not Found**: Данные сессии не найдены.
- **500 Internal Server Error**: Непредвиденная ошибка на сервере.
### Безопасность
В заголовке `Authorization` должен быть указан действительный API-KEY токен.

Authorizations

BearerApiKeyAuth

AuthorizationstringRequired

Укажите ваш Bearer-токен (Firebase auth) в формате: Bearer <токен>

Path parameters

session_idanyRequired

Body

application/json

is_jumpbooleanOptional

Является ли эта сессия связанной с прыжками.

is_weightbooleanOptional

Является ли эта сессия связанной с тяжелой атлетикой.

Responses

200

URL анализированного видео успешно сгенерирован или обновлен.

application/json

analyzed_video_urlstring · uriOptional

URL нового или обновленного анализированного видео.

400

Bad Request - Возможно, некорректные данные сессии или видео уже анализировано.

application/json

401

Unauthorized - Токен отсутствует или недействителен.

application/json

403

Forbidden - У пользователя нет действительного платежного плана.

application/json

404

Not Found - Сессия не найдена или создание не удалось.

application/json

500

Internal Server Error - Ошибка на сервере.

application/json

post

/session-management/sessions/{session_id}/analyzed-video/

HTTPcURLJavaScriptPython

POST /session-management/sessions/{session_id}/analyzed-video/ HTTP/1.1
Host: api.aikynetix.app
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "is_jump": true,
  "is_weight": false
}

{
  "analyzed_video_url": "https://example.com"
}