nav-img
Evolution
CDN

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • Тип данных ответа: JSON Object

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

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

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

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

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

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

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

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • Тип данных ответа: JSON Object

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

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

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

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

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

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

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

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • Тип данных ответа: JSON Object

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

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

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

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

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

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

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

  • Тип запроса: GET

  • Заголовки: CDN-AUTH-TOKEN

  • Тип данных ответа: JSON Object

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

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

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

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