Docusignapi 如何从信封下载签名文件？

一旦用户签署了附加到信封上的文档，开发人员是否可以使用RESTAPI端点下载该文档？在下载之前，有没有办法判断文档是否已签名？

第一部分：确定某个签名者或所有收件人是否已完成/提交信封

要检查特定签名者（收件人）是否已完成对信封的签名，您可以使用以下请求：

GET/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients

如图所示，JSON响应中的

signers

属性是信封的签名者数组，每个signer对象中的

status

属性表示特定收件人的状态。签名者的状态为“已完成”表示收件人已签署/完成/提交信封

{
    ...
    "signers": [
        {
            "deliveredDateTime": "2016-10-05T21:18:12.3330000Z",
            "email": "jallard@example.com",
            "isBulkRecipient": "false",
            "name": "Jennie Allard",
            "recipientId": "1",
            "recipientIdGuid": "4575d5e9-7654-467b-b2f5-6c59ca7c43f8",
            "requireIdLookup": "false",
            "routingOrder": "1",
            "signedDateTime": "2016-10-05T21:18:41.6930000Z",
            "status": "completed",
            "userId": "ca45284a-a94e-4ee2-90af-76035bd795b2"
        }
    ]
}

或者，要检查信封的所有收件人是否已完成/提交信封，您可以使用以下请求：

GET/v2/accounts/{accountId}/envelopes/{envelopeId}

如图所示，响应将是一个信封对象，该对象中的

状态

属性指示信封的整体状态。

status

ofcompleted表示所有收件人已完成/提交信封

{
    ...
    "signers": [
        {
            "deliveredDateTime": "2016-10-05T21:18:12.3330000Z",
            "email": "jallard@example.com",
            "isBulkRecipient": "false",
            "name": "Jennie Allard",
            "recipientId": "1",
            "recipientIdGuid": "4575d5e9-7654-467b-b2f5-6c59ca7c43f8",
            "requireIdLookup": "false",
            "routingOrder": "1",
            "signedDateTime": "2016-10-05T21:18:41.6930000Z",
            "status": "completed",
            "userId": "ca45284a-a94e-4ee2-90af-76035bd795b2"
        }
    ]
}

第二部分：下载完整的文件

有关与检索信封文档相关的终结点，请参阅以下页面：。您可能会使用该请求获取信封中的文档列表，然后随后为要检索的每个文档发出请求

其他评论

---

虽然您当然可以使用REST API请求，如我上面所述，定期轮询信封（或收件人）状态，然后在信封（和/或收件人）状态完成时请求文档，但更有效的替代方法是使用，您可以将其配置为在信封达到状态=已完成时自动将信封状态和文档推送到您指定的端点。第一部分：确定特定签名者或所有收件人是否已完成/提交信封

要检查特定签名者（收件人）是否已完成对信封的签名，您可以使用以下请求：

GET/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients

如图所示，JSON响应中的

signers

属性是信封的签名者数组，每个signer对象中的

status

属性表示特定收件人的状态。签名者的状态为“已完成”表示收件人已签署/完成/提交信封

{
    ...
    "signers": [
        {
            "deliveredDateTime": "2016-10-05T21:18:12.3330000Z",
            "email": "jallard@example.com",
            "isBulkRecipient": "false",
            "name": "Jennie Allard",
            "recipientId": "1",
            "recipientIdGuid": "4575d5e9-7654-467b-b2f5-6c59ca7c43f8",
            "requireIdLookup": "false",
            "routingOrder": "1",
            "signedDateTime": "2016-10-05T21:18:41.6930000Z",
            "status": "completed",
            "userId": "ca45284a-a94e-4ee2-90af-76035bd795b2"
        }
    ]
}

或者，要检查信封的所有收件人是否已完成/提交信封，您可以使用以下请求：

GET/v2/accounts/{accountId}/envelopes/{envelopeId}

如图所示，响应将是一个信封对象，该对象中的

状态

属性指示信封的整体状态。

status

ofcompleted表示所有收件人已完成/提交信封

{
    ...
    "signers": [
        {
            "deliveredDateTime": "2016-10-05T21:18:12.3330000Z",
            "email": "jallard@example.com",
            "isBulkRecipient": "false",
            "name": "Jennie Allard",
            "recipientId": "1",
            "recipientIdGuid": "4575d5e9-7654-467b-b2f5-6c59ca7c43f8",
            "requireIdLookup": "false",
            "routingOrder": "1",
            "signedDateTime": "2016-10-05T21:18:41.6930000Z",
            "status": "completed",
            "userId": "ca45284a-a94e-4ee2-90af-76035bd795b2"
        }
    ]
}

第二部分：下载完整的文件

有关与检索信封文档相关的终结点，请参阅以下页面：。您可能会使用该请求获取信封中的文档列表，然后随后为要检索的每个文档发出请求

其他评论

---

虽然您当然可以使用REST API请求，如我上面所述，定期轮询信封（或收件人）状态，然后在信封（和/或收件人）状态完成时请求文档，但更有效的替代方法是使用，您可以将其配置为当信封达到状态=完成时自动将信封状态和文档推送到指定的端点

非常感谢您的详细回复。我很感激。没问题，很高兴我能帮上忙。是的，金姆！谢谢你的时间和回答！！非常感谢您的详细回复。我很感激。没问题，很高兴我能帮上忙。是的，金姆！谢谢你的时间和回答！！