Статистика

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

• статистики через 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
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. Обратиться в службу поддержки