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

Статистика

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

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

API статистики

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

Внимание!

  1. Установлено ограничение на количество обращений к API:
    • не больше 5 обращений в минуту.
  • Тип запроса: GET
  • Тип данных ответа: JSON
  • Язык ответа определяется в первую очередь из строки запроса language. Если не задан, то из заголовка запроса Accept-Language. Если оба значения не заданы, то выбирается английский. Язык, в котором вернулся ответ, будет записан в заголовок ответа Accept-Language
  • Авторизационный токен определяется в первую очередь из строки запроса cdnauthtoken. Если не задан, то из заголовка запроса cdn-auth-token. Если оба не заданы, то вернется ошибка
  • Значение даты (start, end) передается в виде: год-месяц-деньTчасы:минуты:секунды, где секунды должны быть равны 00. Указывается в UTC. Пример, 2020-02-11T12:30:00
  • Значения country и region являются кодами. Если они присутствуют в ответе, то вместе с ним передается значения country_name и region_name, которые возвращают названия страны и региона в читаемом виде в языке, который был выбран
  • С помощью параметра sort можно задать объект и способ сортировки. Параметр sort имеет вид: [+-]{field} (например, сортировка по убыванию трафика -traffic)
  • Разбиение (granularity) имеет формат: упрощенную версию P[n]Y[n]M[n]DT[n]H[n]M[n]S ("P1M", "PT5M", но не "P1DT12H")

Описание заголовков запроса:

Имя параметра Описание Обязательный
Accept-Language Локаль Нет
cdn-auth-token Авторизационный токен Да/Нет

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

Код ответа Данные ответа Описание ответа
200 OK успешное выполнение запроса
401 token is invalid токен не был указан
401 no accounts available по заданному токену нет доступных аккаунтов
401 account указанный аккаунт не доступен
400 unknown path указанного пути нет
400 required key для данного пути не был указан обязательный параметр
400 required key для определенного параметра не был указан обязательный параметр
400 неизвестный параметр
400 параметр имеет некорректное значение
400 параметр имеет некорректное значение
400 start must be less then end start не может быть больше или равен end
400 granularity is not correct некорректное значение granularity
429 Too Many Requests слишком много запросов
500 Internal Server Error неизвестная ошибка
504 Gateway Timeout error слишком долгое выполнение запроса

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

Имя параметра Описание
traffic Общий трафик (в байтах)
cache_ratio Процент выдачи из кэша (от 0 до 1 без округления)
hits Количество подключений
bandwidth Пиковая скорость (в бит/сек)

Суммарные данные

URL: https://api.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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет
resource Идентификатор ресурса Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 Поля, значения которых нужно вернуть (traffic, cache_ratio, hits, bandwidth) Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" '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 статистики по потокам

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

Внимание!

  1. Установлено ограничение на количество обращений к API:
    • не больше 30 обращений в минуту.
  • Тип запроса: GET
  • Тип данных ответа: JSON
  • Язык ответа определяется в первую очередь из строки запроса language. Если не задан, то из заголовка запроса Accept-Language. Если оба значения не заданы, то выбирается английский. Язык, в котором вернулся ответ, будет записан в заголовок ответа Accept-Language
  • Авторизационный токен определяется в первую очередь из строки запроса cdnauthtoken. Если не задан, то из заголовка запроса cdn-auth-token. Если оба не заданы, то вернется ошибка
  • Значение даты (start, end) использует стандарт ISO8601 в формате UTC с нулевыми секундами. Например, 2020-08-01T00:00:00Z или 2020-08-01T00:00:00
  • Для указания времени в запросе должен быть задан start и end
  • Значения country и region являются кодами. Если они присутствуют в ответе, то вместе с ним передается значения country_name и region_name, которые возвращают названия страны и региона в читаемом виде в языке, который был выбран
  • Для фильтра по региону необходимо указать страну
  • Для фильтра по потоку необходимо указать аккаунт
  • Аргумент offset можно указать только вместе с limit
  • С помощью параметра sort можно задать объект и способ сортировки. Параметр sort имеет вид: [+-]{field} (например, сортировка по убыванию уникальных пользователей -users)
  • Разбиение (granularity) имеет формат ISO 8601. Доступные значения: PT1M, PT5M, PT15M, PT1H, P1D, P1W, P1M, P1Y
  • Локаль представлена в возвращаемом заголовке Accept-Language и соответствует спецификации RFC 7231. Состоит из двухбуквенного основного языкового тега. Возможные значения: en и ru
  • В процессе просмотра на устройство пользователя загружаются элементы потока (сегменты). Статистика подсчитывается на основе анализа этих загрузок
  • User (пользователь) определяется как комбинация (IP-адрес, User-Agent)
  • Просмотром потока считается наличие одного или нескольких запросов к узлам CDN на загрузку элементов потока. Если интервалы между запросами не превышают 1 минуту, то это считается одним просмотром

