docusign REST API Пример встроенной подписи для нескольких подписывающих сторон

У меня есть веб-приложение, в которое я добавляю встроенную подписку DocuSign, которое используется как на рабочем столе, так и на мобильном устройстве. Мне сказали, что решение SOAP API iFrame ненадежно (как я тоже испытал). Я пытаюсь реализовать с помощью REST API. Вот мой статус:

  1. Я успешно выполнил образец REST API для встроенной подписи из пошагового руководства по API.
  2. Я успешно адаптировал конверт для включения двух разных подписывающих лиц, а затем успешно завершил процесс подписания для подписавшего1.
  3. Как мне получить второй сеанс подписи подписывающего лица в окне браузера?

Есть ли образец (или секретный соус) для запуска встроенного сеанса подписи для signer2?

МНОГО МНОГО спасибо заранее.


person Ward Townsend    schedule 03.08.2013    source источник


Ответы (1)


Чтобы сгенерировать токен URL для второго получателя, вы следуете тому же процессу, который вы использовали для первого получателя. Вы делаете тот же HTTP-запрос POST, но просто ссылаетесь на адрес электронной почты, имя пользователя и clientUserId вашего второго получателя.

Например, когда вы генерировали URL-адрес для своего первого получателя, у вас, вероятно, было тело запроса, подобное этому:

{
    "returnUrl": "http://www.docusign.com/devcenter",
    "authenticationMethod": "None",
    "email": "[email protected]",
    "userName": "Name 1",
    "clientUserId": "1001"
}

Система DocuSign использует комбинацию их электронной почты, userName и clientUserId для уникальной идентификации этого встроенного получателя (также известного как закрепленный получатель). Поэтому, когда вы добавляете второго получателя в конверт, вы должны указать им собственное значение clientUserId, которое отличается от первого получателя. Затем система сможет идентифицировать их и сгенерировать токен URL для этого второго получателя.

Например, если вы добавили в конверт второго получателя со следующей информацией:

{
    "email": "[email protected]",
    "name": "Second Recipient",
    "roleName": "Signer1",
    "clientUserId": "1002"
}

Затем вы захотите сделать http://www.docusign.com/p/RESTAPIGuide/Content/REST%20API%20References/Post%20Recipient%20View.htm для первого получателя, но со следующей информацией:

{
    "returnUrl": "http://www.docusign.com/devcenter",
    "authenticationMethod": "None",
    "email": "[email protected]",
    "userName": "Second Recipient",
    "clientUserId": "1002"
}
person Ergin    schedule 03.08.2013
comment
Спасибо за ответ. Итак, как мне получить возможность сделать второй запрос? Когда я завершаю процесс подписи для ClientID 1001, он переходит на сайт Docusign.com/devcenter, и у меня никогда не будет возможности сделать второй запрос POST, который вы предлагаете :) Нужно ли мне настраивать его, чтобы он возвращался на страницу моего собственного сайта, а затем перезапускал ПОЧТА оттуда? еще раз большое спасибо :) - person Ward Townsend; 03.08.2013
comment
Да, с помощью встраивания вы управляете потоком, поэтому вы можете установить URL-адрес возврата на свой портал / веб-сайт, а затем выполнить второй вызов POST оттуда. Когда происходит перенаправление, должен быть параметр URL, указывающий, было ли подписание завершено, отклонено и т. Д., И если вы хотите, вы можете автоматически проанализировать эту строку и немедленно выполнить вызов POST. Или вы просто перенаправляете их обратно, и пользователь нажимает кнопку или что-то еще, чтобы запустить второй вызов POST, в соответствии с вашими потребностями ... - person Ergin; 03.08.2013
comment
Спасибо. Я обнаружил, что после завершения первой подписывающей стороны перенаправление возвращается на мою страницу правильно, и есть параметр URL-адреса с состоянием, круто ... однако информации о сеансе больше нет, я предполагаю, поскольку вызов моего страница поступает из-за пределов моего процесса. Как вы рекомендуете поддерживать эту информацию, чтобы я знал ViewURL / имена / адреса электронной почты для следующего POST подписавшего? (Было бы очень полезно, если бы был полный образец того, как работает встроенная подпись с несколькими подписчиками) - person Ward Townsend; 05.08.2013
comment
Вы должны поддерживать эти данные на своей стороне. Вы знаете всю информацию о получателе, когда они добавляются в конверт, верно? Как только вы узнаете эти данные, вы можете сохранить их в своей локальной программе или данных своего веб-сайта, а затем получить их, когда придет время сделать второй вызов POST. - person Ergin; 05.08.2013