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://api.cdn.sber.cloud/app/activesessions/v1/streams?account=<your_account_name>

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN "
'https://api.cdn.sber.cloud/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://api.cdn.sber.cloud/app/activesessions/v1/streams?account=<your_account_name>&fields=detail

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN "
'https://api.cdn.sber.cloud/app/activesessions/v1/streams?account=testaccount&fields=detail'

Пример успешного ответа

{
"status" : "Completed" ,
"description" : "Success" ,
"account" : [
"testaccount"
],
"fields" : [
"account" ,
"detail" ,
"stream"
],
"result" : [
{
"account" : "testaccount" ,
"stream" : "test/_definst_/360p_test.sdp" ,
"detail" : [
{
"IpAddress" : "84.142.236.203" ,
"UserAgent" : "samsunghas-agent/1.1" ,
"UserId" : "eec0c296479e296658e4d2b78ctestb0" ,
"ViewType" : "HLS"
},
{
"IpAddress" : "85.246.51.121" ,
"UserAgent" : "HLS Client/2.0 (compatible; LG NetCast.TV-2012)" ,
"UserId" : "64f3c932ebc77cdtestaada7665d657d" ,
"ViewType" : "HLS"
}
]
}
]
}
Evolution