getClickwrapAgreements 不返回文档

Question

getClickwrapAgreements 调用不是 returning 与该协议关联的文档列表。根据 API documentation，此调用应该 return 一个 documents 对象数组，其中包含例如documentBase64、documentName、fileExtension，但该数组始终为空。

示例请求：

https://demo.docusign.net/clickapi/v1/accounts/<accountid>/clickwraps/<clickwrapId>/users?client_user_id=<userId>

示例响应：

{
    "userAgreements": [
        {
            "accountId": "<accountId>",
            "clickwrapId": "<clickwrapId>",
            "clientUserId": "<userId>",
            "agreementId": "<agreementId>",
            "documents": [],
            "createdOn": "2020-09-25T11:30:26.8230097Z",
            "agreedOn": "2020-09-25T11:30:34.5580771Z",
            "status": "agreed",
            "versionId": "e90d4cb6-868b-48a3-9b1c-5a7f2083102d",
            "versionNumber": 8,
            "settings": {
                "hasDeclineButton": false,
                "actionButtonAlignment": "left",
                "mustRead": false,
                "mustView": false,
                "requireAccept": false,
                "downloadable": true,
                "sendToEmail": false,
                "brandId": "68cbc4b1-a78f-4e72-889e-0554141da176",
                "format": "inline",
                "documentDisplay": "document"
            }
        }
    ],
    "beginCreatedOn": "2019-01-01T00:00:00Z",
    "page": 0,
    "pageSize": 40,
    "minimumPagesRemaining": 0
}

当我导航到 Docusign 网站中的“管理点击生效”页面时，我可以下载与该协议关联的证书。如果我允许收件人下载协议，他们同意后也可以下载。

对于上下文，我需要在后端存储每个用户的协议证书的副本。

Answer 1

感谢您报告此事。这似乎是 Clickwraps 的错误——我将在内部报告该错误已解决。与此同时，我能够重现这个问题，并且可以确认如果以任何形式点击用户协议，文档节点确实会返回空白。

但是，我能够找到这个：在您已经进行的调用中，您可以在响应中看到 agreementId 的参数。我做了一些修补，发现如果我点击这个 URI： “https://demo.docusign.net/clickapi/v1/accounts/{ACCOUNTID}/clickwraps/{clickwrapID}/agreements/{agreementId}/download?include_coc=true”，我能够下载与该协议相关的 PDF。 include coc 的 url 参数确定是否将额外的完成证书添加到 PDF 中。

getClickwrapAgreements 不返回文档

getClickwrapAgreements not returning documents

docusignapi