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

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

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

Внимание! Если в перечисленных ниже параметрах запроса не будет передано никаких значений (пустая строка), то в настройках задачи данные параметры останутся без изменений. Исключение — параметр «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&[другие параметры]
sb
Обязательный параметр: нет.
Значение: проверять ли сайт на вирусы: 0 — не проверять, 1 — проверять; актуально только для проверок с типами HTTP, HTTPS.
Пример использования:
https://ping-admin.ru/?a=api&sa=edit_task&sb=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
Обязательный параметр: нет.
Значение: контакты в ICQ или Jabber, указанные в разделе «Контакты для уведомлений» личного кабинета, через запятую или точку с запятой. Для удаления из настроек задачи всех контактов в ICQ или Jabber в этом поле нужно указать пробел.
Пример использования:
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
Проверка обратных ссылок
Проверка ТИЦ и PR
Регулярная проверка сайта
Рейтинг хостингов
Рейтинг фотохостингов
API Реклама на сайте
Партнёрская программа
Наши логотипы
Поддержка
Частые вопросы
Форум
Условия использования.
© Ping-Admin.Ru 2009–2017.
Концепция, программирование и дизайн проекта — «Седжин».
Ping-Admin.Ru — проверка работоспособности сайта.