Общие сведения
На этой странице
Тип запроса: 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}]},...]}
- Суммарные данные
- Группировка данных
- Группировка данных с учетом времени