Общие сведения
На этой странице
Тип запроса: GET
Тип данных ответа: JSON
Язык ответа определяется в первую очередь из строки запроса language. Если не задан, то из заголовка запроса Accept-Language. Если оба значения не заданы, то выбирается английский. Язык, в котором вернулся ответ, будет записан в заголовок ответа Accept-Language.
Авторизационный токен определяется в первую очередь из строки запроса cdnauthtoken. Если не задан, то из заголовка запроса cdn-auth-token. Если оба не заданы, то вернется ошибка.
Значение даты (start, end) передается в виде: год-месяц-деньTчасы:минуты:секунды, где секунды должны быть равны 00. Указывается в UTC. Пример, 2020-02-11T12:30:00
Значения country и region являются кодами. Если они присутствуют в ответе, то вместе с ним передается значения country_name и region_name, которые возвращают названия страны и региона в читаемом виде в языке, который был выбран.
С помощью параметра sort можно задать объект и способ сортировки. Параметр sort имеет вид: [+-]{field} (например, сортировка по убыванию трафика -traffic).
Разбиение (granularity) имеет формат: упрощенную версию P[n]Y[n]M[n]DT[n]H[n]M[n]S (P1M, PT5M, но не P1DT12H).
Описание заголовков запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
Accept-Language | Локаль | Нет |
cdn-auth-token | Авторизационный токен | Да/Нет |
Возможные коды ответа:
Код ответа | Данные ответа | Описание ответа |
---|---|---|
200 | OK | успешное выполнение запроса |
401 | token is invalid | токен не был указан |
401 | no accounts available | по заданному токену нет доступных аккаунтов |
401 | account {account} is not available | указанный аккаунт не доступен |
400 | unknown path | указанного пути нет |
400 | required key {req} not in query string | для данного пути не был указан обязательный параметр |
400 | required key {req} for {req for} not in query string | для определенного параметра не был указан обязательный параметр |
400 | {arg} is not possible query argument | неизвестный параметр |
400 | {arg} is invalid query argument | параметр имеет некорректное значение |
400 | {arg} is invalid query argument (possible values: {possible values}) | параметр имеет некорректное значение |
400 | start must be less then end | start не может быть больше или равен end |
400 | granularity is not correct | некорректное значение granularity |
429 | Too Many Requests | слишком много запросов |
500 | Internal Server Error | неизвестная ошибка |
504 | Gateway Timeout error | слишком долгое выполнение запроса |
Описание параметров ответа:
Имя параметра | Описание |
---|---|
traffic | Общий трафик (в байтах) |
cache_ratio | Процент выдачи из кеша (от 0 до 1 без округления) |
hits | Количество подключений |
bandwidth | Пиковая скорость (в бит/сек) |
Суммарные данные
URL: https://api.cdn.sber.cloud/app/statistic/v3/
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&code=200&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"code" : "200" ,"account" : "account" ,"hits" : 2104772 ,"traffic" : 40603470765 ,"cache_ratio" : 0.8231922443391645 ,"bandwidth" : 5612541}
Группировка данных
Метки
URL: https://api.cdn.sber.cloud/app/statistic/v3/customs
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/customs?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"custom" : "Empty" ,"hits" : 2104772 ,"traffic" : 40603470765 ,"cache_ratio" : 0.8231922443391645 ,"bandwidth" : 5612541}]}
Рефереры
URL: https://api.cdn.sber.cloud/app/statistic/v3/referrers
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/referrers?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"referrer" : "bbs.site.com" ,"hits" : 4 ,"traffic" : 271892 ,"cache_ratio" : 0 ,"bandwidth" : 36252},{"referrer" : "m.site.com" ,"hits" : 1036 ,"traffic" : 143807741 ,"cache_ratio" : 0.9638908033469492 ,"bandwidth" : 423878},...]}
Коды ответа
URL: https://api.cdn.sber.cloud/app/statistic/v3/codes
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/codes?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"code" : 200 ,"hits" : 2057042 ,"traffic" : 40551420934 ,"cache_ratio" : 0.8230137369124231 ,"bandwidth" : 5612518},{"code" : 206 ,"hits" : 540 ,"traffic" : 43568848 ,"cache_ratio" : 0.9719663232775858 ,"bandwidth" : 231773},{"code" : 304 ,"hits" : 46079 ,"traffic" : 8040265 ,"cache_ratio" : 0.9624426558079864 ,"bandwidth" : 603},...]}
Регионы
URL: https://api.cdn.sber.cloud/app/statistic/v3/regions
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/regions?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"country" : "KZ" ,"region" : "02" ,"hits" : 61 ,"traffic" : 1014350 ,"cache_ratio" : 0.4619707201656233 ,"bandwidth" : 47076 ,"country_name" : "Kazakhstan" ,"region_name" : "Almaty"},{"country" : "CN" ,"region" : "11" ,"hits" : 64930 ,"traffic" : 794182327 ,"cache_ratio" : 0.9765737333009175 ,"bandwidth" : 373489 ,"country_name" : "People's Republic of China" ,"region_name" : "Hunan Province"},...]}
Браузеры
URL: https://api.cdn.sber.cloud/app/statistic/v3/browsers
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/browsers?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"browser" : "AndroidBrowser" ,"hits" : 10240 ,"traffic" : 425445359 ,"cache_ratio" : 0.8885248645995925 ,"bandwidth" : 405949},{"browser" : "UC Browser" ,"hits" : 3639 ,"traffic" : 294130341 ,"cache_ratio" : 0.8235374636171927 ,"bandwidth" : 667600},...]}
Платформы
URL: https://api.cdn.sber.cloud/app/statistic/v3/platforms
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/platforms?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"platform" : "ChromeOS" ,"hits" : 1 ,"traffic" : 182095 ,"cache_ratio" : 1 ,"bandwidth" : 24279},{"platform" : "iOS" ,"hits" : 148418 ,"traffic" : 2307262894 ,"cache_ratio" : 0.961626801943446 ,"bandwidth" : 850371},...]}
Ресурсы
URL: https://api.cdn.sber.cloud/app/statistic/v3/resources
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Да |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/resources?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"resource" : "l36fqysvkx" ,"hits" : 2104772 ,"traffic" : 40603470765 ,"cache_ratio" : 0.8231922443391645 ,"bandwidth" : 5612541 ,"resource_name" : "name"}]}
Хосты
URL: https://api.cdn.sber.cloud/app/statistic/v3/hosts
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Да |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/hosts?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"host" : "cdn3.img.site.cn" ,"hits" : 2103176 ,"traffic" : 40497105719 ,"cache_ratio" : 0.8229884518478865 ,"bandwidth" : 5612541},{"host" : "l36sdfyzlkx.a.trbcdn.net" ,"hits" : 1596 ,"traffic" : 106365046 ,"cache_ratio" : 0.9007835807263225 ,"bandwidth" : 80317},]}
Пути
URL: https://api.cdn.sber.cloud/app/statistic/v3/paths
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Да |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Да |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/paths?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account&host=cdn3.img.site.cn'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"host" : "cdn3.img.site.cn" ,"result" : [{"path" : "/images/102519/05/1025190554.jpg" ,"hits" : 8 ,"traffic" : 947264 ,"cache_ratio" : 0.875 ,"bandwidth" : 31575},{"path" : "/images/102167/96/1021679638.jpg" ,"hits" : 1 ,"traffic" : 119581 ,"cache_ratio" : 1 ,"bandwidth" : 15944},...]}
Страны
URL: https://api.cdn.sber.cloud/app/statistic/v3/countries
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/countries?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"country" : "GB" ,"hits" : 2 ,"traffic" : 268648 ,"cache_ratio" : 0.668547690658408 ,"bandwidth" : 23947 ,"country_name" : "United Kingdom"},{"country" : "KR" ,"hits" : 6 ,"traffic" : 417296 ,"cache_ratio" : 1 ,"bandwidth" : 31848 ,"country_name" : "South Korea"},...]}
Аккаунты
URL: https://api.cdn.sber.cloud/app/statistic/v3/accounts
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/accounts?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"account" : "account" ,"result" : [{"account" : "account" ,"hits" : 2104772 ,"traffic" : 40603470765 ,"cache_ratio" : 0.8231922443391645 ,"bandwidth" : 5612541}]}
Время
URL: https://api.cdn.sber.cloud/app/statistic/v3/times
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"hits" : 194399 ,"traffic" : 2393556992 ,"cache_ratio" : 0.9263462990063618 ,"bandwidth" : 2088376},{"start" : "2019-08-02T00:00:00" ,"end" : "2019-08-03T00:00:00" ,"hits" : 255208 ,"traffic" : 3823467560 ,"cache_ratio" : 0.9046492924867394 ,"bandwidth" : 5299504},...]}
Группировка данных с учетом времени
Метки
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/customs
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/customs?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"custom" : "Empty" ,"hits" : 194399 ,"traffic" : 2393556992 ,"cache_ratio" : 0.9263462990063618 ,"bandwidth" : 2088376}]},{"start" : "2019-08-02T00:00:00" ,"end" : "2019-08-03T00:00:00" ,"result" : [{"custom" : "Empty" ,"hits" : 255208 ,"traffic" : 3823467560 ,"cache_ratio" : 0.9046492924867394 ,"bandwidth" : 5299504}]},...]}
Рефереры
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/referrers
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/referrers?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"referrer" : "site.com" ,"hits" : 11 ,"traffic" : 1064740 ,"cache_ratio" : 1 ,"bandwidth" : 56634},{"referrer" : "club.site.net" ,"hits" : 3 ,"traffic" : 139472 ,"cache_ratio" : 1 ,"bandwidth" : 13992},...]},...]}
Коды ответа
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/codes
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/codes?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"code" : 404 ,"hits" : 81 ,"traffic" : 30684 ,"cache_ratio" : 0 ,"bandwidth" : 1340},{"code" : 200 ,"hits" : 192882 ,"traffic" : 2393162042 ,"cache_ratio" : 0.9263477491675843 ,"bandwidth" : 2088353},...]},...]}
Регионы
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/regions
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/regions?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"country" : "UA" ,"region" : "17" ,"hits" : 1 ,"traffic" : 144295 ,"cache_ratio" : 0 ,"bandwidth" : 19239 ,"country_name" : "Ukraine" ,"region_name" : "Odessa Oblast"},{"country" : "RU" ,"region" : "65" ,"hits" : 1 ,"traffic" : 121598 ,"cache_ratio" : 0 ,"bandwidth" : 16213 ,"country_name" : "Russia" ,"region_name" : ""},...]},...]}
Браузеры
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/browsers
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/browsers?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"browser" : "Maxthon Browser" ,"hits" : 7 ,"traffic" : 433197 ,"cache_ratio" : 1 ,"bandwidth" : 21010},{"browser" : "Safari" ,"hits" : 145 ,"traffic" : 13990289 ,"cache_ratio" : 0.9408025809902855 ,"bandwidth" : 302202},...]},...]}
Платформы
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/platforms
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/platforms?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"platform" : "Windows" ,"hits" : 3 ,"traffic" : 107880 ,"cache_ratio" : 1 ,"bandwidth" : 14272},{"platform" : "Windows 8.0" ,"hits" : 1 ,"traffic" : 23184 ,"cache_ratio" : 1 ,"bandwidth" : 3091},...]},...]}
Ресурсы
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/resources
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Да |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/resources?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"resource" : "l36fqysvkx" ,"hits" : 194399 ,"traffic" : 2393556992 ,"cache_ratio" : 0.9263462990063618 ,"bandwidth" : 2088376 ,"resource_name" : "name"}]},{"start" : "2019-08-02T00:00:00" ,"end" : "2019-08-03T00:00:00" ,"result" : [{"resource" : "l36fqysvkx" ,"hits" : 255208 ,"traffic" : 3823467560 ,"cache_ratio" : 0.9046492924867394 ,"bandwidth" : 5299504 ,"resource_name" : "name"}]},...]}
Хосты
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/hosts
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Да |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/hosts?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"host" : "l36sdfyzlkx.a.trbcdn.net" ,"hits" : 46 ,"traffic" : 2884615 ,"cache_ratio" : 0.8728790497172066 ,"bandwidth" : 33997},{"host" : "cdn3.img.site.cn" ,"hits" : 194353 ,"traffic" : 2390672377 ,"cache_ratio" : 0.9264108132538146 ,"bandwidth" : 2088376}]},...]}
Пути
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/paths
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Да |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Да |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/paths?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account&host=cdn3.img.site.cn'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"host" : "cdn3.img.site.cn" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"path" : "/images/102686/65/1026866540.png" ,"hits" : 1 ,"traffic" : 175 ,"cache_ratio" : 1 ,"bandwidth" : 23},{"path" : "/images/101735/33/1017353398.jpg" ,"hits" : 1 ,"traffic" : 60231 ,"cache_ratio" : 1 ,"bandwidth" : 8030},...]},...]}
Страны
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/countries
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
host | host часть URL | Нет |
path | path часть URL | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
resource | Идентификатор ресурса | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/countries?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"country" : "HK" ,"hits" : 4 ,"traffic" : 456213 ,"cache_ratio" : 0.20934081229601084 ,"bandwidth" : 27491 ,"country_name" : "Hong Kong"},{"country" : "RU" ,"hits" : 292 ,"traffic" : 167895032 ,"cache_ratio" : 0.2885433918020874 ,"bandwidth" : 1149619 ,"country_name" : "Russia"},...]},...]}
Аккаунты
URL: https://api.cdn.sber.cloud/app/statistic/v3/times/accounts
Описание параметров запроса:
Имя параметра | Описание | Обязательный |
---|---|---|
language | Локаль | Нет |
cdnauthtoken | Авторизационный токен | Да/Нет |
start | Дата, от которой производится расчет (включительно) | Да |
end | Дата, до которой производится расчет (не включительно) | Да |
granularity | Разбиение | Да |
service | Тип сервиса (media/static, если не указан, то оба) | Нет |
account | Имя аккаунта | Нет |
country | Страна (код) | Нет |
region | Регион (код) | Нет |
platform | Платформа (ОС) | Нет |
browser | Браузер | Нет |
referrer | Реферер | Нет |
code | Код ответа | Нет |
custom | Метка | Нет |
sort | Объект и способ сортировки | Нет |
offset | Смещение результата | Нет |
limit | Ограничение результата | Нет |
fields | Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN " 'https://api.cdn.sber.cloud/app/statistic/v3/times/accounts?start=2019-08-01T11:01:00&end=2019-08-19T10:01:00&granularity=P1D&account=account'
Пример успешного ответа
{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-19T10:01:00" ,"granularity" : "P1D" ,"account" : "account" ,"result" : [{"start" : "2019-08-01T11:01:00" ,"end" : "2019-08-02T00:00:00" ,"result" : [{"account" : "account" ,"hits" : 194399 ,"traffic" : 2393556992 ,"cache_ratio" : 0.9263462990063618 ,"bandwidth" : 2088376}]},{"start" : "2019-08-02T00:00:00" ,"end" : "2019-08-03T00:00:00" ,"result" : [{"account" : "account" ,"hits" : 255208 ,"traffic" : 3823467560 ,"cache_ratio" : 0.9046492924867394 ,"bandwidth" : 5299504}]},...]}
- Суммарные данные
- Группировка данных
- Группировка данных с учетом времени