Изменение задачи

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

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

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

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

api_key

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

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

id

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

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

url

Обязательный параметр: нет.
Значение: адрес или IP проверяемого сервиса.
Пример использования:

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

hosts_ip

Обязательный параметр: нет.
Значение: IP (IPv4) проверяемого сайта, к которому будет идти обращение вне зависимости от того, что прописано для адреса сайта в DNS. Если указать «no_change» (без кавычек), то данный параметр в настройках задачи останется без изменений.
Пример использования:

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

nazv

Обязательный параметр: нет.
Значение: название задачи, которое выводится в личном кабинете и уведомлениях об ошибках вместо (или вместе) с URL; текст не более 255 символов в кодировке Windows-1251. Если указать «empty» (без кавычек), то данный параметр в настройках задачи очистится (задача станет без названия).
Пример использования:

https://ping-admin.com/?a=api&sa=edit_task&nazv=%F2%E5%F1%F2123&[другие параметры]

period

Обязательный параметр: нет.
Значение: периодичность проверки, возможными значениями которой являются: 1 — каждую минуту; 2 — раз в 2 минуты; 3; 4; 5; 6; 10; 15; 20; 30; 60 — раз в час.
Пример использования:

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

period_error

Обязательный параметр: нет.
Значение: периодичность проверки во время ошибки, возможными значениями которой являются: 0 —периодичность такая же, как в параметре «period»; 1 — каждую минуту; 2 — раз в 2 минуты; 3; 4; 5; 6; 10; 15; 20; 30; 60 — раз в час.
Пример использования:

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

txt

Обязательный параметр: нет.
Значение по умолчанию: пустая строка.
Значение: текст, который нужно искать в коде страницы при проверке сайта методом GET или POST (текст может быть только из ASCII-символов — латинские буквы, цифры и некоторые специальные символы). Если указать «no_change» (без кавычек), то данный параметр в настройках задачи останется без изменений.
Пример использования:

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

httpcode_from

Обязательный параметр: нет.
Значение: HTTP-код ответа (начало допустимого диапазона). Если тут и в следующем параметре указано 0, то нормальным считается ответ в диапазоне 200–399.
Пример использования:

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

httpcode_to

Обязательный параметр: нет.
Значение: HTTP-код ответа (конец допустимого диапазона). Если тут и в предыдущем параметре указано 0, то нормальным считается ответ в диапазоне 200–399.
Пример использования:

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

size_from

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

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

size_to

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

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

sb

Обязательный параметр: нет.
Значение: проверять ли сайт на вирусы: 0 — не проверять, 1 — проверять; актуально только для проверок с типами HTTP, HTTPS.
Пример использования:

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

rk

Обязательный параметр: нет.
Значение: проверять ли сайт на наличие базах Роскомнадзора, Spamhaus и других: 0 — не проверять, 1 — проверять; актуально только для проверок с типами HTTP, HTTPS, Ping.
Пример использования:

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

rk_ip

Обязательный параметр: нет.
Значение по умолчанию: 0.
Значение: 0 — выполнять все проверки по всем базам; 1 — не проверять наличие IP в базе Роскомнадзора (РКН); 2 — не проверять наличие IP в РКН и не проверять по Spamhaus и др.; 3 — не проверять по Spamhaus и др.; 11 — не проверять наличие IP и отдельных страниц сайта в РКН; 12 — не проверять наличие IP и отдельных страниц сайта в РКН и не проверять по Spamhaus и др. Значение в данном параметре актуально только, если в параметре «rk» указано 1.
Пример использования:

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

whois

Обязательный параметр: нет.
Значение: при значении 1 будет выполняться проверка изменений в WHOIS; 0 — не будет.
Пример использования:

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

oshib

Обязательный параметр: нет.
Значение: при какой подряд ошибке отправлять уведомление (0 — сразу; 1 — при второй подряд ошибке; 2 — при третьей; 4 — при пятой; 9 — при десятой подряд ошибке).
Пример использования:

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

uveddva

