Перейти к содержанию

Статистика

В данном разделе Вы можете узнать о получении:

  • статистики через API;
  • статистики партнерских CDN через API;
  • сырых логов через API или скрипт get-cdnvideo-logs.py.

API статистики

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

  • Тип запроса: GET
  • Тип данных ответа: JSON
  • Язык ответа определяется в первую очередь из строки запроса language. Если не задан, то из заголовка запроса Accept-Language. Если оба значения не заданы, то выбирается английский. Язык, в котором вернулся ответ, будет записан в заголовок ответа Accept-Language
  • Авторизационный токен определяется в первую очередь из строки запроса cdnauthtoken. Если не задан, то из заголовка запроса cdn-auth-token. Если оба не заданы, то вернется ошибка
  • Значение даты (start, end) передается в виде: год-месяц-деньTчасы:минуты:секунды, где секунды должны быть равны 00. Пример, 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 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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/app/statistic/v3/accounts

Описание параметров запроса:

Имя параметра Описание Обязательный
language Локаль Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата, от которой производится расчет (включительно) Да
end Дата, до которой производится расчет (не включительно) Да
service Тип сервиса (media/static, если не указан, то оба) Нет
account Имя аккаунта Нет
country Страна (код) Нет
region Регион (код) Нет
platform Платформа (ОС) Нет
browser Браузер Нет
referrer Реферер Нет
code Код ответа Нет
custom Метка Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет
fields Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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.cdnvideo.ru/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 Поля, значения которых нужно вернуть (raffic, cache_ratio, hits, bandwidth) Нет

Пример запроса

curl -H 'cdn-auth-token: cdn1_D8041SUTFHAV05HRKYEDQAZY5GOWWY' 'https://api.cdnvideo.ru/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 статистики партнерских CDN

В данном разделе описано как Вы можете получить статистику по раздаче в дополнительных зонах.

К таким зонам относятся:

  • EMEA (Европа, Ближний Восток и Африка);
  • APAC (Азиатско-Тихоокеанский регион и Япония);
  • AM (Америка).

Статистика по трафику

Данный метод используются для получения количественных значений трафика в определенные интервалы времени.

URL: https://api.cdnvideo.ru/app/stat-ext-1/v1/p1/traffic?account=<account>&hostname=<hostname>&area=<area>&startdate=<start_date>&enddate=<end_date>&granularity=<granularity>

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • GET-параметры (* - обязательные) :

    1. account - название аккаунта;
    2. hostname - домен;
    3. area - регион (apac/am/emea);
    4. startdate * - дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ (UTC);
    5. enddate - дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ (UTC).

      Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;

    6. granularity - гранулярность по времени, размер интервалов в выдаче. Задаётся в секундах.

  • Тип данных ответа: JSON Object.

    Количественное значение трафика выдается как значение ключа "value" (в байтах).

Код ответа Данные ответа Формат ответа Описание
200 Статистика по трафику JSON ОК
400 None None Плохой запрос
401 None None Нет доступа
404 None None Не найдено
405 None None Метод не поддерживается
500 None None Внутренняя ошибка сервера
503 None None Сервис недоступен

Пример запроса

curl -H 'cdn-auth-token:cdn2_OSKVHEJCGDOPEQJJXQN284ZTQUEPJ2'
https://api.cdnvideo.ru/app/stat-ext-1/v1/p1/traffic?account=paejgjuv&startdate=2019-10-01T16:40:00Z&enddate=2019-10-01T17:00:00Z&granularity=300

Пример успешного ответа

{
  "response": [
    [
      {
        "account": "paejgjuv",
        "intervals": [
          {
            "start": "2019-10-01T16:40:00Z",
            "end": "2019-10-01T16:45:00Z",
            "value": 648877
          },
          {
            "start": "2019-10-01T16:45:00Z",
            "end": "2019-10-01T16:50:00Z",
            "value": 2551568
          },
          {
            "start": "2019-10-01T16:50:00Z",
            "end": "2019-10-01T16:55:00Z",
            "value": 6860538
          },
          {
            "start": "2019-10-01T16:55:00Z",
            "end": "2019-10-01T17:00:00Z",
            "value": 5786
          }
        ]
      }
    ]
  ]
}

Пример неуспешного ответа

{
  "error": {
    "message": "API access denied: invalid token",
    "code": 401
  }
}

Статистика по полосе

Данный метод используются для получения количественных значений полосы в определенные интервалы времени.

URL: https://api.cdnvideo.ru/app/stat-ext-1/v1/p1/bandwidth?account=<account>&hostname=<hostname>&area=<area>&startdate=<start_date>&enddate=<end_date>&granularity=<granularity>

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • GET-параметры (* - обязательные) :

    1. account - название аккаунта;
    2. hostname - домен;
    3. area - регион (apac/am/emea);
    4. startdate * - дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ (UTC);
    5. enddate - дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ (UTC).

      Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;

    6. granularity - гранулярность по времени, размер интервалов в выдаче. Задаётся в секундах.

  • Тип данных ответа: JSON Object.

    Количественное значение полосы выдается как значение ключа "value" (в Мбит/c).

