python - 如何获取信封链接

Question

在我的应用程序中，用户注册后，它会创建一个文档签名文档并通过信封发送到用户的电子邮件以供签名。

我的问题是如何提供我的申请中该文档的链接？我希望它与用户在电子邮件中访问的链接相同。我尝试根据从 create_envelope 的结果中获得的envelope_id 构造url，但这似乎是错误的。实际上有办法做到这一点吗？或者必须从用户的电子邮件访问它？

信封 uri:envelopes/ids

Answer 1

您可能正在寻找的流程称为 Embedded Signing 。通过嵌入式签名，您可以重定向用户签署 DocuSign 信封，而不是让他们通过电子邮件签名。

两步过程:

首先，您将创建信封。请务必包含每个收件人对象的 clientUserId。当您想要在下一步中生成唯一的签名 URL 时，将使用此选项。

POST /accounts/{accountId}/envelopes
{
    "status": "sent",
    "emailSubject": "Envelope with Embedded Signer",
    "documents": [{
        "documentId": "1",
        "name": "contract.pdf",
        "documentBase64": "base64 document bytes...",
    }],
    "recipients": {
        "signers": [{
            "email": "<a href="https://stackoverflow.com/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="e18b8e898fa1848c80888dcf828e8c" rel="noreferrer noopener nofollow">[email protected]</a>",
            "name": "John Doe",
            "recipientId": "1",
            "clientUserId": "1234"
        }]
    }
}

其次，您将为给定用户生成 RecipientViewURL。

POST /accounts/{accountId}/envelopes/{envelopeId}/views/recipient
{
    "userName": "John Doe",
    "email": "<a href="https://stackoverflow.com/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="c3a9acabada7aca683a6aea2aaafeda0acae" rel="noreferrer noopener nofollow">[email protected]</a>",
    "recipientId": "1",
    "clientUserId": "1234",
    "authenticationMethod": "email",
    "returnUrl": "https://www.docusign.com/devcenter"
}

Here is a guide这提供了有关该功能的更全面的背景。