Question

我一直在使用docusign API进行嵌入式签名，它工作得很好，是的。我们有一个事件版本，我们通过电子邮件向第二个签名者发送第二个docusign链接，并且在发送它的5分钟内工作得很棒。我无法通过API调用找到要发送的参数，以将其有效的时间长度设置为业务所需的72小时。我可以在API调用中更改的参数是什么，或者更好的是帐户的配置是否适当地设置它？

Answer 1

正如其他答案所说，嵌入式签名TTL固定为5分钟。以下是处理场景的方法：

为您的签名者提供您的应用程序的URL。该URL需要包含足够的状态，以便您的应用程序在收到URL时可以确定签名者是谁，信封ID是多少， 72小时是否到期等等。

或者URL可以是数据库中的ref id。您的数据库记录将包含有关信封和签名者的所有相关信息。

当签名者使用该网址时，系统会调用您的应用。然后，您的应用将查找并查看信息。如果一切正常，您的应用会从DocuSign请求嵌入式签名URL，然后将签名者重定向到该URL。然后签字人签字。

请注意我上面提到的“检查”问题。至关重要的是，您要么意外地或故意地欺骗您的系统。例如，不要只使用数据库记录ID，因为有人可以尝试随机记录ID或逐个增加一个好的。相反，要求URL包含记录ID和记录中无法猜到的一些信息。

或者使用随机GUID作为URL的参数，然后在数据库中搜索它。

在任何情况下，关键是在将签名者重定向到它之前请求嵌入式签名URL。

Answer 2

对于嵌入式签名，如上所述[{3}}，网址令牌仅对 5分钟有效。

这一切都取决于你如何配置每个签名者：嵌入式和远程。执行此操作的主要切换是 ClientUserId 属性：正如here所述，非空ClientUserId意味着用户是嵌入式的。因此，要设置用于远程签名的共同签名者，您需要指定ClientUserId =“”。

Answer 3

您可以在notification api调用中设置 Envelope:Create 属性，以设置信封的TTL。

embedded signing的TTL为5分钟。

您只能为处于已发送状态的信封生成收件人签名链接。另请注意，签名链接在300秒（5分钟）后过期，仅供一次性使用，这意味着每次收件人想要访问信封时都需要生成新的签名令牌。

以下是一个示例请求，其中包含一个嵌入式远程收件人，信封过期时间设置为72小时。

{
    "status": "sent",
    "notification": {
        "expirations": {
            "expireAfter": 3, //Envelope Expires after 3 days (72 hours).
            "expireEnabled": true
        },
        "useAccountDefaults": false
    },
    "recipients": {
        "signers": [
            {
                "email": "signer@foo.com",
                "name": "signer one",
                "recipientId": 1,
                "clientUserId": 1234 //This is the embedded recipient. Does not receive an email.
            },
            {
                "email": "cosigner@foo.com",
                "name": "Co Signer",
                "recipientId": 2 //This is the remote recipeint. Receives an email.
            }
        ]
    },
    "emailSubject": "Envelope with an embedded recipient and remote recipient",
    "documents": [
        {
            "documentId": "1",
            "name": "Agreement",
            "fileExtension": "pdf",
            "documentBase64": "[Document base64 bytes go here]"
        }
    ]
}

如何在docusign信封URL上设置ttl？

3 个答案: