srv-img CDN

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" 
           } 
         ] 
       } 
     ] 
   }
Была ли статья полезной ?
Предыдущая статья
API realtime статистики по полосе
Следующая статья
API статистики сервиса оптимизации изображений
/ DOCS
Evolution