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

我一直在为嵌入式签名开发docusignapi，它工作得很好，耶。我们有一个版本的活动，我们通过电子邮件向第二个签名者发送第二个docusign链接，这非常有效。。。。。发送后5分钟内。我找不到可与API调用一起发送的参数，无法将其有效时间长度设置为业务所需的72小时。我可以在API调用中更改的参数是什么，或者更好的方法是为帐户设置一个适当的配置

如前所述，对于嵌入式签名，URL令牌仅在5分钟内有效

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

您可以在api调用中设置属性，以设置evelope的TTL

A的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]"
        }
    ]
}

---

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

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

或者URL可以是数据库中的引用id。数据库记录将保存有关信封和签名人的所有相关信息

当签名者使用URL时，将调用您的应用程序。然后，你的应用程序将查找并检查信息。如果一切正常，您的应用程序将从DocuSign请求嵌入的签名URL，然后将签名者重新定向到该URL。然后签字人签字

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

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

---

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

在多签名者场景中，我们希望向主签名者提供一个行为与正常情况相同的嵌入iframe，并记录我们向其发送电子邮件的共同签名者的链接。好的，在这种情况下，您需要将主签名者指定为嵌入式签名者，将联合签名者指定为远程签名者。我相应地更新了我的答案