API-метод set устанавливает URL-адреса, на которые edna Pulse будет отправлять callback-запросы.
Работа с публичным API доступна всем зарегистрированным пользователям edna Pulse. Настроить доступ и получить API-ключ можно в личном кабинете edna Pulse.
Метод set принимает только POST запросы. Параметры передаются в теле запроса в виде JSON-объекта. Для авторизации используется API-ключ. После регистрации в edna Pulse вы можете сгенерировать или скопировать имеющийся ключ самостоятельно. Для получения дополнительных сведений см. Настройки API.
Вы можете включить авторизацию callback-запросов, которые edna Pulse передает на ваш сервер. Для получения дополнительных сведений см. Настройки API.
Метод set
В результате выполнения запроса будет установлено значение адреса колбека. В случае успешного выполнения запроса вернется ответ от сервера с кодом 200. В случае неуспешного выполнения запроса возвращается сообщение с кодом ошибки.
URL-адрес подключения
В теле запроса передается JSON-объект с параметрами.
{
"statusCallbackUrl": "https://messagesxxx.com/status/webhook",
"inMessageCallbackUrl": "https://messagesxxx.com/messages/webhook",
"subjectId": 234
}
Таблица параметров
| Параметр | Тип данных | Описание |
| statusCallbackUrl | string (optional) | URL колбека для получения статусов доставки сообщений. Максимум 500 символов. ВАЖНО! Адрес должен существовать и быть доступным для запроса из публичного интернета. Для проверки доступности мы пошлем HEAD запрос, на который ожидаем увидеть ответ со статусом 200. В противном случае мы не сможем зарегистрировать ваш URL. |
| inMessageCallbackUrl | string (optional) | URL колбека для получения входящих сообщений. Максимум 500 символов. ВАЖНО! Адрес должен существовать и быть доступным для запроса из публичного интернета. Для проверки доступности мы пошлем HEAD запрос, на который ожидаем увидеть ответ со статусом 200. В противном случае мы не сможем зарегистрировать ваш URL. |
| messageMatcherCallbackUrl | string (optional) | URL колбека для получения событий по управлению (например, регистрации шаблона). ВАЖНО! Адрес должен существовать и быть доступным для запроса из публичного интернета. Для проверки доступности мы пошлем HEAD запрос, на который ожидаем увидеть ответ со статусом 200. В противном случае мы не сможем зарегистрировать ваш URL. |
| subjectId | integer (optional) | Идентификатор канала. Его можно узнать через метод получения списка каналов. |
Формат ответа
В ответ на запрос возвращается JSON-объект, содержащий код выполнения запроса.
| Параметр | Тип данных | Описание |
| code | string | Код ответа на запрос |
Коды ответов на запрос
ok – запрос успешно выполнен
error-callback-url-max-length – URL содержит более 500 символов
error-callback-url-not-https – URL не использует https
error-callback-url-not-available – запрос HEAD по URL завершился с ошибкой
error-subject-unknown – не найден канал с указанным идентификатором
url-not-specified – необходимо указать StatusCallbackUrl или inMessageCallbackUrl