Документация

Графики CDN

Метод для получения данных, позволяющих строить графики, отражающие параметры CDN конкретного провайдера за последнее время.

URL

/api/v1/graph/{provider}/{period}/{quantile}

Подставляемые значения:

{provider} - id провайдера CDN, в отношении которой запрашиваются данные, может быть одним из значений полученных посредством метода.
{period} - период времени, за который запрашиваются данные, может принимать следующие значения: hour (последний час), 6h (последние 6 часов), day (последние сутки), week (последняя неделя), month (последний месяц). Для просмотра данных за неделю и месяц требуется дополнительно право на просмотр данных CDN на большую глубину.
{quantile} - квантиль данных в каждой точке, может принимать следующие значения: P10 (10-й перцентиль), P25 (25-й перцентиль), P50 (медиана/50-й перцентиль), P75 (75-й перцентиль), P90 (90-й перцентиль), P95 (95-й перцентиль).

Метод

GET

Описание возвращаемых данных

Метод возвращает JSON-объект со следующими полями:

success - булево значение, означающее успешность исполнения запроса;
error - опциональное, строка с описанием ошибки, если success: false;
data - в случае успешного исполнения запроса (success: true) объект с данными.

Объект data имеет следующие поля:

rtt - время отклика (round-trip time);
ttfb-http и ttfb-https - время подключения (time to first byte) соответственно по протоколам HTTP и HTTPS;
down-cached и down-notcached - скорость загрузки конетента в сети, соответственно находящегося в кэше, и вне кэша;
avail-http и avail-https - доступность, т.е. процент успешно завершенных запросов, соответственно по протоколам HTTP и HTTPS.

В каждом из вышеуказанных полей возвращается массив, состоящий из двухэлементных массивов, которые следует интерпретировать как [время, значение], где время - это стандартный UNIX timestamp. Значения для параметров rtt и ttfb - в миллисекундах, для down - в мегабитах в секунду, для avail - в процентах.

Пример

Запрос:

curl --location 'https://cdnmon.net/api/v1/graph/cdnvideo/6h/P50' \ --header 'Authorization: Bearer wGGtaQVncybYmhbiAab9poccBWoU4n0c1H0ee2zVyICWEM7B9s0DFrzU'

Ответ:

{ "success": true, "data": { "rtt": [[1762322100.0,7],[1762322400.0,7], ... ], "ttfb-https": [[1762322100.0,157], [1762322400.0,156], ... ], "ttfb-http": [[1762322100.0,120], [1762322400.0,121], ... ], "down-notcached": [[1762322100.0,4.2266845703125], [1762322400.0,4.20379638671875], ... ], "down-cached": [[1762322100.0,106.78863525390625], [1762322400.0,106.3690185546875], ... ], "avail-https": [[1762322700.0,99.71248876909254], [1762323000.0,99.70230121163407], ... ], "avail-http": [[1762322700.0,99.70950256057021], [1762323000.0,99.71426020180374], ... ] } }

Ответ в случае ошибки:

{ "success": false, "error": "Произошла ошибка при выполнении запроса, проверьте параметры" }