Статистика
В данном разделе Вы можете узнать о получении:
- статистики через API;
- статистики партнерских CDN через API;
- сырых логов через API.
API статистики
Общие сведения
Внимание!
- Установлено ограничение на количество обращений к API:
- не больше 5 обращений в минуту.
- Отставание статистики может быть до часа. Для получения статистики с минимальной задержкой используйте API realtime статистики
- Тип запроса: GET
- Тип данных ответа: JSON
- Язык ответа определяется в первую очередь из строки запроса language. Если не задан, то из заголовка запроса Accept-Language. Если оба значения не заданы, то выбирается английский. Язык, в котором вернулся ответ, будет записан в заголовок ответа Accept-Language
- Авторизационный токен определяется в первую очередь из строки запроса cdnauthtoken. Если не задан, то из заголовка запроса cdn-auth-token. Если оба не заданы, то вернется ошибка
- Даты (start, end) должны передаваться в формате ISO 8601: YYYY-MM-DDThh\:mm\:00, где YYYY - год, MM - месяц, DD - день, hh - часы, mm - минуты. Секунды всегда указываются как 00. Важно: При отправке запроса через URL, символ '+' в часовом поясе необходимо закодировать как '%2B'. Например, +03:00 становится %2B03: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")
- Временная зона (timezone) определяет часовой пояс, в котором будет показываться результат запроса. Указывается идентификатором IANA в виде часового пояса UTC или географического положения (например, Europe/Moscow, Iran).
Описание заголовков запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| Accept-Language | Язык | Нет |
| cdn-auth-token | Авторизационный токен | Да/Нет |
Возможные коды ответа:
| Код ответа | Данные ответа | Описание ответа |
|---|---|---|
| 200 | OK | успешное выполнение запроса |
| 401 | token is invalid | токен не был указан |
| 401 | no accounts available | по заданному токену нет доступных аккаунтов |
| 401 | account {account} is not available | указанный аккаунт не доступен |
| 400 | unknown path | указанного пути нет |
| 400 | required key {req} not in query string | для данного пути не был указан обязательный параметр |
| 400 | required key {req} for {req for} not in query string | для определенного параметра не был указан обязательный параметр |
| 400 | {arg} is not possible query argument | неизвестный параметр |
| 400 | {arg} is invalid query argument | параметр имеет некорректное значение |
| 400 | {arg} is invalid query argument (possible values: {possible values}) | параметр имеет некорректное значение |
| 400 | start must be less 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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 | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| 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, которые возвращают названия страны и региона в читаемом виде в языке, который был выбран
- Допустимые значения параметра stream_type: live, vod, unknown
- Для фильтра по региону необходимо указать страну
- Для фильтра по потоку необходимо указать аккаунт
- Аргумент 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 {account} is not available | указанный аккаунт не доступен |
| 422 | {message} | неправильно задан один из передаваемых параметров (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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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/stream-types
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| language | Язык (ru или en) | Нет |
| cdnauthtoken | Авторизационный токен | Да/Нет |
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Нет |
| stream | Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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/stream-types?start=2020-08-01T00:00:00Z&end=2020-08-02T00:00:00Z&sort=-views&limit=2&fields=views,users,views_max&account=account'
Пример успешного ответа
{
"result": [
{
"stream_type": "live",
"views": 6737,
"users": 5382,
"views_max": 356
},
{
"stream_type": "vod",
"views": 6438,
"users": 5145,
"views_max": 343
}
],
"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/browsers
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| language | Язык (ru или en) | Нет |
| cdnauthtoken | Авторизационный токен | Да/Нет |
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Нет |
| stream | Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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/stream-types
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| language | Язык (ru или en) | Нет |
| cdnauthtoken | Авторизационный токен | Да/Нет |
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| granularity | Гранулярность | Да |
| account | Имя аккаунта | Нет |
| stream | Название потока (может быть задано несколько, например ..?stream=stream_name1&stream=stream_name2) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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/stream-types?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-01T12:00:00Z",
"end": "2020-08-01T13:00:00Z",
"result": [
{
"stream_type": "live",
"views_max": 4914,
"users": 14012,
"views": 20670
}
]
},
{
"start": "2020-08-01T11:00:00Z",
"end": "2020-08-01T12:00:00Z",
"result": [
{
"stream_type": "live",
"views_max": 4097,
"users": 12908,
"views": 18458
}
]
}
],
"start": "2020-08-01T00:00:00Z",
"end": "2020-08-02T00:00:00Z",
"granularity": "PT1H",
"account": "account",
"fields": [
"views",
"users",
"views_max"
],
"sort": "-views",
"limit": 2
}
Браузеры
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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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) | Нет |
| stream_type | Тип потока (может быть задано несколько, например ..?stream_type=live&stream_type=vod) | Нет |
| 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-параметры (* - обязательные) :
- account - название аккаунта;
- hostname - домен;
- area - регион (apac/am/emea);
- startdate * - дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ(UTC); -
enddate - дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ(UTC).Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;
-
granularity - гранулярность по времени, размер интервалов в выдаче. Задаётся в секундах.
-
Тип данных ответа: JSON Object.
Количественное значение трафика выдается как значение ключа "value" (в байтах).
| Код ответа | Данные ответа | Формат ответа | Описание |
|---|---|---|---|
| 200 | Статистика по трафику | JSON | ОК |
| 400 | None | None | Плохой запрос |
| 401 | None | None | Нет доступа |
| 404 | None | None | Не найдено |
| 405 | None | None | Метод не поддерживается |
| 500 | None | None | Внутренняя ошибка сервера |
| 503 | None | None | Сервис недоступен |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.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-параметры (* - обязательные) :
- account - название аккаунта;
- hostname - домен;
- area - регион (apac/am/emea);
- startdate * - дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ(UTC); -
enddate - дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ(UTC).Если данный параметр не указан, то отдаются интервалы, для которых начало = startdate;
-
granularity - гранулярность по времени, размер интервалов в выдаче. Задаётся в секундах.
-
Тип данных ответа: JSON Object.
Количественное значение полосы выдается как значение ключа "value" (в Мбит/c).
| Код ответа | Данные ответа | Формат ответа | Описание |
|---|---|---|---|
| 200 | Статистика по полосе | JSON | ОК |
| 400 | None | None | Плохой запрос |
| 401 | None | None | Нет доступа |
| 404 | None | None | Не найдено |
| 405 | None | None | Метод не поддерживается |
| 500 | None | None | Внутренняя ошибка сервера |
| 503 | None | None | Сервис недоступен |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.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 статистики Managed DNS
Общие сведения
Данный API используется для получения статистики по Managed DNS
- Даты (start, end) должны передаваться в формате ISO 8601: YYYY-MM-DDThh\:mm\:00, где YYYY - год, MM - месяц, DD - день, hh - часы, mm - минуты. Секунды всегда указываются как 00. Важно: При отправке запроса через URL, символ '+' в часовом поясе необходимо закодировать как '%2B'. Например, +03:00 становится %2B03:00.
- Разбиение (granularity) имеет формат: упрощенную версию P[n]Y[n]M[n]DT[n]H[n]M[n]S ("P1M", "PT5M", но не "P1DT12H")
- Временная зона (timezone) определяет часовой пояс, в котором будет показываться результат запроса. Указывается идентификатором IANA в виде часового пояса UTC или географического положения (например, Europe/Moscow, Iran).
- Для фильтрации статистики используются такие параметры, как zone_name, rr_type и rr_set_name. Эти параметры имеют последовательную зависимость друг от друга. При указании rr_set_name надо указывать rr_type и zone. При указании rr_type необходимо указывать zone.
Описание параметров ответа:
| Имя параметра | Описание |
|---|---|
| success_count | Количество успешных резолвов |
| fail_count | Количество неуспешных резолвов |
Общая статистика
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| zone_name | Имя зоны | Нет |
| rr_set_type | Тип записи | Нет |
| rr_set_name | Доменное имя | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"result":
{
"success_count": 12,
"fail_count": 1
}
}
Группировка данных
Имя зоны
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/zone-names
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| zone_name | Имя зоны (указывается списком) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/zone-names?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"zone_name": "zone_1",
"success_count": 12,
"fail_count": 1
},
{
"zone_name": "zone_2",
"success_count": 9,
"fail_count": 3
}
]
}
Тип записи
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/rr-set-types
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| zone_name | Имя зоны | Нет |
| rr_set_type | Тип записи (указывается списком) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/rr-set-types?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"zone_name": "zone_1",
"rr_set_type": "rr_type_1",
"success_count": 12,
"fail_count": 1
},
{
"zone_name": "zone_2",
"rr_set_type": "rr_type_1",
"success_count": 9,
"fail_count": 3
}
]
}
Доменное имя
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/rr-set-names
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| zone_name | Имя зоны | Нет |
| rr_set_type | Тип записи | Нет |
| rr_set_name | Доменное имя (указывается списком) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/rr-set-names?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"zone_name": "zone_1",
"rr_set_type": "rr_type_1",
"rr_set_name": "rr_set_name_1",
"success_count": 12,
"fail_count": 1
},
{
"zone_name": "zone_2",
"rr_set_type": "rr_type_1",
"rr_set_name": "rr_set_name_1",
"success_count": 9,
"fail_count": 3
}
]
}
Интервалы времени
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/times
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| granularity | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| zone_name | Имя зоны | Нет |
| rr_set_type | Тип записи | Нет |
| rr_set_name | Доменное имя | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/times?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z&granularity=PT15M'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"granularity": "PT15M",
"timezone": "UTC",
"result": [
{
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:15:00Z",
"result": [
{
"success_count": 12,
"fail_count": 1
}
]
},
{
"start": "2024-05-20T00:15:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"success_count": 13,
"fail_count": 4
}
]
}
]
}
Группировка данных с учетом времени
Имя зоны
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/times/zone-names
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| granularity | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| zone_name | Имя зоны (указывается списком) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/times/zone-names?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z&granularity=PT15M'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"granularity": "PT15M",
"result": [
{
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:15:00Z",
"result": [
{
"zone_name": "zone_1",
"success_count": 12,
"fail_count": 1
},
{
"zone_name": "zone_2",
"success_count": 12,
"fail_count": 1
}
]
},
{
"start": "2024-05-20T00:15:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"zone_name": "zone_1",
"success_count": 13,
"fail_count": 4
},
{
"zone_name": "zone_2",
"success_count": 12,
"fail_count": 1
}
]
}
]
}
Тип записи
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/times/rr-set-types
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| granularity | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| zone_name | Имя зоны | Нет |
| rr_set_type | Тип записи (указывается списком) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/times/rr-set-types?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z&granularity=PT15M'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"granularity": "PT15M",
"result": [
{
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:15:00Z",
"result": [
{
"zone_name": "zone_1",
"rr_set_type": "rr_type_1",
"success_count": 12,
"fail_count": 1
},
{
"zone_name": "zone_2",
"rr_set_type": "rr_type_1",
"success_count": 12,
"fail_count": 1
}
]
},
{
"start": "2024-05-20T00:15:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"zone_name": "zone_1",
"rr_set_type": "rr_type_1",
"success_count": 13,
"fail_count": 4
},
{
"zone_name": "zone_2",
"rr_set_type": "rr_type_1",
"success_count": 12,
"fail_count": 1
}
]
}
]
}
Доменное имя
URL: http://api.globalcloudnetwork.ru/app/dns-stat/v1/times/rr-set-names
Описание параметров запроса:
| Имя параметра | Описание | Обязательный |
|---|---|---|
| start | Дата-время, от которой производится расчет (включительно) | Да |
| end | Дата-время, до которой производится расчет (не включительно) | Да |
| account | Имя аккаунта | Да |
| granularity | Разбиение | Да |
| timezone | Временная зона результата | Нет |
| zone_name | Имя зоны | Нет |
| rr_set_type | Тип записи | Нет |
| rr_set_name | Доменное имя (указывается списком) | Нет |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" 'https://api.globalcloudnetwork.ru/app/dns-stat/v1/times/rr-set-names?account=test&start=2024-05-20T00:00:00Z&end=2024-05-20T00:30:00Z&granularity=PT15M'
Пример успешного ответа
{
"account": "test",
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:30:00Z",
"granularity": "PT15M",
"result": [
{
"start": "2024-05-20T00:00:00Z",
"end": "2024-05-20T00:15:00Z",
"result": [
{
"zone_name": "zone_1",
"rr_set_type": "rr_type_1",
"rr_set_name": "rr_set_name_1",
"success_count": 12,
"fail_count": 1
},
{
"zone_name": "zone_2",
"rr_set_type": "rr_type_1",
"rr_set_name": "rr_set_name_1",
"success_count": 12,
"fail_count": 1
}
]
},
{
"start": "2024-05-20T00:15:00Z",
"end": "2024-05-20T00:30:00Z",
"result": [
{
"zone_name": "zone_1",
"rr_set_type": "rr_type_1",
"rr_set_name": "rr_set_name_1",
"success_count": 13,
"fail_count": 4
},
{
"zone_name": "zone_2",
"rr_set_type": "rr_type_1",
"rr_set_name": "rr_set_name_1",
"success_count": 12,
"fail_count": 1
}
]
}
]
}
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-параметры:
- startdate — дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ - enddate — дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ
- startdate — дата и время начала интервала в формате
- Тип данных ответа: JSON Object или String в случае ошибки
| Код ответа | Данные ответа | Формат ответа | Описание |
|---|---|---|---|
| 200 | Информация о наличии логов за определенный интервал времени | JSON | ОК |
| 400 | None | None | Плохой запрос |
| 401 | None | None | Нет доступа |
| 404 | None | None | Не найдено |
| 500 | None | None | Внутренняя ошибка сервера |
| 503 | None | None | Сервис недоступен |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.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-параметры:
- startdate — дата и время начала интервала в формате
YYYY-MM-DDTHH:mm:ssZ - enddate — дата и время окончания интервала
YYYY-MM-DDTHH:mm:ssZ
- startdate — дата и время начала интервала в формате
- Тип данных ответа: gzip-поток
| Код ответа | Данные ответа | Формат ответа | Описание |
|---|---|---|---|
| 200 | Логи за определенный интервал времени | gzip-поток | ОК |
| 400 | None | None | Плохой запрос |
| 401 | None | None | Нет доступа |
| 404 | None | None | Не найдено |
| 500 | None | None | Внутренняя ошибка сервера |
| 503 | None | None | Сервис недоступен |
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \
'https://api.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. Подробное описание результирующего файла представлено выше.