Описание заголовков запроса:

Имя параметра Описание Обязательный
Accept-Language Локаль Нет
cdn-auth-token Авторизационный токен Да/Нет

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

Код ответа Данные ответа Описание ответа
200 OK успешное выполнение запроса
400 validation fail ошибка валидации
400 sort argument not in fields указанный параметр сортировки не указан в fields
400 start must be less then end start не может быть больше или равен end
400 granularity is not correct некорректное значение granularity
401 token is invalid токен не был указан
401 no accounts available по заданному токену нет доступных аккаунтов
401 account указанный аккаунт не доступен
422 неправильно задан один из передаваемых параметров (message содержит более детальное описание)
429 Too Many Requests слишком много запросов
500 Internal Server Error внутренняя ошибка
504 Gateway Timeout error слишком долгое выполнение запроса

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

Имя параметра Описание
views Количество просмотров. Равно сумме просмотров, которые наблюдались в данном интервале времени
users Количество уникальных пользователей, просматривавших поток в данном интервале времени
views_max Пиковое количество одновременных просмотров, наблюдавшееся в данном интервале времени

Суммарные данные

URL: https://api.cdnvideo.ru/app/streamstat/v2/

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&fields=views,users,views_max&account=account'

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

{
    "views": 631185,
    "users": 59337,
    "views_max": 9426,
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z"
}

Группировка данных

Потоки