Код ответа Данные ответа Формат ответа Описание
200 Статистика по полосе JSON ОК
400 None None Плохой запрос
401 None None Нет доступа
404 None None Не найдено
405 None None Метод не поддерживается
500 None None Внутренняя ошибка сервера
503 None None Сервис недоступен

Пример запроса

curl -H 'cdn-auth-token:cdn2_OSKVHEJCGDOPEQJJXQN284ZTQUEPJ2'
'https://api.cdnvideo.ru/app/stat-ext-1/v1/p1/bandwidth?account=paejgjuv&area=apac&startdate=2019-10-01T16:40:00Z&enddate=2019-10-01T17:00:00Z&granularity=300'

Пример успешного ответа

{
  "response": [
    [
      {
        "account": "paejgjuv",
        "intervals": [
          {
            "start": "2019-10-01T16:40:00Z",
            "end": "2019-10-01T16:45:00Z",
            "value": 0.07571
          },
          {
            "start": "2019-10-01T16:45:00Z",
            "end": "2019-10-01T16:50:00Z",
            "value": 0.01729
          },
          {
            "start": "2019-10-01T16:50:00Z",
            "end": "2019-10-01T16:55:00Z",
            "value": 0.42443
          },
          {
            "start": "2019-10-01T16:55:00Z",
            "end": "2019-10-01T17:00:00Z",
            "value": 0.06633
          }
        ],
        "area": "apac"
      }
    ]
  ]
}

Пример неуспешного ответа

{
  "error": {
    "message": "Not authorized to request account paejgjuv",
    "code": 401
  }
}

Выгрузка серверных логов

В этом разделе описаны возможности получения сырых логов.

Описание лог-файла

Результирующий лог-файл начинается с заголовочной строки, содержащей перечень полей описанных ниже.

Структура лог-файла после заголовочной строки представляет собой таблицу, каждый столбец которой содержит соответствующее поле. Поля следуют друг за другом слева направо и разделены символом горизонтальной табуляции. Каждая строка лог-файла соответствует отдельному запросу, строки разделены символом перевода строки.

Название поля Описание поля Пример
timestamp Дата и время в формате UNIX timestamp 1417135813.178
remote_addr IP-адрес пользователя 81.19.133.15
remote_user (служебное поле) -
time_local Дата и время в читаемом формате 2019-09-16 12:00:16+0000
request Путь к файлу или видео потоку /live/smil:chanel1.smil/m_b1600000_126952.ts
status Статус ответа 200
body_bytes_sent Объём отправленных байт (без заголовка) 80840
out_bytes Объём отправленных байт (с заголовком) 81076
referrer Реферер, адрес источника http://www.site1.ru/
useragent Агент/браузер веб-пользователя Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.65 Safari/537.36
http_x_forwarded_for Содержимое HTTP-заголовка X-Forwarded-For, может содержать оригинальные IP-адреса пользователя 192.168.7.114, 192.168.0.205, 81.19.133.15
host Имя хоста запроса site1.cdnvideo.ru
torso_id (служебное поле) -
duration Длительность запроса или части продолжающегося запроса в секундах 0.616
upstream_response_time Время ответа ориджина или промежуточного узла в секундах. Времена нескольких ответов разделяются запятыми 0.021
upstream_status Статус ответа ориджина/промежуточного узла (если запрос отдавался не из кэша раздающего узла). Статусы нескольких ответов разделяются запятыми 200
country Код страны по ISO_3166-1 RU
service Тип услуги (static — "Ускорение загрузки веб контента", media — "Онлайн трансляции и видео по запросу") media
cache_status Кэш-статус запроса (HIT - ответ был отдан из кэша CDN, MISS - запрос был отправлен на ориджин) HIT
logtype (служебное поле) -
custom_field (опционально) некоторые дополнительные значения

Проверка наличия логов через API

Данный вызов предназначен для проверки существования логов.

Запрос для проверки наличия логов за определённый интервал времени:

URL: https://api.cdnvideo.ru/app/logs/v1/accounts/<your_account_name>/exists?startdate=<start_date>&enddate=<end_date>

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Обязательные GET-параметры:
    1. startdate — дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ
    2. enddate — дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ
  • Тип данных ответа: JSON Object или String в случае ошибки
Код ответа Данные ответа Формат ответа Описание
200 Информация о наличии логов за определенный интервал времени JSON ОК
400 None None Плохой запрос
401 None None Нет доступа
404 None None Не найдено
500 None None Внутренняя ошибка сервера
503 None None Сервис недоступен

Пример запроса

curl -H 'cdn-auth-token:cdn2_OSKVHEJCGDOPEQJJXQN284ZTQUEPJ2'
https://api.cdnvideo.ru/app/logs/v1/accounts/paejgjuv/exists?startdate=2019-08-01T00:00:00Z&enddate=2019-09-01T00:00:00Z

Пример успешного ответа

{
    "account": "paejgjuv",
    "startdate": "2019-08-01T00:00:00+0000",
    "enddate": "2019-09-01T00:00:00+0000",
    "exists": true
}

