DocuSign API - 如何共享信封 URL post 调用 CreateEnvelope API?

DocuSign API - How to share the envelope URL post calling the CreateEnvelope API?

对于一个用例,我们希望将 document/envelope url 共享给用户,作为对他们对我们端点进行的 API 调用的响应的一部分。在探索了 ESign API 功能之后,我没有找到任何方法从可以共享的 DocuSign ESign API 中提取信封 url,因此探索了 powerforms,但在这样做时我能够传递文本选项卡值以将 powerform 更新为查询字符串参数,这不够安全。关于我应该采取哪种方法来获取信封 url 并能够与最终用户共享它的任何建议?

您可以正常创建信封,这将为您提供提供制表符值的选项,然后在创建信封并获得 envelopeId 后,您将能够使用EnvelopeViews:createRecipient 端点以创建 URL 使您能够在应用程序中嵌入 DocuSign UI 的收件人视图。如果收件人是签名者,则视图将提供签名仪式。

无法生成可使用 DocuSign API 通过电子邮件共享的长期签名 URL。要解决这个问题,解决方案需要分解成两步。

首先,使用嵌入式签名仪式并将 clientUserID 值设置为唯一值,然后使用 CreateEnvelope API 获取信封 ID。将此信封 ID 映射到一个 GUID,并将此信封 ID 存储在数据库中,并根据该 GUID 发送附加到 Web 应用程序的 GUID URL,如 https://mywebapp.com?id=guide。我们想要共享 GUID 的原因是为了降低信封 ID 被欺骗的风险。 现在,这个 URL 可以在电子邮件中共享。

如果您的旅程是基于 API 的旅程,就像我的情况一样,那么您需要创建一个精益网络应用程序 - mywebapp.com 以便 URL 可以通过以下方式创建将 GUID 附加到它,这将在第二步中启用浏览器重定向,如下所述。

单击 URL 后,这就是解决方案的第二步出现的地方。在第二步中,使用 URL 中提供的 GUID 从数据库中检索信封 ID,并使用 E-signature API 创建收件人视图。这将为用户创建一个 in-session 视图,以便通过将文档重定向到 DocuSign 门户来签署文档。