docusign REST API 嵌入式签名多个签名者示例答案

【问题标题】：docusign REST API Embedded Signing Multiple Signers Exampledocusign REST API 嵌入式签名多个签名者示例
【发布时间】：2013-08-04 00:59:57
【问题描述】：

我有一个网络应用程序，我正在向其中添加 DocuSign 嵌入式签名，该应用程序既可用于桌面设备，也可用于移动设备。有人告诉我，SOAP API 的 iFrame 解决方案不可靠（我也经历过）。我正在尝试使用 REST API 来实现。这是我的状态：

我已成功执行 API 演练中用于嵌入式签名的 REST API 示例。
我已成功调整信封以包含两个不同的签名者，然后成功完成了 signer1 的签名过程。
如何在浏览器窗口中获得第二个签名者签名会话？

是否有关于如何让 signer2 启动嵌入式签名会话的示例（或秘诀）？

非常感谢。

【问题讨论】：

标签： api rest docusignapi

【解决方案1】：

要为第二个收件人生成 URL 令牌，请遵循与第一个收件人相同的过程。您发出相同的 http POST 请求，但只需引用第二个收件人的电子邮件、用户名和 clientUserId。

例如，当您为第一个收件人生成 URL 时，您可能有一个类似于以下内容的请求正文：

{
    "returnUrl": "http://www.docusign.com/devcenter",
    "authenticationMethod": "None",
    "email": "email1@gmail.com",
    "userName": "Name 1",
    "clientUserId": "1001"
}

DocuSign 系统使用他们的电子邮件、用户名和 clientUserId 的组合来唯一标识这个嵌入的收件人（也称为强制收件人）。因此，当您将第二个收件人添加到信封时，您应该给他们自己的 clientUserId 值，该值与第一个收件人不同。然后，系统将能够识别它们并为第二个收件人生成 URL 令牌。

例如，如果您在信封中添加了第二个收件人并提供以下信息：

{
    "email": "email2@gmail.com",
    "name": "Second Recipient",
    "roleName": "Signer1",
    "clientUserId": "1002"
}

然后，您需要为第一个收件人创建 same http POST call，但要使用以下信息：

{
    "returnUrl": "http://www.docusign.com/devcenter",
    "authenticationMethod": "None",
    "email": "email2@gmail.com",
    "userName": "Second Recipient",
    "clientUserId": "1002"
}

【讨论】：

感谢您的回复。那么我怎样才能有机会提出第二个请求呢？当我完成 ClientID 1001 的签名过程时，它会转到 Docusign.com/devcenter 站点，我再也没有机会发出您建议的第二个 POST 请求:) 我是否必须将其设置为返回到我自己的站点页面然后重新启动从那里的POST？再次，非常感谢:)
是的，您可以通过嵌入来控制流程，因此您可以将返回 url 设置为您的门户/网站，然后从那里进行第二次 POST 调用。当重定向发生时，应该有一个 URL 参数指示签名是否已完成、被拒绝等，如果您愿意，您可以自动解析该字符串并立即进行 POST 调用。或者您只是将它们重定向回来并让用户单击按钮或其他东西来启动第二个 POST 调用，这取决于您的需要......
谢谢。我发现在第一个签名者完成后，“重定向”正确地返回到我的页面，并且有一个带有状态的 URL 参数，很酷......但是没有会话信息了，我猜自从调用我的页面来自我的流程之外。您如何建议维护该信息，以便我知道下一个签名者 POST 的 ViewURL/名称/电子邮件？（如果有关于多签名者嵌入式签名如何工作的完整示例，那将非常有帮助）
您需要自己维护这些数据。在将收件人添加到信封时，您知道所有收件人信息吗？一旦您知道这些数据，您可以将其保存在本地程序或网站数据中，然后在进行第二次 POST 调用时检索它。