DocuSign创建一个长期存在的嵌入式签名URL? [英] DocuSign create a long lived embedded signing url?

问题描述

由嵌入式签名URL API方法返回的URL

The URL returned by the embedded signing url API method EnvelopeViews:createRecipient only lasts 5 minutes.

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

How can I get an embedded signing URL that will last longer?

推荐答案

嵌入的签名URL生存时间只有5分钟.

The embedded signing URL time to live is only 5 minutes.

因此，答案是为签名者提供自定义的您的应用程序网址.然后，当您的签名者单击它时，您的应用程序首先从DocuSign获得一个嵌入式签名URL，然后使用重定向到URL的方式对签名者做出响应.

So the answer is to give your signers a customized url to your application. Then, when your signer clicks it, your application first obtains an embedded signing URL from DocuSign and then responds to the signer with a redirect to the URL.

在应用程序中使用列创建数据库表:

Create a database table in your application with columns:

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时:

When you want to create a unique URL for an embedded signer:

1. 生成一个Guid.它将用作url_lookup_guid值
2. 在数据库表中创建一条记录.
3. 该网址将类似于myapp.mycompany.com/sign/[url_lookup_guid值]

创建嵌入式签名仪式

1. 用户打开(GET调用)您给他们的网址.例如myapp.mycompany.com/sign/1234567-1234-1234-123456789
2. 从网址中提取有效的Guid
3. 在数据库中查找记录
4. 使用记录中的其他值调用

   清除旧数据库条目

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

   1. As noted above, you can delete database rows once they're used.

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

   To clear out entries that were never used, a batch process can check the database each day for obsolete entries where the envelope has expired.

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

   Either record the expiration date, or auto-create an insertion date in the database. Then, once your account's default expiration time has been exceeded, make an API call to DocuSign to check that the envelope has indeed expired. (Its expiration date may have been extended.)

   注释

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

   这篇关于DocuSign创建一个长期存在的嵌入式签名URL?的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！