URL: https://api.cdnvideo.ru/app/streamstat/v2/streams

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/streams?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "account": "account",
            "views": 6737,
            "users": 5382,
            "views_max": 356,
            "stream": "stream_name1"
        },
        {
            "account": "account",
            "views": 6438,
            "users": 5145,
            "views_max": 343,
            "stream": "stream_name2"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Аккаунты

URL: https://api.cdnvideo.ru/app/streamstat/v2/accounts

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/accounts?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max'

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

{
    "result": [
        {
            "views": 281509,
            "users": 28160,
            "views_max": 56359,
            "account": "account1"
        },
        {
            "views": 75720,
            "users": 29770,
            "views_max": 12300,
            "account": "account2"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}   

Браузеры

URL: https://api.cdnvideo.ru/app/streamstat/v2/browsers

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/browsers?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 477309,
            "users": 16346,
            "views_max": 8057,
            "browser": "AndroidBrowser"
        },
        {
            "views": 145386,
            "users": 41285,
            "views_max": 1287,
            "browser": "TV"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Платформы

URL: https://api.cdnvideo.ru/app/streamstat/v2/platforms

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/platforms?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 772199,
            "users": 20384,
            "views_max": 9229,
            "platform": "Android"
        },
        {
            "views": 235102,
            "users": 63074,
            "views_max": 1439,
            "platform": "iOS"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Страны

URL: https://api.cdnvideo.ru/app/streamstat/v2/countries

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/countries?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 1032159,
            "users": 84212,
            "views_max": 10871,
            "country": "RU",
            "country_name": "Russia"
        },
        {
            "views": 7,
            "users": 2,
            "views_max": 7,
            "country": "GB",
            "country_name": "United Kingdom"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Регионы

URL: https://api.cdnvideo.ru/app/streamstat/v2/regions

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/regions?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'

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

{
    "result": [
        {
            "views": 250940,
            "users": 28756,
            "views_max": 3911,
            "country": "RU",
            "region": "48",
            "country_name": "Russia",
            "region_name": "Moscow"
        },
        {
            "views": 88396,
            "users": 9042,
            "views_max": 1559,
            "country": "RU",
            "region": "71",
            "country_name": "Russia",
            "region_name": "Sverdlovsk"
        }
    ],
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Интервалы времени

URL: https://api.cdnvideo.ru/app/streamstat/v2/times

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да/
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "views": 96352,
            "users": 10483,
            "views_max": 9426,
            "start": "2020-08-01T15:00:00Z",
            "end": "2020-08-01T16:00:00Z"
        },
        {
            "views": 92464,
            "users": 9573,
            "views_max": 9009,
            "start": "2020-08-01T14:00:00Z",
            "end": "2020-08-01T15:00:00Z"
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Группировка данных с учетом времени

Потоки

URL: https://api.cdnvideo.ru/app/streamstat/v2/times/streams

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times/streams?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T15:00:00Z",
            "end": "2020-08-01T16:00:00Z",
            "result": [
                {
                    "account": "account",
                    "views": 1576,
                    "users": 1396,
                    "views_max": 272,
                    "stream": "stream_name1"
                },
                {
                    "account": "account",
                    "views": 1558,
                    "users": 1374,
                    "views_max": 260,
                    "stream": "stream_name2"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
} 

Аккаунты

URL: https://api.cdnvideo.ru/app/streamstat/v2/times/accounts

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times/accounts?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H'

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

{
    "result": [
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 56359,
                    "users": 11171,
                    "views_max": 56359,
                    "account": "account1"
                }
            ]
        },
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 49772,
                    "users": 10646,
                    "views_max": 49772,
                    "account": "account2"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Браузеры

URL: https://api.cdnvideo.ru/app/streamstat/v2/times/browsers

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times/browsers?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T15:00:00Z",
            "end": "2020-08-01T16:00:00Z",
            "result": [
                {
                    "views": 74535,
                    "users": 3931,
                    "views_max": 8057,
                    "browser": "AndroidBrowser"
                }
            ]
        },
        {
            "start": "2020-08-01T14:00:00Z",
            "end": "2020-08-01T15:00:00Z",
            "result": [
                {
                    "views": 72059,
                    "users": 3868,
                    "views_max": 7893,
                    "browser": "AndroidBrowser"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Платформы

URL: https://api.cdnvideo.ru/app/streamstat/v2/times/platforms

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times/platforms?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 80156,
                    "users": 4379,
                    "views_max": 9163,
                    "platform": "Android"
                }
            ]
        },
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 75559,
                    "users": 4203,
                    "views_max": 9229,
                    "platform": "Android"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Страны

URL: https://api.cdnvideo.ru/app/streamstat/v2/times/countries

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times/countries?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 105294,
                    "users": 12113,
                    "views_max": 10764,
                    "country": "RU",
                    "country_name": "Russia"
                }
            ]
        },
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 98352,
                    "users": 10583,
                    "views_max": 10871,
                    "country": "RU",
                    "country_name": "Russia"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

Регионы

URL: https://api.cdnvideo.ru/app/streamstat/v2/times/regions

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

Имя параметра Описание Обязательный
language Локаль (ru или en) Нет
cdnauthtoken Авторизационный токен Да/Нет
start Дата-время, от которой производится расчет (включительно) Да
end Дата-время, до которой производится расчет (не включительно) Да
granularity Гранулярность Да
account Имя аккаунта Нет
stream Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) Нет
country Страна (код) Нет
region Регион (код) Нет
browser Браузер Нет
platform Платформа (ОС) Нет
fields Поля, значения которых нужно вернуть (views_max, views, users) Нет
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.cdnvideo.ru/app/streamstat/v2/times/regions?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&granularity=PT1H&account=account'

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

