Получение данных о времени и скорости загрузки сайта, которые отображаются на графиках

Адрес для отправки запросов

Запросы должны отправляться методом GET или POST к следующему адресу:

Список параметров запроса

api_key

Обязательный параметр: да.
Значение: ваш уникальный ключ API, который можно найти в личном кабинете в разделе «Настройки профиля».
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&api_key=6e59663b2ce62ac378be24bc30f48b95946&[другие параметры]

id

Обязательный параметр: да.
Значение: ID задачи, о которой необходимо получить информацию.
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&id=2&[другие параметры]

dt_from

Обязательный параметр: нет.
Значение по умолчанию: минус 1 день от текущей даты.
Значение: Дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС, начиная с которых нужно выводить данные о времени и скорости загрузки сайта (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&dt_from=2012-01-31+23:45:30&[другие параметры]

dt_to

Обязательный параметр: нет.
Значение по умолчанию: текущая дата.
Значение: Дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС, до которых нужно выводить данные о времени и скорости загрузки сайта (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&dt_to=2022-12-31+23:45:30&[другие параметры]

limit

Обязательный параметр: нет.
Значение: количество последних записей, которые необходимо показать; не рекомендуется указывать большой интервал в dt_from и dt_to, а затем ограничивать выдачу с помощью limit; если необходимо получать мало записей, то правильнее ограничить выдачу с помощью dt_from, dt_to.
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&limit=11&[другие параметры]

notnull

Обязательный параметр: нет.
Значение по умолчанию: 0.
Значение: если указано значение 1, то не будут выводиться данные о пустых местах на графике (когда проверки не выполнялись, и где значения времени и скорости указаны «null»).
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&notnull=1&[другие параметры]

tm

Обязательный параметр: нет.
Значение: ID точки мониторинга, только информацию о которой нужно выводить (актуально только при алгоритме проверки не «Авто»).
Пример использования:

https://ping-admin.com/?a=api&sa=task_graph_stat&tm=ru1&[другие параметры]

enc

Обязательный параметр: нет.
Значение: если указано «utf8», то в ответе будет заголовок «Content-type: application/json; charset=utf8» и кодировка ответа будет UTF-8.
Пример использования:

https://ping-admin.com/?enc=utf8&[остальные парамтеры]

Ответ на отправленный запрос (алгоритм проверки у задачи — «Авто»)

Если в настройках выбранной задачи указан алгоритм проверки «Авто», то ответ будет следующий:

Список параметров ответа

tmstamp

Тип: целое число.
Значение: время получения данных о скорости загрузки и времени ответа сайта; количество секунд, прошедших с 01.01.1970.

total

Тип: дробное число.
Значение: общее время, потраченное на получение ответа сайта (а для задач с типом «Ping» тут указано время ответа проверяемого адреса).

dns

Тип: дробное число.
Значение: время, потраченное на определение IP по адресу сайта.

connect

Тип: дробное число.
Значение: время, потраченное на соединение с сайтом.

server

Тип: дробное число.
Значение: время, потраченное на ожидание ответа сервера (между соединением и началом передачи данных).

speed

Тип: целое число.
Значение: скорость загрузки проверяемой страницы сайта в байтах в секунду.

Ответ на отправленный запрос (выбраны конкретные точки мониторинга, из которых выполняются проверки)

Если же в настройках выбранной задачи указан алгоритм проверки не «Авто» (т.е. проверки выполняются из выбранных точек мониторинга), то ответ будет следующий:

Список параметров ответа

tm_id

Тип: текст.
Значение: ID точки мониторинга, от которой получены данные.

tm_name

Тип: текст.
Значение: название точки мониторинга, от которой получены данные.

tm_res

Тип: массив.
Значение: данные о времени и скорости ответа сайта, описание которых есть выше для алгоритма проверки «Авто».

← Назад к разделам API