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

Question

嵌入式签名urlAPI方法EnvelopeViews:createRecipient返回的URL只持续5分钟。

我怎样才能获得持续时间更长的嵌入式签名 URL？

Answer 1

内嵌签名URL生存时间只有5分钟

所以答案是为您的签名者提供自定义的 url 您的应用程序。然后，当您的签名者单击它时，您的应用程序首先从 DocuSign 获取嵌入式签名 URL，然后通过重定向到 URL.

响应签名者

创建自定义 URL

在您的应用程序中创建一个数据库 table，其中包含以下列：

1. ID
2. url_lookup_guid
3. account_id
4. envelope_id
5. signer_email
6. signer_name
7. signer_clientUserId
8. envelope_expiration_date（可选，见下文）

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

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

创建嵌入式签约仪式

1. 用户打开（GET 调用）您给他们的 url。例如myapp.mycompany.com/sign/1234567-1234-1234-123456789
2. 从URL
中取出有效的guid
3. 在你的数据库中查找记录
4. 使用记录中的其他值调用EnvelopeViews:createRecipient
5. 接收嵌入式签名 URL 对 API 调用的响应
6. 将签名者重定向到 URL
7. 删除数据库记录或将其标记为已使用。

清除旧的数据库条目

1. 如上所述，您可以删除数据库中的行。

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

   要么记录到期日期，要么auto-create插入日期 在数据库中。然后，一旦超过您帐户的默认过期时间，请 API 调用 DocuSign 以检查信封是否确实已过期。 （其到期日期可能已延长。）

备注

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