{
    "result": [
        {
            "start": "2020-08-01T19:00:00Z",
            "end": "2020-08-01T20:00:00Z",
            "result": [
                {
                    "views": 45884,
                    "users": 5163,
                    "views_max": 5134,
                    "country": "RU",
                    "region": "48",
                    "country_name": "Russia",
                    "region_name": "Moscow"
                }
            ]
        },
        {
            "start": "2020-08-01T16:00:00Z",
            "end": "2020-08-01T17:00:00Z",
            "result": [
                {
                    "views": 42318,
                    "users": 5825,
                    "views_max": 4060,
                    "country": "RU",
                    "region": "48",
                    "country_name": "Russia",
                    "region_name": "Moscow"
                }
            ]
        }
    ],
    "granularity": "PT1H",
    "start": "2020-08-01T00:00:00Z",
    "fields": [
        "views",
        "users",
        "views_max"
    ],
    "account": "account",
    "end": "2020-08-02T00:00:00Z",
    "limit": 2,
    "sort": "-views"
}

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: $TOKEN" \
'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: $TOKEN" \
'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
  }
}

API realtime статистики по полосе

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

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

Рекомендация

Для оптимальной работы с API рекомендуется отправлять 1 запрос в 10 секунд.

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

Имя параметра Описание
bandwidth_out_bits_per_second Полоса (биты в секунду)
requests_per_second Количество запросов в секунду
http_status_percent Распределение по HTTP-статусам ответов (в процентах)
cache_status_percent_by_requests Распределение по отдаче ответов из кэша cache hit/miss (в процентах от числа запросов)
cache_status_percent_by_volume Распределение по отдаче ответов из кэша cache hit/miss (в процентах от объема трафика)

При отсутствии трафика по доступным аккаунтам в ответ возвращается пустой список [].

Статистика по всем доступным аккаунтам

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

URL: https://api.cdnvideo.ru/app/realtimestat/v1/accounts

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Array

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/realtimestat/v1/accounts'

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

[
    {
        "http_status_percent": {
          "200": 100
        },
        "account": "account1",
        "cache_status_percent_by_requests": {
          "HIT": 100,
          "MISS": 0
        },
        "cache_status_percent_by_volume": {
          "HIT": 100,
          "MISS": 0
        },
        "requests_per_second": 0.5443,
        "bandwidth_out_bits_per_second": 2037575.4037
    },
    {
        "http_status_percent": {
          "200": 72.9239,
          "404": 0.0865,
          "304": 26.1678,
          "499": 0.2595,
          "206": 0.5623
        },
        "account": "account2",
        "cache_status_percent_by_requests": {
          "HIT": 98.7457,
          "MISS": 1.2543
        },
        "cache_status_percent_by_volume": {
          "HIT": 97.6446,
          "MISS": 2.3554
        },
        "requests_per_second": 114.4467,
        "bandwidth_out_bits_per_second": 104866402.3032
    }
]

Статистика по конкретному аккаунту

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

URL: https://api.cdnvideo.ru/app/realtimestat/v1/accounts/<account>

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Array

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/realtimestat/v1/accounts/account1'

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

[
    {
        "http_status_percent": {
          "200": 100
        },
        "account": "account1",
        "cache_status_percent_by_requests": {
          "HIT": 100,
          "MISS": 0
        },
        "cache_status_percent_by_volume": {
          "HIT": 100,
          "MISS": 0
        },
        "requests_per_second": 0.5443,
        "bandwidth_out_bits_per_second": 2037575.4037
    }
]

Статистика по конкретному аккаунту с разбивкой по ресурсам

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

URL: https://api.cdnvideo.ru/app/realtimestat/v1/accounts/<account>/resources

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Array

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/realtimestat/v1/accounts/account1/resources'

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

