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
                }
            ]
        },
        ...
    ]
}
Запустили Evolution free tier
для Dev & Test
Получить