Общие сведения
Данный 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://apicdn.rcloud.ru/app/realtimestat/v1/accounts
- Тип запроса: GET
- Заголовки: CDN-AUTH-TOKEN
- Тип данных ответа: JSON Array
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \ 'https://apicdn.rcloud.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://apicdn.rcloud.ru/app/realtimestat/v1/accounts/<account>
- Тип запроса: GET
- Заголовки: CDN-AUTH-TOKEN
- Тип данных ответа: JSON Array
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \ 'https://apicdn.rcloud.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://apicdn.rcloud.ru/app/realtimestat/v1/accounts/<account>/resources
- Тип запроса: GET
- Заголовки: CDN-AUTH-TOKEN
- Тип данных ответа: JSON Array
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \ 'https://apicdn.rcloud.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://apicdn.rcloud.ru/app/realtimestat/v1/accounts/<account>/resources/<resource>
- Тип запроса: GET
- Заголовки: CDN-AUTH-TOKEN
- Тип данных ответа: JSON Array
Пример запроса
curl -H "CDN-AUTH-TOKEN: $TOKEN" \ 'https://apicdn.rcloud.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 } ]