Question

我们正在使用docusign API通过电子邮件向签名者请求签名。我们分析了URL并发现它有两个查询参数（'a'和'er'）。有没有办法使用可以用来生成运行时URL的API来实际获取这两个参数？

Answer 1

是的，您可以生成用于通过DocuSign发送和签署文档的直接URL，但是您不会从您正在讨论的请求电子邮件中获取它 - 这是一个完全独立的过程。您想要的是DocuSign平台中的一项功能，称为嵌入。

使用嵌入，您可以生成经过身份验证的URL“令牌”，该令牌只能使用一次，并且必须在它们在5分钟后到期之前使用，并且您必须生成一个新令牌。但是，要为给定的收件人生成URL，您需要以稍微不同的方式将它们添加到信封中。您需要设置 clientUserId 属性及其电子邮件和名称，然后在为其请求签名URL时引用相同的clientUserId，电子邮件，名称组合。

例如，如果您是从模板创建信封并想使用嵌入生成签名网址，那么您可以使用以下请求正文来创建信封：

{
"accountId": "221765",
"emailSubject": "Hello World!",
"emailBlurb": "This comes from PHP",
"templateId": "9347C7AF-7EEE-4CEC-BA19-2734986F5501",
"templateRoles": [
    {
        "email": "test@gmail.com",
        "name": "John Doe",
        "clientUserId": "1001",
        "roleName": "Signer1",
        "tabs": {
            "textTabs": [
                {
                    "tabLabel": "address",
                    "value": "123 Main St. SF, CA"
                },
                {
                    "tabLabel": "zipCode",
                    "value": "94043"
                }
            ]
        }
    }
],
"status": "sent"
}

然后，您可以使用以下请求正文生成给定收件人的签名URL。请注意clientUserId（及其电子邮件和名称）与我们创建信封时的匹配情况：

{
"returnUrl": "http://www.docusign.com/devcenter",
"authenticationMethod": "None",
"email": "test@gmail.com",
"userName": "John Doe",
"clientUserId": "1001"
}

DocuSign开发中心的以下页面提供了有关如何完成此操作的详细信息（实际上非常简单）： http://www.docusign.com/developer-center/explore/features/embedding-docusign

DocuSign还有两个很棒的工具可以帮助您测试并开始编码，API演练（包含您开箱即用的示例代码，包括3个专注于嵌入功能的代码）和API Explorer - 它允许您在不编写任何代码的情况下进行任何api调用。

DocuSign API Walkthroughs DocuSign API Explorer

通过电子邮件发送的API获取此处的URL

1 个答案: