Статистика

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

статистики через API;
статистики партнерских CDN через API;
сырых логов через API.

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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.ru/app/stat-ext-1/v1/p1/traffic?account=<account>&hostname=<hostname>&area=<area>&startdate=<start_date>&enddate=<end_date>&granularity=<granularity>

Тип запроса: GET
Заголовки: CDN-AUTH-TOKEN
GET-параметры (* - обязательные) :
1. account - название аккаунта;
2. hostname - домен;
3. area - регион (apac/am/emea);
4. startdate * - дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ (UTC);
5. enddate - дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ (UTC).
  
  Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;
6. granularity - гранулярность по времени, размер интервалов в выдаче. Задаётся в секундах.
Тип данных ответа: JSON Object.

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

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/stat-ext-1/v1/p1/bandwidth?account=<account>&hostname=<hostname>&area=<area>&startdate=<start_date>&enddate=<end_date>&granularity=<granularity>

Тип запроса: GET
Заголовки: CDN-AUTH-TOKEN
GET-параметры (* - обязательные) :
1. account - название аккаунта;
2. hostname - домен;
3. area - регион (apac/am/emea);
4. startdate * - дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ (UTC);
5. enddate - дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ (UTC).
  
  Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;
6. granularity - гранулярность по времени, размер интервалов в выдаче. Задаётся в секундах.
Тип данных ответа: JSON Object.

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

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/realtimestat/v1/accounts

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/realtimestat/v1/accounts/<account>

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/realtimestat/v1/accounts/<account>/resources

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/realtimestat/v1/accounts/<account>/resources/<resource>

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/activesessions/v1/streams

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.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.globalcloudnetwork.ru/app/logs/v1/accounts/<your_account_name>/exists?startdate=<start_date>&enddate=<end_date>

Тип запроса: GET
Заголовки: CDN-AUTH-TOKEN
Обязательные GET-параметры:
1. startdate — дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ
2. enddate — дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ
Тип данных ответа: JSON Object или String в случае ошибки

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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.globalcloudnetwork.ru/app/logs/v1/accounts/<your_account_name>/get?startdate=<start_date>&enddate=<end_date>

Тип запроса: GET
Заголовки: CDN-AUTH-TOKEN
Обязательные GET-параметры:
1. startdate — дата и время начала интервала в формате YYYY-MM-DDTHH:mm:ssZ
2. enddate — дата и время окончания интервала YYYY-MM-DDTHH:mm:ssZ
Тип данных ответа: gzip-поток

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

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

curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.globalcloudnetwork.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. Подробное описание результирующего файла представлено выше.