Получение списка задач
Адрес для отправки запросов
Запросы должны отправляться методом GET или POST к следующему адресу:
https://ping-admin.com/?a=api&sa=tasks&[список параметров, описание которых ниже]
Список параметров запроса
- api_key
-
Обязательный параметр: Да.
Значение: Ваш уникальный ключ API, который можно найти в личном кабинете в разделе «Настройки профиля».
Пример использования:
https://ping-admin.com/?a=api&sa=tasks&api_key=6e59663b2ce62ac378be24bc30f48b95946 - task_id
-
Обязательный параметр: Нет.
Значение: ID задачи, если нужно вывести информацию не по всем задачам, а лишь по одной конкретной.
Пример использования:
https://ping-admin.com/?a=api&sa=tasks&task_id=3 - enc
-
Обязательный параметр: нет.
Значение: если указано «utf8», то в ответе будет заголовок «Content-type: application/json; charset=utf8» и кодировка ответа будет UTF-8.
Пример использования:
https://ping-admin.com/?enc=utf8&[остальные парамтеры]
Ответ на отправленный запрос
[{"last_data":"2010-04-29 12:00:04","log_data":"2010-04-29 11:15:07","log_status":1,"name":"ping-admin.com","nazv":"","period":2,"period_error":0,"sb":0,"sb_log_data":null,"sb_log_status":1,"status":1,"tasks_ims_icq_list":[],"tasks_ims_jabber_list":[{"name":"demo@ping-admin.com"}],"tasks_mails_list":[{"name":"demo@ping-admin.com"}],"tasks_phones_list":[{"fio":"","name":"79871234567"}],"tid":1,"tip":"http (get)","uptime_nw":0,"uptime_w":2548780},{"last_data":"2010-04-29 12:00:05","log_data":"2010-04-29 11:16:18","log_status":1,"name":"sms-form.ru","nazv":"Сервис Email 2 SMS","period":5,"period_error":0,"sb":0,"sb_log_data":null,"sb_log_status":1,"rk":0,"rk_ip":0,"rk_log_data":null,"rk_log_status":1,"status":1,"tasks_ims_icq_list":[{"name":"000000000"}],"tasks_ims_jabber_list":[],"tasks_mails_list":[{"name":"test@ping-admin.com"}],"tasks_phones_list":[{"fio":"","name":"79871234567"},{"fio":"","name":"79991112233"}],"tid":2,"tip":"http (head)","uptime_nw":0,"uptime_w":2548778},{"last_data":"2010-04-29 12:00:05","log_data":"2010-04-29 11:40:18","log_status":1,"name":"gmail.ru","nazv":"Почта","period":10,"period_error":0,"sb":0,"sb_log_data":null,"sb_log_status":1,"status":1,"tasks_mails_list":[{"name":"demo@ping-admin.com"},{"name":"proverka@ping-admin.com"}],"tid":3,"tip":"http (head)","uptime_nw":5,"uptime_w":2548754,"rrd":0}]
Список параметров ответа
- tid
-
Тип: целое число.
Значение: ID задачи. - tip
-
Тип: строка.
Значение: тип проверки. - name
-
Тип: строка.
Значение: адрес или IP проверяемого сервиса без «http://» и подобного. - nazv
-
Тип: строка.
Значение: название проверяемого сервиса. - period
-
Тип: целое число.
Значение: периодичность проверки сервиса (например, 20 означает, что проверки выполняются каждые 20 минут). - period_error
-
Тип: целое число.
Значение: периодичность проверки сервиса во время ошибки (например, 10 означает, что проверки выполняются каждые 10 минут, а 0 — периодичность такая же, как указано в параметре «period»). - log_status
-
Тип: целое число.
Значение: 1 — сервис работает; 0 — сервис не работает. - log_data
-
Тип: дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Значение: дата и время последнего изменения состояния сервиса (т.е. когда сервис перестал работать или когда он заработал). - sb
-
Тип: целое число.
Значение: 1 — выполняется проверка сайта на вирусы; 0 — не выполняется. - sb_log_status
-
Тип: целое число.
Значение: 1 — вирусов не найдено при последней проверке; 0 — вирусы есть на сайте при последней проверке (актуально, если проверка на наличие вирусов выполняется). - sb_log_data
-
Тип: дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Значение: дата и время последней проверки сайта на вирусы (актуально, если проверка на наличие вирусов выполняется). - rk
-
Тип: целое число.
Значение: 1 — выполняется проверка на наличие (домена или IP) в чёрных списках Роскомнадзора, Spamhaus и других; 0 — не выполняется. - rk_ip
-
Тип: целое число.
Значение: 0 — в базе Роскомнадзора ищется IP, имя домена и страница сайта; 1 — в базе Роскомнадзора не ищется IP сайта (только имя домена и страница); актуально только, если в параметре «rk&raqio; указано 1. - rk_log_status
-
Тип: целое число.
Значение: 1 — не найдено в чёрных списках Роскомнадзора и других при последней проверке; 0 — найден домен или IP в базах Роскомнадзора, Spamhaus и других при последней проверке (актуально, если проверка на наличие в базе Роскомнадзора и других выполняется). - rk_log_data
-
Тип: дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Значение: дата и время последней проверки на наличие в базах Роскомнадзора, Spamhaus и других (актуально, если такая проверка выполняется). - status
-
Тип: целое число.
Значение: 1 — проверки выполняются, задача включена; 0 — проверки не выполняются, задача отключена. - last_data
-
Тип: дата и время в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (в соответствии с часовым поясом, указанном в профиле пользователя Ping-Admin.Com).
Значение: дата и время последней проверки сервиса - tasks_mails_list
-
Тип: массив.
Значение: список адресов электронной почты, на которые отправляются уведомления о задаче.- name
- Тип: строка.
Значение: адрес электронной почты.
- tasks_phones_list
-
Тип: массив.
Значение: список телефонов для SMS, на которые отправляются уведомления о задаче.- fio
- Тип: строка.
Значение: описание (ФИО) владельца телефона. - name
- Тип: строка.
Значение: номер телефона в формате [код страны][код города или сети][номер абонента] (например: 79871234567).
- tasks_gphones_list
-
Тип: массив.
Значение: список телефонов для звонков, на которые отправляются голосовые уведомления о задаче.- fio
- Тип: строка.
Значение: описание (ФИО) владельца телефона. - name
- Тип: строка.
Значение: номер телефона в формате [код страны][код города или сети][номер абонента] (например: 79871234567).
- tasks_ims_telegram_list
-
Тип: массив.
Значение: список Telegram-идентификаторов, на которые отправляются уведомления о задаче.- name
- Тип: строка.
Значение: идентификатор в Telegram (соответствует тому, что указано в личном кабинете в разделе «Контакты для уведомлений / Telegram, ICQ, Skype, Jabber / Изменить у выбранного контакта»).
- tasks_ims_icq_list
-
Тип: массив.
Значение: список номеров ICQ, на которые отправляются уведомления о задаче.- name
- Тип: строка.
Значение: номер ICQ.
- tasks_ims_skype_list
-
Тип: массив.
Значение: список Skype-идентификаторов, на которые отправляются уведомления о задаче.- name
- Тип: строка.
Значение: идентификатор в Skype (соответствует тому, что указано в личном кабинете в разделе «Контакты для уведомлений / Telegram, ICQ, Skype, Jabber / Изменить у выбранного контакта»).
- tasks_ims_jabber_list
-
Тип: массив.
Значение: список Jabber-идентификаторов, на которые отправляются уведомления о задаче.- name
- Тип: строка.
Значение: идентификатор в Jabber.
- tasks_https_list
-
Тип: массив.
Значение: список адресов для HTTP-уведомлений.- name
- Тип: строка.
Значение: URL, на который отправляется запрос при изменении состояния задачи.
- rss
-
Тип: строка.
Значение: адрес RSS с информацией о последних проверках задачи. - uptime_nw
-
Тип: целое число.
Значение: общее количество минут, которые сервис не работал за всё время. - uptime_w
-
Тип: целое число.
Значение: общее количество минут, которые сервис работал за всё время. - rrd
-
Тип: целое число.
Значение: 1 — включено построение графиков с данными о времени и скорости загрузки сайта; 0 — отключено.