Статистика
В данном разделе Вы можете узнать о получении:
- статистики через API;
- статистики партнерских CDN через API;
- сырых логов через API или скрипт get-cdnvideo-logs.py.
API статистики
Общие сведения
Внимание!
- Установлено ограничение на количество обращений к API:
- не больше 5 обращений в минуту.
- Отставание статистики может быть до часа. Для получения статистики с минимальной задержкой используйте API realtime статистики
- Тип запроса: 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 статистики по потокам
Общие сведения
Внимание!
- Установлено ограничение на количество обращений к 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-параметры (* - обязательные) :
- account - название аккаунта;
- hostname - домен;
- area - регион (apac/am/emea);
- startdate * - дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ(UTC); -
enddate - дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ(UTC).Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;
-
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-параметры (* - обязательные) :
- account - название аккаунта;
- hostname - домен;
- area - регион (apac/am/emea);
- startdate * - дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ(UTC); -
enddate - дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ(UTC).Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;
-
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 используется для получения статистики использования сервиса оптимизации изображений
Внимание!
- Установлено ограничение на количество обращений к 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-параметры:
- startdate — дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ - enddate — дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ
- startdate — дата и время начала интервала в формате
- Тип данных ответа: 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-параметры:
- startdate — дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ - enddate — дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ
- startdate — дата и время начала интервала в формате
- Тип данных ответа: 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.
Скрипту передаются аргументы (* - обязательные):
- --account * (-a). Аккаунт пользователя.
- --username * (-u). Юзернейм пользователя.
- --password (-p). Пароль пользователя.
При отсутствии аргумента:
- Пароль берется из переменной окружения "CDNVIDEO_PASSWORD".
- Пароль запрашивается при выполнении скрипта.
-
--date * (-d). Определяет дату, за которую нужно скачать лог. Скачать лог можно в точности до часа. Возможные значения:
- 2019-08. Скачиваем лог за август 2019 года
- 2019-08-23. Скачиваем лог за 23 августа 2019 года
- 2019-08-23-04. Скачиваем лог за 23 августа 2019 года 4 утра (UTC)
Внимание!
Параметр часа указывается в UTC.
-
--progressbar (-pb). Вывод прогресса скачивания.
Внимание!
Для пользования данным функционалом потребуется установить дополнительный python модуль.
-
--file (-f). Вывод логов в файл $account_$date.txt.gz . По умолчанию скрипт выдает поток сжатых логов в stdout.
Возможные сценарии использования:
-
Скачиваем лог за 23 августа 2019 год и архивируем его в файл account_2019-08-23.txt.gz
python get-cdnvideo-logs.py -a account -u username -d 2019-08-23 -f -
Скачиваем лог за август 2019 года с выводом прогрессбара, архивируем его в файл account_2019-08.txt.gz
python get-cdnvideo-logs.py -a account -u username -d 2019-08 -pb -f
Возможные ошибки
-
"Error: A connection error occurred"
Возможные причины: Отсутствие интернета, проблемы с сетью. Упал сервер.
Что делать:
-
Убедиться, что у Вас есть интернет
ping google.com
-
Если не помогло, обратиться в службу поддержки
-
-
"Timeout: page connection timeout more than seconds: 5"
Возможные причины: Сервер не отвечает, проблемы с сетью
Что делать:
- Проверить сетевое подключение.
- Обратиться в службу поддержки.
-
"Error: Wrong username or password"
Возможные причины: Неверно введена пара логин/пароль (аргументы -u username, -p password )
Что делать:
- Проверить, что аргументы username, password правильно заполнены.
- Если ошибка остается, обратиться в службу поддержки.
-
"Error: account not found"
Возможные причины: Нет такого account для username.
Что делать:
- Проверить, что аргумент -a account введен верно для username.
- Если ошибка остается, обратиться в службу поддержки.
-
"Error: We don't have any log for this date"
Возможные причины: У нас нет лог-файла за данный период времени
Что делать:
- Проверить в разделе статистики наличие трафика за требуемый интервал.
- Проверить наличие лог-файла с помощью обращения к API.
- Обратиться в службу поддержки.
-
"Error: Problem with server/page down"
Возможные причины: Проблемы с сервером
Что делать:
- Обратиться в службу поддержки
-
При получении других ошибок - обратитесь в службу поддержки