Поделиться через


Signhost (предварительная версия)

Signhost служба подписывания рабочего процесса с помощью Entrust — это решение цифровой подписи и идентификации, предоставляющее возможность всем типам предприятий с простыми и безопасными онлайн-транзакциями.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Команда успешности клиентов Signhost
URL https://intercom.help/signhost/en/
Адрес электронной почты support@signhost.com
Метаданные соединителя
Publisher Signhost
Веб-сайт https://www.signhost.com
Политика конфиденциальности https://www.evidos.com/privacy
Категории Содержимое и файлы; Продуктивность

SignHost

Signhost служба подписывания рабочего процесса с помощью Entrust — это решение цифровой подписи и идентификации, предоставляющее возможность всем типам предприятий с простыми и безопасными онлайн-транзакциями.

Publisher

Доверить Нидерланды B.V.

Предпосылки

Для использования этого соединителя потребуется подписка SignHost. Вы можете создать APIKey на портале Signhost

Поддерживаемые операции

Получение сведений о транзакции

Возвращает текущие сведения о транзакции. Не используйте это действие для активного опроса.

Удаление транзакции

Удаление транзакции идентификатором транзакции. Если транзакция не находится в конечном состоянии (например, полностью подписана), транзакция будет отменена и очищена. Отмененная транзакция может быть сказано отправить уведомление электронной почты ожидающим подписателям о том, что транзакция была отменена. Состояние транзакции будет отменено. Когда транзакция находится в конечном состоянии, транзакция будет очищаться. Состояние транзакции останется неизменным, но мы очистим все отправленные документы и конфиденциальные данные как можно скорее.

Скачать PDF

Возвращает (подписанные) документы.

Скачивание квитанции

Возвращает квитанцию, когда транзакция успешно подписана.

Создание транзакции

Создает новую транзакцию.

Добавление файла

Добавьте файл в транзакцию.

Запуск транзакции

Запускает транзакцию с тем же {transactionId}.

Получение учетных данных

Пользователь можно создать на странице параметров на портале SignHost. Обязательно используйте префикс APIKey перед пользователем.

Известные проблемы и ограничения

В настоящее время не все функции поддерживаются. Мы приветствуем вас, чтобы обратиться к нам с любыми запросами или запросами.

Инструкции по развертыванию

Следуйте инструкциям в статье "Создание настраиваемого соединителя из определения OpenAPI".

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Authorization securestring Укажите APIKey. True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Добавление файла

Добавьте файл в транзакцию или перезаписать существующий файл с тем же {fileId}.

Запуск транзакции

Запускает транзакцию с тем же {transactionId}

Получение сведений о транзакции

Возвращает текущие сведения о транзакции

Скачивание pdf

Возвращает (подписанные) документы.

Скачивание квитанции

Возвращает квитанцию, когда транзакция успешно подписана (Status=30)

Создание транзакции

Создает новую транзакцию

Удаление транзакции

Удаление транзакции идентификатором транзакции

Добавление файла

Добавьте файл в транзакцию или перезаписать существующий файл с тем же {fileId}.

Параметры

Имя Ключ Обязательно Тип Описание
ИД транзакции
transactionId True string

Идентификатор существующего -- еще не запущена - транзакция

Идентификатор файла
fileId True string

Уникальный идентификатор, предоставленный вами для файла.

Двоичный файл
body True binary

Отправка файла

Запуск транзакции

Запускает транзакцию с тем же {transactionId}

Параметры

Имя Ключ Обязательно Тип Описание
ИД транзакции
transactionId True string

Идентификатор существующего -- еще не запущена - транзакция

Получение сведений о транзакции

Возвращает текущие сведения о транзакции

Параметры

Имя Ключ Обязательно Тип Описание
ИД транзакции
transactionId True string

Идентификатор транзакции

Возвращаемое значение

Тело
Transaction

Скачивание pdf

Возвращает (подписанные) документы.

Параметры

Имя Ключ Обязательно Тип Описание
ИД транзакции
transactionId True string

Идентификатор описания

Имя
fileId True string

Уникальный идентификатор, предоставленный вами для файла.

Возвращаемое значение

Content
binary

Скачивание квитанции

Возвращает квитанцию, когда транзакция успешно подписана (Status=30)

Параметры

Имя Ключ Обязательно Тип Описание
ИД транзакции
transactionId True string

Идентификатор описания

Возвращаемое значение

Content
binary

Создание транзакции

Создает новую транзакцию

Параметры

Имя Ключ Обязательно Тип Описание
Files
Files object

