tocdepth

2

API статистики по потокам

Общие сведения

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

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

  • Язык ответа определяется в первую очередь из строки запроса language. Если не задан, то из заголовка запроса Accept-Language. Если оба значения не заданы, то выбирается английский. Язык, в котором вернулся ответ, будет записан в заголовок ответа Accept-Language.

  • Авторизационный токен определяется в первую очередь из строки запроса cdnauthtoken. Если не задан, то из заголовка запроса cdn-auth-token. Если оба не заданы, то вернется ошибка.

  • Значение даты (start, end) использует стандарт ISO8601 в формате UTC с нулевыми секундами. Например, 2020-08-01T00:00:00Z или 2020-08-01T00:00:00.

  • Для указания времени в запросе должен быть задан start и end.

  • Значения country и region являются кодами. Если они присутствуют в ответе, то вместе с ним передается значения country_name и region_name, которые возвращают названия страны и региона в читаемом виде в языке, который был выбран.

  • Для фильтра по региону необходимо указать страну.

  • Для фильтра по потоку необходимо указать аккаунт.

  • Аргумент offset можно указать только вместе с limit.

  • С помощью параметра sort можно задать объект и способ сортировки. Параметр sort имеет вид: [+-]{field} (например, сортировка по убыванию уникальных пользователей -users).

  • Разбиение (granularity) имеет формат ISO 8601. Доступные значения: PT1M, PT5M, PT15M, PT1H, P1D, P1W, P1M, P1Y.

  • Локаль представлена в возвращаемом заголовке Accept-Language и соответствует спецификации RFC 7231. Состоит из двухбуквенного основного языкового тега. Возможные значения: en и ru.

  • В процессе просмотра на устройство пользователя загружаются элементы потока (сегменты). Статистика подсчитывается на основе анализа этих загрузок.

  • User (пользователь) определяется как комбинация (IP-адрес, User-Agent).

  • Просмотром потока считается наличие одного или нескольких запросов к узлам CDN на загрузку элементов потока. Если интервалы между запросами не превышают 1 минуту, то это считается одним просмотром.

Описание заголовков запроса:

Имя параметра Описание Обязательный
Accept-Language Локаль Нет
cdn-auth-token Авторизационный токен Да/Нет

Возможные коды ответа:

Код ответа Данные ответа Описание ответа
200 OK успешное выполнение запроса
400 validation fail ошибка валидации
400 sort argument not in fields указанный параметр сортировки не указан в fields
400 start must be less then end start не может быть больше или равен end
400 granularity is not correct некорректное значение granularity
401 token is invalid токен не был указан
401 no accounts available по заданному токену нет доступных аккаунтов
401 account {account} is not available указанный аккаунт не доступен
422 {message} неправильно задан один из передаваемых параметров (message содержит более детальное описание)
429 Too Many Requests слишком много запросов
500 Internal Server Error внутренняя ошибка
504 Gateway Timeout error слишком долгое выполнение запроса

Описание параметров ответа:

Имя параметра Описание
views Количество просмотров. Равно сумме просмотров, которые наблюдались в данном интервале времени
users Количество уникальных пользователей, просматривавших поток в данном интервале времени
views_max Пиковое количество одновременных просмотров, наблюдавшееся в данном интервале времени

Суммарные данные

URL: https://api.cdn.sber.cloud/app/streamstat/v2/

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&fields=views,users,views_max&account=account'

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

{
    "views": 631185,
    "users": 59337,
    "views_max": 9426,
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z"
}

Группировка данных

Потоки