Обязательный параметр: нет.
Значение: отправлять ли уведомления об ошибке повторно (0 — не отправлять; 60 — только 1 раз через 1 час; 120 — только 1 раз через 2 часа; 180; 240; 300; 360; 420; 480; 540; 720; 1080; 1440 — только 1 раз через 24 часа; 601 — каждый час; 1201 — каждые 2 часа; 1801; 2401; 3001; 3601; 4201; 4801; 5401; 7201; 10801; 14401 — каждые 24 часа).
Пример использования:

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

test_redirect

Обязательный параметр: нет.
Значение: если проверяемый адрес производит редирект, следовать ли по редиректу: 0 — не следовать, 1 — следовать.
Пример использования:

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

test_https

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

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

cert

Обязательный параметр: нет.
Значение: при значении 1 присылать уведомления на адреса электронной почты, указанные в настройках задачи, за 30, 7 и 3 дня до окончания срока действия SSL-сертификата, а также уведомлять, если SSL-сертификат будет отозван ранее. Данная услуга позволяет не забыть обновить SSL-сертификат, когда срок его действия будет походить к концу (услуга платная).
Пример использования:

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

status

Обязательный параметр: нет.
Значение: 1 — задача включена, проверки выполняются, 0 — задача отключена, проверки не выполняются.
Пример использования:

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

ssl_version

Обязательный параметр: нет.
Значение: какой протокол использовать для проверок сайтов с SSL-сертификатами: 1 — использовать TLS; 0 — использовать SSLv3.
Пример использования:

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

mails

Обязательный параметр: нет.
Значение: адреса электронной почты, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой. Для удаления из настроек задачи всех адресов электронной почты в этом поле нужно указать пробел.
Пример использования:

https://ping-admin.com/?a=api&sa=edit_task&mails=test1%40site.ru,test2%40site.ru&[другие параметры]

phones

Обязательный параметр: нет.
Значение: номера телефонов для SMS, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой (только цифры, в международном формате [код страны][код города или сети][номер телефона]. Для удаления из настроек задачи всех телефонов в этом поле нужно указать пробел.
Пример использования:

https://ping-admin.com/?a=api&sa=edit_task&phones=79991112233,38060000000&[другие параметры]

gphones

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

https://ping-admin.com/?a=api&sa=edit_task&gphones=14621112233,79991112233&[другие параметры]

ims

Обязательный параметр: нет.
Значение: идентификаторы для API контактов в Telegram, ICQ, Skype или Jabber, указанные в личном кабинете в разделе «Контакты для уведомлений / Telegram, ICQ, Skype, Jabber / Изменить у выбранного контакта», через запятую или точку с запятой. Для удаления из настроек задачи всех контактов в Telegram, ICQ, Skype или Jabber в этом поле нужно указать пробел (%20).
Пример использования:

https://ping-admin.com/?a=api&sa=edit_task&ims=12345,jabber%40site.ru&[другие параметры]

https

Обязательный параметр: нет.
Значение: адреса для HTTP-уведомлений, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой. Для удаления из настроек задачи всех телефонов в этом поле нужно указать пробел.
Пример использования:

https://ping-admin.com/?a=api&sa=edit_task&https=http%3A%2F%2Fsite.ru%2Fscript.php&[другие параметры]

algoritm

Обязательный параметр: нет.
Значение: 0 — Авто; 1 — Из каждой выбранной точки мониторинга независимо; 2 — Из всех выбранных точек мониторинга (описание алгоритмов проверки).
Пример использования:

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

tm

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

https://ping-admin.com/?a=api&sa=edit_task&algoritm=2&tm=ru9,ru15&[другие параметры]

vid2_nw

Обязательный параметр: нет.
Значение: количество точек мониторинга, при получении информации об ошибке от которых будет считаться, что проверяемый сервис не работает. Используется только, если algoritm=2.
Пример использования:

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

enc

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

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

tmout

Обязательный параметр: нет.
Значение: максимальное ожидание ответа при проверке сайта от 2 до 8 секунд.
Пример использования:

https://ping-admin.com/?a=api&sa=edit_task&tmout=5&[остальные парамтеры]

Ответ на отправленный запрос

Если изменить задачу не удалось (переданы неверные параметры в запросе, указан неверный ID задачи), то в ответе будет информация об ошибке.

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

status

Тип: строка.
Значение: OK.

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