Пример неуспешного ответа

No startdate or enddate in query

Описание полей из тела ответа:

  • account - имя аккаунта;
  • startdate - дата и время начала интервала;
  • enddate - дата и время окончания интервала;
  • exists - статус наличия логов с заданными параметрами, true — наличие минимум одной строки, иначе — false.

Получение лог-файла через API

Запрос к API для получения лог-файла за определённый интервал времени в виде gzip-потока:

URL: https://api.cdnvideo.ru/app/logs/v1/accounts/<your_account_name>/get?startdate=<start_date>&enddate=<end_date>

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Обязательные GET-параметры:
    1. startdate — дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ
    2. enddate — дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ
  • Тип данных ответа: gzip-поток
Код ответа Данные ответа Формат ответа Описание
200 Логи за определенный интервал времени gzip-поток ОК
400 None None Плохой запрос
401 None None Нет доступа
404 None None Не найдено
500 None None Внутренняя ошибка сервера
503 None None Сервис недоступен

Пример запроса

curl -H 'cdn-auth-token:cdn2_OSKVHEJCGDOPEQJJXQN284ZTQUEPJ2'
https://api.cdnvideo.ru/app/logs/v1/accounts/paejgjuv/get?startdate=2019-08-01T00:00:00Z&enddate=2019-09-01T00:00:00Z

В теле ответе будет передан лог за временной интервал, указанный в аргументах в виде gzip-потока. Временной интервал соответствует правилу: startdate <= logs_time_interval < enddate. Подробное описание результирующего файла представлено ниже.

Получение лог-файла через get-cdnvideo-logs.py

Для выгрузки логов можно использовать скрипт get-cdnvideo-logs.py (скачать скрипт).

Установка

  • Установить pip (пример установки на RHEL, CentOS, Fedora):

    sudo yum install python-pip
    
  • Установить библиотеку requests:

    pip install requests
    
  • Положить get-cdnvideo-logs.py в нужную директорию.

Использование

ПО представляет собой простой консольный python-скрипт, принимающий различные аргументы. На выход отдает поток в формате gzip.

Скрипту передаются аргументы (* - обязательные):

  1. --account * (-a). Аккаунт пользователя.
  2. --username * (-u). Юзернейм пользователя.
  3. --password (-p). Пароль пользователя. При отсутствии аргумента:
    • Пароль берется из переменной окружения "CDNVIDEO_PASSWORD".
    • Пароль запрашивается при выполнении скрипта.
  4. --date * (-d). Определяет дату, за которую нужно скачать лог. Скачать лог можно в точности до часа. Возможные значения:

    • 2019-08. Скачиваем лог за август 2019 года
    • 2019-08-23. Скачиваем лог за 23 августа 2019 года
    • 2019-08-23-04. Скачиваем лог за 23 августа 2019 года 4 утра (UTC)

    Внимание!

    Параметр часа указывается в UTC.

  5. --progressbar (-pb). Вывод прогресса скачивания.

    Внимание!

    Для пользования данным функционалом потребуется установить дополнительный python модуль.

  6. --file (-f). Вывод логов в файл $account_$date.txt.gz . По умолчанию скрипт выдает поток сжатых логов в stdout.

Возможные сценарии использования:

  1. Скачиваем лог за 23 августа 2019 год и архивируем его в файл account_2019-08-23.txt.gz

    python get-cdnvideo-logs.py -a account -u username -d 2019-08-23 -f
    
  2. Скачиваем лог за август 2019 года с выводом прогрессбара, архивируем его в файл account_2019-08.txt.gz

    python get-cdnvideo-logs.py -a account -u username -d 2019-08 -pb -f
    

Возможные ошибки

  1. "Error: A connection error occurred"

    Возможные причины: Отсутствие интернета, проблемы с сетью. Упал сервер.

    Что делать:

    1. Убедиться, что у вас есть интернет

      ping google.com
      
    2. Если не помогло, обратиться в службу поддержки

  2. "Timeout: page connection timeout more than seconds: 5"

    Возможные причины: Сервер не отвечает, проблемы с сетью

    Что делать:

    1. Проверить сетевое подключение.
    2. Обратиться в службу поддержки.
  3. "Error: Wrong username or password"

    Возможные причины: Неверно введена пара логин/пароль (аргументы -u username, -p password )

    Что делать:

    1. Проверить, что аргументы username, password правильно заполнены.
    2. Если ошибка остается, обратиться в службу поддержки.
  4. "Error: account not found"

    Возможные причины: Нет такого account для username.

    Что делать:

    1. Проверить, что аргумент -a account введен верно для username.
    2. Если ошибка остается, обратиться в службу поддержки.
  5. "Error: We don't have any log for this date"

    Возможные причины: У нас нет лог-файла за данный период времени

    Что делать:

    1. Проверить в разделе статистики наличие трафика за требуемый интервал.
    2. Проверить наличие лог-файла с помощью обращения к API.
    3. Обратиться в службу поддержки.
  6. "Error: Problem with server/page down"

    Возможные причины: Проблемы с сервером

    Что делать:

    1. Обратиться в службу поддержки