Карта файлов, присоединенных к этой транзакции.

Language
Language string

Разрешены только de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL и nl-NL.

Тюлень
Seal boolean

Запечатайте документ перед отправкой подписывателям.

Идентификатор
Id string

Идентификатор подписыватель должен быть уникальным в рамках транзакции.

Адрес электронной почты
Email True string

Адрес электронной почты подписыватель

IntroText
IntroText string

Вводный текст для отображения пользователю во время процесса подписи.

Тип
Type True string

Тип объекта проверки подлинности.

Number
Number string

Номер телефона: это поле является обязательным при выборе метода проверки подлинности PhoneNumber

Bsn
Bsn number

Это поле является обязательным при выборе BSN метода проверки подлинности

Тип
Type True string

Тип объекта проверки.

SendSignRequest
SendSignRequest boolean

Отправьте приглашение на подписыватель его адрес электронной почты.

SignUrl
SignUrl string

Уникальный URL-адрес для подписи, предоставляющий поток подписи для подписи.

SignRequestSubject
SignRequestSubject string

Тема сообщения электронной почты запроса на вход в виде обычного текста.

SignRequestMessage
SignRequestMessage string

Сообщение запроса на вход в виде обычного текста.

SendSignConfirmation
SendSignConfirmation boolean

Отправьте подтверждение подписи своему адресу электронной почты.

Language
Language string

Разрешены только de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL и nl-NL.

ScribbleName
ScribbleName string

Имя подписывающего элемента будет предварительно заполнено в форме скручиваемого текста.

DaysToRemind
DaysToRemind integer

Количество дней, прежде чем напоминать подписчиков. -1, чтобы отключить напоминания.

Действительно до
Expires date-time

Если установить подписыватель больше не разрешено подписывать транзакцию после этой даты.

Reference
Reference string

Ссылка на подписыватель.

ОтклонитьReason
RejectReason string

Причина отклонения, которая была предоставлена подписывшему, когда транзакция была отклонена.

ReturnUrl
ReturnUrl string

URL-адрес перенаправления пользователя после подписывания, отклонения или отмены.

Контекст
Context object

Любой допустимый объект JSON, который мы вернемся обратно.

Идентификатор
Id string
Code
Code integer

Документация по API для консультаций

Info
Info string

Может содержать дополнительные сведения, относящиеся к этому действию

Дата и время создания
CreatedDateTime date-time
Имя
Name True string

Имя получателя.

Адрес электронной почты
Email True string

Адрес электронной почты получателя.

Language
Language string

Язык, только de-DE, en-US, es-ES, fr-FR, it-IT и разрешены nl-NL.

Тема
Subject string

Тема сообщения электронной почты получателя в виде обычного текста.

Message
Message True string

Сообщение электронной почты к получателю в виде обычного текста.

Reference
Reference string

Ссылка получателя.

Контекст
Context object

Любой допустимый объект JSON, который мы вернемся обратно.

Reference
Reference string

Ссылка на транзакцию.

PostbackUrl
PostbackUrl string

Абсолютный URL-адрес для обратной передачи обновлений состояния.

SignRequestMode
SignRequestMode integer

Установите значение 1 для одновременной отправки до 2 для последовательной передачи.

DaysToExpire
DaysToExpire integer

Количество дней до истечения срока действия. Максимум 90 дней.

Возвращаемое значение

Тело
Transaction

Удаление транзакции

Удаление транзакции идентификатором транзакции

Параметры

Имя Ключ Обязательно Тип Описание
ИД транзакции
transactionId True string

Идентификатор транзакции

SendNotifications
SendNotifications boolean

Отправьте уведомления по электронной почте ожидающим подписателям.

Причина
Reason string

Причина отмены.

Определения

Транзакция

Имя Путь Тип Описание
Идентификатор
Id string

Идентификатор транзакции.

Files
Files array of object
Links
Files.Links array of object
Rel
Files.Links.Rel string
Тип
Files.Links.Type string
Link
Files.Links.Link string
Отображаемое имя
Files.DisplayName string
Language
Language string

Язык, только de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL и nl-NL разрешены.

Тюлень
Seal boolean

Запечатайте документ перед отправкой подписывателям.

Подписыватели
Signers array of object

Сведения о подписывшем объекте.

Идентификатор
Signers.Id string

Идентификатор подписыватель должен быть уникальным в рамках транзакции.

Адрес электронной почты
Signers.Email string

Адрес электронной почты подписыватель

IntroText
Signers.IntroText string

