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 free tier
для Dev & Test
Получить