- tocdepth
2
Общие сведения
На этой странице
Тип запроса: 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
}
]
},
...
]
}
Была ли статья полезной?
для Dev & Test