Вход в личный кабинет
Логин: Регистрация
Пароль: Забыли пароль?
Демо-вход

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

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

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

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

https://ping-admin.ru/?a=api&sa=edit_task&[список параметров, описание которых ниже]

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

api_key
Обязательный параметр: да.
Значение: ваш уникальный ключ API, который можно найти в личном кабинете в разделе «Настройки профиля».
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&api_key=6e59663b2ce62ac378be24bc30f48b95946&[другие параметры]
id
Обязательный параметр: да.
Значение: ID задачи, которую необходимо изменить.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&id=2&[другие параметры]
url
Обязательный параметр: нет.
Значение: адрес или IP проверяемого сервиса.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&url=ping-admin.ru%2Ffree_test%2F&[другие параметры]
hosts_ip
Обязательный параметр: нет.
Значение: IP (IPv4) проверяемого сайта, к которому будет идти обращение вне зависимости от того, что прописано для адреса сайта в DNS. Если указать «no_change» (без кавычек), то данный параметр в настройках задачи останется без изменений.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&hosts_ip=1.2.3.4&[другие параметры]
nazv
Обязательный параметр: нет.
Значение: название задачи, которое выводится в личном кабинете и уведомлениях об ошибках вместо (или вместе) с URL; текст не более 255 символов в кодировке Windows-1251. Если указать «empty» (без кавычек), то данный параметр в настройках задачи очистится (задача станет без названия).
Пример использования:
https://ping-admin.ru/?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.ru/?a=api&sa=edit_task&period=3&[другие параметры]
txt
Обязательный параметр: нет.
Значение по умолчанию: пустая строка.
Значение: текст, который нужно искать в коде страницы при проверке сайта методом GET или POST (текст может быть только из ASCII-символов — латинские буквы, цифры и некоторые специальные символы). Если указать «no_change» (без кавычек), то данный параметр в настройках задачи останется без изменений.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&txt=search_text_12345&[другие параметры]
httpcode_from
Обязательный параметр: нет.
Значение: HTTP-код ответа (начало допустимого диапазона). Если тут и в следующем параметре указано 0, то нормальным считается ответ в диапазоне 200–399.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&httpcode_from=200&[другие параметры]
httpcode_to
Обязательный параметр: нет.
Значение: HTTP-код ответа (конец допустимого диапазона). Если тут и в предыдущем параметре указано 0, то нормальным считается ответ в диапазоне 200–399.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&size_to=399&[другие параметры]
size_from
Обязательный параметр: нет.
Значение: минимальный ожидаемый размер проверяемой страницы в байтах; если указано 0, то минимальный размер страницы не проверяется.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&size_from=1000&[другие параметры]
size_to
Обязательный параметр: нет.
Значение: максимальный ожидаемый размер проверяемой страницы в байтах; если указано 0, то максимальный размер страницы не проверяется.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&size_to=2000&[другие параметры]
sb
Обязательный параметр: нет.
Значение: проверять ли сайт на вирусы: 0 — не проверять, 1 — проверять; актуально только для проверок с типами HTTP, HTTPS.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&sb=1&[другие параметры]
rk
Обязательный параметр: нет.
Значение: проверять ли сайт на наличие базах Роскомнадзора, Spamhaus и других: 0 — не проверять, 1 — проверять; актуально только для проверок с типами HTTP, HTTPS, Ping.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&rk=1&[другие параметры]
oshib
Обязательный параметр: нет.
Значение: при какой подряд ошибке отправлять уведомление (0 — сразу; 1 — при второй подряд ошибке; 2 — при третьей; 4 — при пятой; 9 — при десятой подряд ошибке).
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&oshib=0&[другие параметры]
test_redirect
Обязательный параметр: нет.
Значение: если проверяемый адрес производит редирект, следовать ли по редиректу: 0 — не следовать, 1 — следовать.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&test_redirect=1&[другие параметры]
status
Обязательный параметр: нет.
Значение: 1 — задача включена, проверки выполняются, 0 — задача отключена, проверки не выполняются.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&status=0&[другие параметры]
ssl_version
Обязательный параметр: нет.
Значение: какой протокол использовать для проверок сайтов с SSL-сертификатами: 1 — использовать TLS; 0 — использовать SSLv3.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&ssl_version=0&[другие параметры]
mails
Обязательный параметр: нет.
Значение: адреса электронной почты, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой. Для удаления из настроек задачи всех адресов электронной почты в этом поле нужно указать пробел.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&mails=test1%40site.ru,test2%40site.ru&[другие параметры]
phones
Обязательный параметр: нет.
Значение: номера телефонов для SMS, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой (только цифры, в международном формате [код страны][код города или сети][номер телефона]. Для удаления из настроек задачи всех телефонов в этом поле нужно указать пробел.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&phones=79991112233,38060000000&[другие параметры]
gphones
Обязательный параметр: нет.
Значение: номера телефонов для звонков, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой (только цифры, в международном формате [код страны][код города или сети][номер телефона]. Для удаления из настроек задачи всех телефонов в этом поле нужно указать пробел.
Пример использования:
https://ping-admin.ru/?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.ru/?a=api&sa=edit_task&ims=12345,jabber%40site.ru&[другие параметры]
https
Обязательный параметр: нет.
Значение: адреса для HTTP-уведомлений, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой. Для удаления из настроек задачи всех телефонов в этом поле нужно указать пробел.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&https=http%3A%2F%2Fsite.ru%2Fscript.php&[другие параметры]

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

[{"status":"OK"}]

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

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

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

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

Регистрация
Наши возможности
Наши точки мониторинга
Новости
Тарифы и способы оплаты
Акции и скидки
Бесплатные проверки:
Детальная разовая проверка сайта
Ping
Проверка обратных ссылок
Проверка ИКС
Регулярная проверка сайта
Рейтинг хостингов
Рейтинг фотохостингов
API Реклама на сайте
Партнёрская программа
Наши логотипы
Поддержка
Частые вопросы
Форум
Условия использования.
© Ping-Admin.Ru 2009–2018.
Концепция, программирование и дизайн проекта — «Седжин».
Ping-Admin.Ru — проверка работоспособности сайта.