Краткие сведения
Описание
Метод устанавливает webhook для получения событий.
Запрос к серверу
Поле | Тип | Описание |
---|---|---|
type | String | Тип подписки:
|
url | String | URL WebHook. На этот адрес будут прилетать все события POST-запросами. |
id | UUID? | ID объекта, на который осуществляется подписка:
если type == line и не указан id, то подписка производится на все линии, к которым имеется доступ |
Проверить активны ли подписки можно методом 4.2.4.5. Получение доступных линий поддержки
Пример
Выставление адреса webhook для бота
POST /v1/hook/ HTTP/1.1 Host: push.1c-connect.com accept: application/json authorization: Basic dGVzdDp0ZXN0 Content-Type: application/json Content-Length: 111 { "id": "b7ae5029-b9a7-4e55-8179-37b05a5865ae", "type": "bot", "url": "https://push.example.com/connect/hook/"}
Curl
curl -X POST "https://push.1c-connect.com/v1/hook/" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -u test:test \ -d "{ \"id\": \"b7ae5029-b9a7-4e55-8179-37b05a5865ae\", \"type\": \"bot\", \"url\": \"https://push.example.com/connect/hook/\"}"
Ответ сервера
Нет тела
Ошибки
Код | Описание |
---|---|
400 | Запрос содержит ошибку |
401 | Пользователь не авторизован |
403 | Недостаточно прав |