/ DOCS
Evolution
Тема интерфейса
CDN

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

  • Тип запроса: 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Авторизационный токенДа/Нет

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

Код ответаДанные ответаОписание ответа
200OKуспешное выполнение запроса
401token is invalidтокен не был указан
401no accounts availableпо заданному токену нет доступных аккаунтов
401account {account} is not availableуказанный аккаунт не доступен
400unknown pathуказанного пути нет
400required key {req} not in query stringдля данного пути не был указан обязательный параметр
400required 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})параметр имеет некорректное значение
400start must be less then endstart не может быть больше или равен end
400granularity is not correctнекорректное значение granularity
429Too Many Requestsслишком много запросов
500Internal Server Errorнеизвестная ошибка
504Gateway 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть 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БраузерНет
hosthost часть URLДа
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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БраузерНет
hosthost часть 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БраузерНет
hosthost часть URLДа
pathpath часть 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БраузерНет
hosthost часть URLНет
pathpath часть 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
                }
            ]
        },
        ...
    ]
}
Предыдущая статья
API cтатистики
Следующая статья
API статистики по потокам
Была ли эта статья полезна?
Поддержка Юридические документы
© 2025 Cloud.ru