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

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

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

### [**Сеансы прыжков**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md)

* **Конечная точка:** [`GET /jumping/sessions/{session_id}/`](/ru/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md#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/**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/jumping.md#jumping-sessions-session_id-export)\
Экспортирует полные данные о сеансе прыжков. Эта конечная точка предоставляет ключевые точки, данные об углах и другие метрики, полезные для глубокого анализа.

***

### [**Сеансы бега**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/running.md)

* **Конечная точка:** [`GET /running/sessions/{session_id}/`](/ru/api-documentation/developer-resources-and-api-reference/api-reference/running.md#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/**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/running.md#running-sessions-session_id-export)\
  Экспортирует данные о сеансе бега для дальнейшего анализа. Включает ключевые точки, углы, временные метки и дополнительные метрики производительности.
* [**GET /sessions/{session\_id}/analyzed-video/**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md#session-management-sessions-session_id-analyzed-video)\
  Получает URL проанализированного видео. Если видео еще недоступно, эта конечная точка может инициировать его генерацию.

***

### [**Сеансы тяжелой атлетики**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md)

* **Конечная точка:** [`GET /weightlifting/sessions/{session_id}/`](/ru/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#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/**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id-export)\
  Экспортирует данные о сеансе тяжелой атлетики, включая ключевые точки, углы, временные метки и числовые метрики.
* [**GET /weightlifting/sessions/{session\_id}/lift-analysis/**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/weightlifting.md#weightlifting-sessions-session_id-lift-analysis)\
  Получает подробные изображения анализа и рекомендации для подъема. Эта конечная точка возвращает результаты анализа на нескольких языках для дальнейшего рассмотрения.

***

### [**Управление сеансами — Проанализированное видео**](/ru/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md)

* **Конечная точка:** [`GET /session-management/sessions/{session_id}/analyzed-video/`](/ru/api-documentation/developer-resources-and-api-reference/api-reference/analyzed-video.md#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 с четким сообщением об ошибке.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aikynetix.app/ru/api-documentation/retrieving-processed-videos/retrieval-api-endpoints.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
