API - уникальный идентификатор для обновления статуса?

Question

Я расследую использование API DocuSign для отправки и получения конвертов и подписанных документов.

Предоставляет ли DocuSign «идентификатор события» или что-то уникальное для каждого обновления статуса конверта?Я хочу знать, обрабатывали ли мы это событие уже или нет.

Мой вопрос . Можно ли как-то легко определить, что изменилось в обновлении статуса, которое мы получаем от DocuSign?

Или подходящий способ перевода вызовов WebAPI в объекты и методы SDK?

Answer 1

Существует хитрость, позволяющая узнать, что изменилось в конверте, без разбора полного XML. Если у вас есть Rest Listener как https://www.acme.com/connect, тогда вы можете добавить другой параметр запроса к вашему URL-адресу подключения, и ваш URL-адрес должен выглядеть как

• https://www.acme.com/connect?event=envelopeDecline
• https://www.acme.com/connect?event=envelopeComplete и т. Д.

Затем создайте несколько настроек Connect для вашей учетной записи DS, сопоставив правильные события триггера с правильным URL-адресом получателя отдыха.

Как и https://www.acme.com/connect?event=envelopeComplete должен быть настроен только с подписанным конвертом / Завершенным событием уровня конверта.

одновременно https://www.acme.com/connect?event=envelopeDecline должен быть настроен только с Envelope Declined envelope = триггер уровня.

Поступая таким образом, ваш слушатель должен сначала просто прочитать параметры запроса, которые сообщат вам, какой тип XML или состояние конверта отправлено в XML, а затем направить ваш код на правильный метод обработки для дальнейшего анализа XML. Следуя этому приему, вы узнаете, что изменилось в конверте, и ваш корректный бизнес-метод может быть вызван раньше на основе значения параметра запроса.

Answer 2

Обновление статуса будет включать в себя уникальный EnvelopeID (который является GUID), а также статус конверта, который является одним из фиксированного числа значений, таких как «отправлено», «аннулировано», «выполнено» и т. Д.