Схема работы оповещений
- При изменении данных приложение 1С отправляет оповещение во внешний сервис
- Внешний сервис выгружает изменения
- внешний сервис подтверждает получение и успешную обработку изменений
Описание процесса работы с оповещениями
Возможны различные варианты авторизации и отправки оповещений во внешнюю систему, например:
- Отправка данных на анонимный сервис
- Подключение с помощью логина и пароля
- Подключение с помощью логина, пароля и клиентского сертификата.
- Отправляемые данные могут быть подписаны секретным словом с помощью алгоритма HMACSHA256. Секретное слово передается в настройки учетной системы.
- Различные комбинации вышеописанных вариантов.
Возможность отправки уведомлений, а также способ отправки определяется в настройках учетной системы.
Формат оповещения
Оповещение отправляется в виде JSON со следующими полями:
Поле | Описание |
|---|---|
| url | Адрес (URL) для скачивания файла данных |
| tenant | Номер приложения (области) |
| storage | Идентификатор хранилища |
| id | Идентификатор файла |
| file | Идентификатор данных (имя файла) |
| version | Версия данных |
| handler | Обработчик |
В случае, если данные должны быть подписаны, добавляются поля:
Поле | Описание |
|---|---|
| sign_order | Порядок подписания полей |
| sign | Подпись, полученная функцией HMACSHA256 |
Пример отправляемого оповещения
{
"url": "https://stage.1cfresh.com:443/a/smtl/1/hs/dt/storage/files/fea855ef-4a3c-4d5a-b912-8cdac78ac1a5",
"tenant": 1,
"storage": "files",
"id": "fea855ef-4a3c-4d5a-b912-8cdac78ac1a5",
"file": "54ff1341-d9c5-11e7-819b-0050568925e0.json",
"version": "2015273148",
"handler": "example-sync",
"sign_order": "url,tenant,storage,id,file,version,handler",
"sign": "upFB9UfezrPRDvBmA/WYRHqzzQ6u/SMxsenFVZkiYas="
}
В ответ система ожидает ответ 200 OK.
После получения уведомления, предполагается, что внешняя система выгрузит файл из хранилища, обработает его и отправит в приложение запрос на подтверждение получения данных