[
    {
        "http_status_percent": {
          "200": 100
        },
        "account": "account1",
        "resource": "1",
        "cache_status_percent_by_requests": {
          "HIT": 100,
          "MISS": 0
        },
        "cache_status_percent_by_volume": {
          "HIT": 100,
          "MISS": 0
        },
        "requests_per_second": 0.5443,
        "bandwidth_out_bits_per_second": 2037575.4037
    },
    {
        "http_status_percent": {
          "200": 100
        },
        "account": "account1",
        "resource": "2",
        "cache_status_percent_by_requests": {
          "HIT": 100,
          "MISS": 0
        },
        "cache_status_percent_by_volume": {
          "HIT": 100,
          "MISS": 0
        },
        "requests_per_second": 0.3443,
        "bandwidth_out_bits_per_second": 1037575.1234
    }
]

Статистика по конкретному ресурсу аккаунта

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

URL: https://api.cdnvideo.ru/app/realtimestat/v1/accounts/<account>/resources/<resource>

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Array

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/realtimestat/v1/accounts/account1/resources/1'

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

[
    {
        "http_status_percent": {
          "200": 100
        },
        "account": "account1",
        "resource": "1",
        "cache_status_percent_by_requests": {
          "HIT": 100,
          "MISS": 0
        },
        "cache_status_percent_by_volume": {
          "HIT": 100,
          "MISS": 0
        },
        "requests_per_second": 0.5443,
        "bandwidth_out_bits_per_second": 2037575.4037
    }
]

API текущей статистики по потокам

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

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

Описание заголовков запроса:

Имя заголовка Описание Обязательный
CDN-AUTH-TOKEN Авторизационный токен Да

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

Имя параметра Описание Обязательный
account Имя аккаунта Да
fields Поля, значения которых нужно вернуть (views, views_by_type, detail) Нет

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

Имя параметра Описание
status Статус ответа (Completed, Unauthorized, Forbidden, Error)
description Описание статуса ответа
result Основная информация ответа
account Имя аккаунта
stream Поток
views Количество зрителей
views_by_type Количество зрителей в разбивке по типам просмотра
detail Детальная информация по зрителям
IpAddress IP адрес зрителя
UserAgent Useragent зрителя
UserId ID зрителя
ViewType Тип просмотра

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

Код ответа Описание
200 OK
400 Неверный запрос
401 Не авторизован
403 Доступ запрещен
500 Внутренняя ошибка сервера
503 Сервис недоступен

Общая статистика

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

URL: https://api.cdnvideo.ru/app/activesessions/v1/streams

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/activesessions/v1/streams?account=testaccount'

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

{
  "status": "Completed",
  "description": "Success",
  "account": [
    "testaccount"
  ],
  "fields": [
    "account",
    "stream",
    "views",
    "views_by_type"
  ],
  "result": [
    {
      "account": "testaccount",
      "stream": "test/_definst_/360p_test.sdp",
      "views_by_type": {
        "HLS": 8
      },
      "views": 8
    },
    {
      "account": "testaccount",
      "stream": "test/_definst_/720p_test.sdp",
      "views_by_type": {
        "HLS": 7
      },
      "views": 7
    }
  ]
}

Детальная статистика

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

URL: https://api.cdnvideo.ru/app/activesessions/v1/streams?account=<your_account_name>&fields=detail

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/activesessions/v1/streams?account=testaccount&fields=detail'

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

{
  "status": "Completed",
  "description": "Success",
  "account": [
    "testaccount"
  ],
  "fields": [
    "account",
    "detail",
    "stream"
  ],
  "result": [
    {
      "account": "testaccount",
      "stream": "test/_definst_/360p_test.sdp",
      "detail": [
        {
          "IpAddress": "84.142.236.203",
          "UserAgent": "samsunghas-agent/1.1",
          "UserId": "eec0c296479e296658e4d2b78ctestb0",
          "ViewType": "HLS"
        },
        {
          "IpAddress": "85.246.51.121",
          "UserAgent": "HLS Client/2.0 (compatible; LG NetCast.TV-2012)",
          "UserId": "64f3c932ebc77cdtestaada7665d657d",
          "ViewType": "HLS"
        }
      ]
    }
  ]
}