URL: https://api.cdn.sber.cloud/app/streamstat/v2/streams

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/streams?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "account": "account",
            "views": 6737,
            "users": 5382,
            "views_max": 356,
            "stream": "stream_name1"
        },
        {
            "account": "account",
            "views": 6438,
            "users": 5145,
            "views_max": 343,
            "stream": "stream_name2"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Аккаунты

URL: https://api.cdn.sber.cloud/app/streamstat/v2/accounts

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/accounts?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max'

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

{
    "result": [
        {
            "views": 281509,
            "users": 28160,
            "views_max": 56359,
            "account": "account1"
        },
        {
            "views": 75720,
            "users": 29770,
            "views_max": 12300,
            "account": "account2"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Браузеры

URL: https://api.cdn.sber.cloud/app/streamstat/v2/browsers

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/browsers?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 477309,
            "users": 16346,
            "views_max": 8057,
            "browser": "AndroidBrowser"
        },
        {
            "views": 145386,
            "users": 41285,
            "views_max": 1287,
            "browser": "TV"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Платформы

URL: https://api.cdn.sber.cloud/app/streamstat/v2/platforms

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/platforms?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 772199,
            "users": 20384,
            "views_max": 9229,
            "platform": "Android"
        },
        {
            "views": 235102,
            "users": 63074,
            "views_max": 1439,
            "platform": "iOS"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Страны

URL: https://api.cdn.sber.cloud/app/streamstat/v2/countries

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/countries?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 1032159,
            "users": 84212,
            "views_max": 10871,
            "country": "RU",
            "country_name": "Russia"
        },
        {
            "views": 7,
            "users": 2,
            "views_max": 7,
            "country": "GB",
            "country_name": "United Kingdom"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Регионы

URL: https://api.cdn.sber.cloud/app/streamstat/v2/regions

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/regions?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 250940,
            "users": 28756,
            "views_max": 3911,
            "country": "RU",
            "region": "48",
            "country_name": "Russia",
            "region_name": "Moscow"
        },
        {
            "views": 88396,
            "users": 9042,
            "views_max": 1559,
            "country": "RU",
            "region": "71",
            "country_name": "Russia",
            "region_name": "Sverdlovsk"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Интервалы времени

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да/
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "views": 96352,
            "users": 10483,
            "views_max": 9426,
            "start": "2020-08-01T15:00:00Z",
            "end": "2020-08-01T16:00:00Z"
        },
        {
            "views": 92464,
            "users": 9573,
            "views_max": 9009,
            "start": "2020-08-01T14:00:00Z",
            "end": "2020-08-01T15:00:00Z"
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Группировка данных с учетом времени

Потоки

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times/streams

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times/streams?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T15:00:00Z",
            "end": "2020-08-01T16:00:00Z",
            "result": [
                {
                    "account": "account",
                    "views": 1576,
                    "users": 1396,
                    "views_max": 272,
                    "stream": "stream_name1"
                },
                {
                    "account": "account",
                    "views": 1558,
                    "users": 1374,
                    "views_max": 260,
                    "stream": "stream_name2"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Аккаунты

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times/accounts

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times/accounts?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H'

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

{
    "result": [
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 56359,
                    "users": 11171,
                    "views_max": 56359,
                    "account": "account1"
                }
            ]
        },
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 49772,
                    "users": 10646,
                    "views_max": 49772,
                    "account": "account2"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Браузеры

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times/browsers

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times/browsers?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T15:00:00Z",
            "end": "2020-08-01T16:00:00Z",
            "result": [
                {
                    "views": 74535,
                    "users": 3931,
                    "views_max": 8057,
                    "browser": "AndroidBrowser"
                }
            ]
        },
        {
            "start": "2020-08-01T14:00:00Z",
            "end": "2020-08-01T15:00:00Z",
            "result": [
                {
                    "views": 72059,
                    "users": 3868,
                    "views_max": 7893,
                    "browser": "AndroidBrowser"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Платформы

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times/platforms

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times/platforms?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 80156,
                    "users": 4379,
                    "views_max": 9163,
                    "platform": "Android"
                }
            ]
        },
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 75559,
                    "users": 4203,
                    "views_max": 9229,
                    "platform": "Android"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Страны

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times/countries

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times/countries?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 105294,
                    "users": 12113,
                    "views_max": 10764,
                    "country": "RU",
                    "country_name": "Russia"
                }
            ]
        },
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 98352,
                    "users": 10583,
                    "views_max": 10871,
                    "country": "RU",
                    "country_name": "Russia"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Регионы

URL: https://api.cdn.sber.cloud/app/streamstat/v2/times/regions

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdn.sber.cloud/app/streamstat/v2/times/regions?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 45884,
                    "users": 5163,
                    "views_max": 5134,
                    "country": "RU",
                    "region": "48",
                    "country_name": "Russia",
                    "region_name": "Moscow"
                }
            ]
        },
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 42318,
                    "users": 5825,
                    "views_max": 4060,
                    "country": "RU",
                    "region": "48",
                    "country_name": "Russia",
                    "region_name": "Moscow"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}
Запустили Evolution free tier
для Dev & Test
Получить