Docusignapi DocuSign是否创建长期使用的嵌入式签名url?

Docusignapi DocuSign是否创建长期使用的嵌入式签名url?,docusignapi,Docusignapi,嵌入式签名URL API方法返回的URL仅持续5分钟 如何获得持续时间更长的嵌入式签名URL?嵌入式签名URL的生存时间只有5分钟 因此,答案是为您的签名者提供一个自定义的应用程序url。然后,当您的签名者单击它时,您的应用程序首先从DocuSign获得一个嵌入的签名URL,然后通过重定向到该URL来响应签名者 创建自定义URL 在应用程序中创建包含列的数据库表: 身份证 url\u查找\u guid 帐号 信封号 签名者(电邮) 签名人姓名 签名者\客户端用户ID 信封有效期(可选,见下文)

嵌入式签名URL API方法返回的URL仅持续5分钟


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

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

因此,答案是为您的签名者提供一个自定义的应用程序url。然后,当您的签名者单击它时,您的应用程序首先从DocuSign获得一个嵌入的签名URL,然后通过重定向到该URL来响应签名者

创建自定义URL 在应用程序中创建包含列的数据库表:

  • 身份证
  • url\u查找\u guid
  • 帐号
  • 信封号
  • 签名者(电邮)
  • 签名人姓名
  • 签名者\客户端用户ID
  • 信封有效期(可选,见下文)
  • 要为嵌入式签名者创建唯一URL时:

  • 生成guid。它将用作url\u查找\u guid值
  • 在数据库表中创建一条记录
  • url类似于myapp.mycompany.com/sign/[url\u lookup\u guid value]
  • 创建嵌入式签名仪式
  • 用户打开(获取呼叫)您提供给他们的url。例如myapp.mycompany.com/sign/1234567-1234-1234-123456789
  • 从URL中拉出有效的guid
  • 在数据库中查找记录
  • 使用记录中的其他值调用
  • 接收对API调用的嵌入式签名URL响应
  • 将签名者重定向到URL
  • 删除数据库记录或将其标记为已使用
  • 清除旧数据库条目
  • 如上所述,一旦使用了数据库行,就可以删除它们

  • 为了清除从未使用过的条目,批处理过程可以每天检查数据库中信封过期的过时条目

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

  • 笔记
    • 您创建的URL可以使用多长时间,也可以使用到DocuSign中的信封过期,以较早的为准
    • URL将使此人能够在信封上签名,因此您可能希望包含来自DocuSign的附加签名者身份验证,以确保签名者是他们所说的人
    • 不要使用数据库的ID作为查找键,因为您希望确保有人猜不到记录的ID。使用随机guid作为查找键
    • 您的应用程序将需要一个访问令牌来调用DocuSign的API。因为这是一个自治任务,所以使用OAuth JWT授权流
    • 不要每次调用都创建新的访问令牌,请缓存当前的访问令牌
    • 由于创建重定向URL可能需要几秒钟的时间(如果您还需要获取新的访问令牌,则需要更长的时间),因此您可能需要首先返回一个中间页面,其中显示一条“请待命”消息,并对您的应用程序进行Ajax调用以获取重定向的URL