Webhook —новый сервис в iSpring DailyPort. Теперь можно получать уведомления о событиях в формате POST запроса по HTTP. Больше не нужно отправлять запросы в API, достаточно отследить изменения. Для этого нужно подписаться на интересующие события и иметь сервис, который будет обрабатывать уведомления.
...
- Пользователь регистрирует подписчика. Он указывает URL, на который будут приходить сообщения. Для одного аккаунта может быть несколько подписчиков.
Используйте запрос: POST /webhook/register - Пользователь подтверждает URL с помощью кода подтверждения. После получения кода на указанный URL пользователь подтверждает URL.
Используйте запросы: POST /webhook/code/send иPOST /webhook/confirm
С этого момента интеграция считается активной. - Подписчик создается активным и может сразу получать сообщения. Подписчика можно выключить и включить обратно.
Используйте запросы: POST /webhook/disable иPOST /webhook/enable - Подписчика можно удалить навсегда.
Используйте запрос: POST /webhook/remove - Настройки подписчика можно изменить. Если меняется URL, его нужно снова подтверждать с помощью кода.
Используйте запрос: POST /webhook/settings/change - Пользователь может подписать подписчика на предложенные события iSpring LearnPort. В рамках одного аккаунта разные подписчики могут быть подписаны на разные события. Один подписчик может быть подписан только на событие одного типа.
Используйте запрос: POST /webhook/subscribe - Пользователь может отписать подписчика от подписки.
Используйте запрос: POST /webhook/unsubscribe - Пользователь может получить список подписок подписчика и информацию о подписчике.
Используйте запросы: GET /webhook/subscription/list иGET /webhook/subscriber/info
...
Информация |
---|
Отправлять запросы могут пользователи Learn Port с ролями Владелец и Администратор аккаунта. |
...