API статистики сервиса оптимизации изображений

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

Данный API используется для получения статистики использования сервиса оптимизации изображений

Внимание!

  1. Установлено ограничение на количество обращений к API:
    • не больше 5 обращений в минуту.

Описание заголовков запроса:

Имя заголовка Описание Обязательный
CDN-AUTH-TOKEN Авторизационный токен Да

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

Имя параметра Описание Обязательный
account Имя аккаунта Да
fields Поля, значения которых нужно вернуть Нет
start Начало периода в формате ISO8601 (включительно) Да
end Конец периода в формате ISO8601 (не включительно) Да
granularity Интервал времени в упрощенном формате ISO8601 (P1D, PT8H,...) Для /times
sort Объект и способ сортировки Нет
offset Смещение результата Нет
limit Ограничение результата Нет
resource Идентификатор ресурса Нет

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

Имя параметра Описание
start, end Границы интервала
account Имя аккаунта
data Основная информация ответа
conversions Количество выполненных операций
requests Количество запросов к сервису
in_bytes Объем входящего трафика за заданный период в байтах
out_bytes Объем исходящего трафика за заданный период в байтах
in_content_type Content-Type исходного запроса
out_content_type Content-Type обработанного запроса

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

Код ответа Описание
200 OK
400 Неверный запрос
401 Не авторизован
403 Доступ запрещен
500 Внутренняя ошибка сервера
503 Сервис недоступен

Общая статистика

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

URL: https://api.cdnvideo.ru/app/ioss-statistic/v1/?account=<your_account_name>&start=2023-01-01T00:00:00Z&end=2023-02-01T00:00:00Z

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/ioss-statistic/v1/?account=testaccount&start=2023-01-02T13:09:00Z&end=2023-03-02T13:10:00Z'

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

{
  "end": "2023-03-02T13:10:00+00:00",
  "start": "2023-01-02T13:09:00+00:00",
  "account": "testaccount",
  "data": {
    "conversions": 27585497,
    "requests": 21921555,
    "in_bytes": 2443059563686,
    "out_bytes": 1330836800409
  }
}

Статистика с разбивкой по ресурсам

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

URL: https://api.cdnvideo.ru/app/ioss-statistic/v1/resources?account=<your_account_name>&start=2023-01-01T00:00:00Z&end=2023-02-01T00:00:00Z

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/ioss-statistic/v1/resources?account=testaccount&start=2023-01-02T13:09:00Z&end=2023-03-02T13:10:00Z'

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

{
  "end": "2023-03-02T13:10:00+00:00",
  "start": "2023-01-02T13:09:00+00:00",
  "account": "testaccount",
  "data": [
    {
        "resource": "testresource1_id",
        "resource_name": "testresource1",
        "conversions": 14601185,
        "requests": 13412331,
        "in_bytes": 1615409385151,
        "out_bytes": 983457015345
    },
    {
        "resource": "testresource2_id",
        "resource_name": "testresource2",
        "conversions": 12984312,
        "requests": 8509224,
        "in_bytes": 827650178535,
        "out_bytes": 347379785064
    }
  ]
}

Статистика по операциям

Данный вызов используется для детализации операций по типу

URL: https://api.cdnvideo.ru/app/ioss-statistic/v1/action?account=<your_account_name>&start=2023-01-01T00:00:00Z&end=2023-02-01T00:00:00Z

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/ioss-statistic/v1/action?account=testaccount&start=2023-01-02T13:09:00Z&end=2023-03-02T13:10:00Z'

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

{
  "start": "2023-01-02T13:09:00+00:00",
  "end": "2023-03-02T13:10:00+00:00",
  "account": "testaccount",
  "data": [
    {
      "action": "convert",
      "conversions": 21913945,
      "in_bytes": 2265285030613,
      "out_bytes": 344728920647
    },
    {
      "action": "quality",
      "conversions": 5671552,
      "in_bytes": 597323275534,
      "out_bytes": 90913935289
    }
  ]
}

