CDN 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"}
- Общие сведения
- Суммарные данные
- Группировка данных
- Группировка данных с учетом времени