Схема работы оповещений

  1. При изменении данных приложение 1С отправляет оповещение во внешний сервис 
  2. Внешний сервис выгружает изменения
  3. внешний сервис подтверждает получение и успешную обработку изменений

Описание процесса работы с оповещениями

Возможны различные варианты авторизации и отправки оповещений во внешнюю систему, например:

  1. Отправка данных на анонимный сервис
  2. Подключение с помощью логина и пароля
  3. Подключение с помощью логина, пароля и клиентского сертификата.
  4. Отправляемые данные могут быть подписаны секретным словом с помощью алгоритма HMACSHA256. Секретное слово передается в настройки учетной системы.
  5. Различные комбинации вышеописанных вариантов.

Возможность отправки уведомлений, а также способ отправки определяется в настройках учетной системы.

Формат оповещения

Оповещение отправляется в виде 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.

После получения уведомления, предполагается, что внешняя система выгрузит файл из хранилища, обработает его и отправит в приложение запрос на подтверждение получения данных