nav-img
Evolution
CDN

API статистики партнерских CDN

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

К таким зонам относятся:

  • EMEA (Европа, Ближний Восток и Африка);

  • APAC (Азиатско-Тихоокеанский регион и Япония);

  • AM (Америка).

Статистика по трафику

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

URL: https://api.cdn.sber.cloud/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ОК
400NoneNoneПлохой запрос
401NoneNoneНет доступа
404NoneNoneНе найдено
405NoneNoneМетод не поддерживается
500NoneNoneВнутренняя ошибка сервера
503NoneNoneСервис недоступен

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

curl -H "CDN-AUTH-TOKEN: $TOKEN"
https://api.cdn.sber.cloud/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.cdn.sber.cloud/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ОК
400NoneNoneПлохой запрос
401NoneNoneНет доступа
404NoneNoneНе найдено
405NoneNoneМетод не поддерживается
500NoneNoneВнутренняя ошибка сервера
503NoneNoneСервис недоступен

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

curl -H "CDN-AUTH-TOKEN: $TOKEN"
'https://api.cdn.sber.cloud/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
}
}