DocuSign 创建一个长期存在的嵌入式签名 URL？

嵌入式签名 url API 方法返回的 URL信封视图：createRecipient https://developers.docusign.com/docs/esign-rest-api/reference/Envelopes/EnvelopeViews/createRecipient/仅持续5分钟。

如何获得持续时间更长的嵌入式签名 URL？

嵌入的签名 URL 的生存时间仅为 5 分钟。

所以答案是给你的签名者一个定制的网址你的申请。然后，当您的签名者单击它时，您的应用程序首先从 DocuSign 获取嵌入的签名 URL，然后通过重定向到该 URL 来响应签名者。

创建自定义 URL

在您的应用程序中创建一个包含列的数据库表：

1. ID
2. url_lookup_guid
3. 帐户ID
4. 信封_id
5. 签名者电子邮件
6. 签名者姓名
7. Signer_client用户Id
8. 信封到期日期（可选，见下文）

当您想要为嵌入式签名者创建唯一的 URL 时：

1. 生成一个指南。它将用作 url_lookup_guid 值
2. 在数据库表中创建一条记录。
3. url 类似于 myapp.mycompany.com/sign/[url_lookup_guid value]

创建嵌入式签名仪式

1. 用户打开（GET 调用）您提供给他们的 URL。例如 myapp.mycompany.com/sign/1234567-1234-1234-123456789
2. 从URL中提取有效的guid
3. 查找数据库中的记录
4. 使用记录中的其他值来调用信封视图：createRecipient https://developers.docusign.com/docs/esign-rest-api/reference/Envelopes/EnvelopeViews/createRecipient/
5. 接收对 API 调用的嵌入式签名 URL 响应
6. 将签名者重定向到 URL
7. 删除数据库记录或将其标记为已使用。

清除旧数据库条目

1. 如上所述，您可以在使用数据库行后将其删除。

2. 为了清除从未使用过的条目，批处理可以每天检查数据库以查找信封已过期的过时条目。

   记录到期日期，或自动创建插入日期 在数据库中。然后，一旦超过您帐户的默认过期时间，请对 DocuSign 进行 API 调用以检查信封是否确实已过期。 （其有效期可能已延长。）

Notes

• 您创建的 URL 可以持续多久，或者直到 DocuSign 内的信封过期为止（以较早者为准）。
• 该 URL 将使该人能够签署信封，因此您可能希望包含来自 DocuSign 的额外签名者身份验证，以确保签名者是他们所说的人。
• 不要使用数据库的 ID 作为查找键，因为您要确保其他人无法猜测记录的 ID。使用随机引导作为查找键。
• 您的应用程序将需要访问令牌才能对 DocuSign 进行 API 调用。由于这是一项自主任务，因此请使用 OAuth JWT 授权流程。
• 不要在每次调用时创建新的访问令牌，而是缓存当前的访问令牌。
• 由于创建重定向 URL 可能需要几秒钟的时间（如果您还需要获取新的访问令牌，则需要更多时间），因此您可能需要首先返回一个中间页面，其中显示“请等待”消息并进行 Ajax 调用到您的应用程序以获取重定向的 URL。