Вводный текст для отображения пользователю во время процесса подписи.

Проверки подлинности
Signers.Authentications array of Authentication

Список аутентификаций, с помощью которым подписыватель должен пройти проверку подлинности.

Проверки
Signers.Verifications array of Verification

Список проверок, с которыми должен проверить подписыватель.

SendSignRequest
Signers.SendSignRequest boolean

Отправьте приглашение на подписыватель его адрес электронной почты.

SignUrl
Signers.SignUrl string

Уникальный URL-адрес для подписи, предоставляющий поток подписи для подписи.

SignRequestSubject
Signers.SignRequestSubject string

Тема сообщения электронной почты запроса на вход в виде обычного текста.

SignRequestMessage
Signers.SignRequestMessage string

Сообщение запроса на вход в виде обычного текста.

SendSignConfirmation
Signers.SendSignConfirmation boolean

Отправьте подтверждение подписи своему адресу электронной почты.

Language
Signers.Language string

Разрешены только de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL и nl-NL.

ScribbleName
Signers.ScribbleName string

Имя подписывающего элемента будет предварительно заполнено в форме скручиваемого текста.

DaysToRemind
Signers.DaysToRemind integer

Количество дней, прежде чем напоминать подписчиков.

Действительно до
Signers.Expires date-time

Если установить подписыватель больше не разрешено подписывать транзакцию после этой даты.

Reference
Signers.Reference string

Ссылка на подписыватель.

ОтклонитьReason
Signers.RejectReason string

Причина отклонения, которая была предоставлена подписывшему, когда транзакция была отклонена.

ReturnUrl
Signers.ReturnUrl string

URL-адрес перенаправления пользователя после подписывания, отклонения или отмены.

Контекст
Signers.Context object

Любой допустимый объект JSON, который мы возвращаем.

Мероприятия
Signers.Activities array of object

Список действий, подключенных к этому подписывательу.

Идентификатор
Signers.Activities.Id string
Code
Signers.Activities.Code integer
  • 101 — приглашение отправлено
  • 102 — получено
  • 103 — открыто
  • 104 — отправлено напоминание
  • 105 — открытое документообразуемое свойство Info содержит идентификатор файла открытого документа.
  • 201 — отменено
  • 202 - Отклонено
  • 203 — подписанный
  • 301 — отправленный подписанный документ
  • 302 — открытый подписанный документ
  • 303 — скачанный подписанный документ
  • 401 — отправка квитанции
  • 402 — открытие квитанции
  • 403 — скачанный квитанции
Info
Signers.Activities.Info string

Может содержать дополнительные сведения, относящиеся к этому действию

Дата и время создания
Signers.Activities.CreatedDateTime date-time
Receivers
Receivers array of object
Имя
Receivers.Name string

Имя получателя.

Адрес электронной почты
Receivers.Email string

Адрес электронной почты получателя.

Language
Receivers.Language string

Язык приемника допускается только de-DE, en-US, es-ES, fr-FR, it-IT и nl-NL.

Тема
Receivers.Subject string

Тема сообщения электронной почты получателя в виде обычного текста.

Message
Receivers.Message string

Сообщение электронной почты к получателю в виде обычного текста.

Reference
Receivers.Reference string

Ссылка получателя.

Контекст
Receivers.Context object

Любой допустимый объект JSON, который мы вернемся обратно.

Reference
Reference string

Ссылка на транзакцию. Например, "1234"

PostbackUrl
PostbackUrl string

Абсолютный URL-адрес для обратной передачи обновлений состояния.

SignRequestMode
SignRequestMode integer

Установите значение 1 для одновременной отправки до 2 для последовательной передачи.

DaysToExpire
DaysToExpire integer

Количество дней до истечения срока действия. Максимум 90 дней.

SendEmailNotifications
SendEmailNotifications boolean

Отправка уведомлений по электронной почте отправителю.

Состояние
Status integer

Текущее состояние транзакции.

CancelationReason
CancelationReason string

Исходная причина отмены, указанная во время вызова DELETE.

Контекст
Context object

Любой допустимый объект JSON, который мы вернемся обратно.

Authentication

Имя Путь Тип Описание
Тип
Type string

Тип объекта проверки подлинности.

Number
Number string

Номер телефона: это поле является обязательным при выборе метода проверки подлинности PhoneNumber

Bsn
Bsn number

Это поле является обязательным при выборе BSN метода проверки подлинности

Проверка

Имя Путь Тип Описание
Тип
Type string

Тип объекта проверки.

бинарный

Это базовый тип данных binary.