4.2. API трансляции событий

Представляет собой механизм, дополняющий основные команды по манипулированию данными, и предоставляющий информирование об изменении/добавлении данных на стороне 1С-Коннект, внешнему пользователю API. Принцип подключения и работы с механизмом трансляции событий:

1. Событие - данные в теле POST-запроса в формате JSON.

2. Т.к. трансляция событий должна производиться по защищенному каналу, для этого:

   1. У пользователя API должен быть доступный в Интернет хост по DNS с сертификатом SSL/TLS, который должен будет выступать в роли HTTP-сервера для нашего сервера трансляции событий

   2. Пользователь API должен зарегистрировать свой хост по доменному имени командой 4.2.1.1. Подписаться на события, авторизовавшись под учеткой пользователя API по BASIC-авторизации, указав type=line.
      Так же можно указать конкретную линию поддержки в параметре id, в случае отсутствия id подписка будет осуществлена на все свои линии поддержки.

3. С момента успешной регистрации “хука“, сервер трансляции событий API 1С-Коннект - начинает транслировать изменения объектов в облаке 1С-Коннект, по всем линиям, на который осуществлена подписка в виде сообщений 4.2.2. Структура событий .

4. Запросы будут поступать с любого адреса сети 185.99.140.96/27 (185.99.140.97 - 185.99.140.126).

5. Сервер, принимающий запрос, должен отвечать кодами 200 или 201.
   В случае множества таймаутов или ответов 4XX/5XX хук деактивируется.

6. Пользователь API самостоятельно реализует логику обработки поступающих событий, руководствуясь ID объектов, своевременно полученных в т.ч. запросами данных основными командами API 4.1. API сервера 1С-Коннект. Или использую дополнительное упрощенное API для получения информации.