Общие сведения
Данный API используется для получения информации о просмотрах потоков в текущий момент времени.
Описание заголовков запроса:
| Имя заголовка | Описание | Обязательный |
|---|---|---|
| CDN-AUTH-TOKEN | Авторизационный токен | Да |
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| account | Имя аккаунта | Да |
| fields | Поля, значения которых нужно вернуть (views, views_by_type, detail) | Нет |
Описание параметров ответа:
| Имя параметра | Описание |
|---|---|
| status | Статус ответа (Completed, Unauthorized, Forbidden, Error) |
| description | Описание статуса ответа |
| result | Основная информация ответа |
| account | Имя аккаунта |
| stream | Поток |
| views | Количество зрителей |
| views_by_type | Количество зрителей в разбивке по типам просмотра |
| detail | Детальная информация по зрителям |
| IpAddress | IP адрес зрителя |
| UserAgent | Useragent зрителя |
| UserId | ID зрителя |
| ViewType | Тип просмотра |
Возможные коды ответа:
| Код ответа | Описание |
|---|---|
| 200 | OK |
| 400 | Неверный запрос |
| 401 | Не авторизован |
| 403 | Доступ запрещен |
| 500 | Внутренняя ошибка сервера |
| 503 | Сервис недоступен |
Общая статистика
Данный вызов используется для получения общей информации о просмотрах потоков в текущий момент времени.
URL: https://apicdn.rcloud.ru/app/activesessions/v1/streams
- Тип запроса: GET
- Заголовки: CDN-AUTH-TOKEN
- Тип данных ответа: JSON Object
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \ 'https://apicdn.rcloud.ru/app/activesessions/v1/streams?account=testaccount'
...
{ "status": "Completed", "description": "Success", "account": [ "testaccount" ], "fields": [ "account", "stream", "views", "views_by_type" ], "result": [ { "account": "testaccount", "stream": "test/_definst_/360p_test.sdp", "views_by_type": { "HLS": 8 }, "views": 8 }, { "account": "testaccount", "stream": "test/_definst_/720p_test.sdp", "views_by_type": { "HLS": 7 }, "views": 7 } ] }
Детальная статистика
Данный вызов используется для получения детальной информации о просмотрах потоков в текущий момент времени.
URL: https://apicdn.rcloud.ru/app/activesessions/v1/streams?account=<your_account_name>&fields=detail
- Тип запроса: GET
- Заголовки: CDN-AUTH-TOKEN
- Тип данных ответа: JSON Object
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \ 'https://apicdn.rcloud.ru/app/activesessions/v1/streams?account=testaccount&fields=detail'
...