Статистика по Content-Type

Данные вызовы используются для детализации запросов по in/out content-type

URL: https://api.cdnvideo.ru/app/ioss-statistic/v1/in-content-type?account=<your_account_name>&start=2023-01-01T00:00:00Z&end=2023-02-01T00:00:00Z

URL: https://api.cdnvideo.ru/app/ioss-statistic/v1/out-content-type?account=<your_account_name>&start=2023-01-01T00:00:00Z&end=2023-02-01T00:00:00Z

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/ioss-statistic/v1/out-content-type?account=testaccount&start=2023-02-02T13:09:00Z&end=2023-03-02T13:10:00Z'

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

{
  "start": "2023-02-02T13:09:00+00:00",
  "end": "2023-03-02T13:10:00+00:00",
  "account": "testaccount",
  "data": [
    {
      "out_content_type": "-",
      "requests": 3120,
      "in_bytes": 594164,
      "out_bytes": 697806
    },
    {
      "out_content_type": "image/gif",
      "requests": 969,
      "in_bytes": 25855686,
      "out_bytes": 25855788
    },
    {
      "out_content_type": "image/jpeg",
      "requests": 4131912,
      "in_bytes": 333206022458,
      "out_bytes": 333188803602
    },
    {
      "out_content_type": "image/png",
      "requests": 1629595,
      "in_bytes": 504203255765,
      "out_bytes": 504147453203
    },
    {
      "out_content_type": "image/webp",
      "requests": 7995946,
      "in_bytes": 839899400734,
      "out_bytes": 128330988195
    },
    {
      "out_content_type": "text/html",
      "requests": 1378330,
      "in_bytes": 1725130740,
      "out_bytes": 1206975546
    },
    {
      "out_content_type": "text/plain; charset=utf-8",
      "requests": 13,
      "in_bytes": 2509,
      "out_bytes": 2951
    }
  ]
}

Разделение по периодам

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

URL: https://api.cdnvideo.ru/app/ioss-statistic/v1/times/action?account=<your_account_name>&start=2023-01-01T00:00:00Z&end=2023-02-01T00:00:00Z&granularity=P1W'

  • Тип запроса: GET
  • Заголовки: CDN-AUTH-TOKEN
  • Тип данных ответа: JSON Object

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.cdnvideo.ru/app/ioss-statistic/v1/times/action?account=testaccount&start=2023-02-02T13:09:00Z&end=2023-03-02T13:10:00Z&granularity=P1W'

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

{
  "granularity": "P1W",
  "start": "2023-02-02T13:09:00+00:00",
  "end": "2023-03-02T13:10:00+00:00",
  "account": "testaccount",
  "data": [
    {
      "start": "2023-02-02T13:09:00+00:00",
      "end": "2023-02-06T00:00:00+00:00",
      "data": [
        {
          "action": "quality",
          "conversions": 0,
          "in_bytes": 0,
          "out_bytes": 0
        },
        {
          "action": "convert",
          "conversions": 727108,
          "in_bytes": 72033704597,
          "out_bytes": 11632136623
        }
      ]
    },
    {...},
    {
      "start": "2023-02-27T00:00:00+00:00",
      "end": "2023-03-02T13:10:00+00:00",
      "data": [
        {
          "action": "quality",
          "conversions": 987410,
          "in_bytes": 108687891902,
          "out_bytes": 16025891848
        },
        {
          "action": "convert",
          "conversions": 987410,
          "in_bytes": 108687891902,
          "out_bytes": 16025891848
        }
      ]
    }
  ]
}

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

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

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

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

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

Название поля Описание поля Пример
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.cdn.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: $TOKEN" \
'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: $TOKEN" \
'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. Обратиться в службу поддержки
  7. При получении других ошибок - обратитесь в службу поддержки