获取合同PDF下载链接

1. 接口描述

接口请求域名： essbasic.tencentcloudapi.com 。

获取合同流程PDF的下载链接，可以下载签署中、签署完的此子企业创建的合同

注意:
有两种开通权限的途径

第一种: 需第三方应用的子企业登录控制台进行授权, 授权在企业中心的授权管理区域, 界面如下图。
授权过程需要子企业超管扫描跳转到电子签小程序签署<<渠道端下载渠道子客合同功能授权委托书>>

第二种: 渠道方企业在企业应用管理的配置界面打开需要配置的应用，点击应用扩展服务开通此功能，需要渠道方企业的超管扫描二维码跳转到电子签小程序签署 <<渠道端下载渠道子客合同功能开通知情同意书>>
注:

1. 请注意如果第三方应用的子客主动关闭了渠道端下载渠道子客合同功能开关，那么渠道方开通了此功能也无法下载子客的合同文件
   

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 批量获取下载链接全成功

批量获取2个合同流程全部成功

输入示例

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeResourceUrlsByFlows
<公共请求参数>

{
    "Agent": {
        "AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
        "ProxyOrganizationOpenId": "org_dianziqian",
        "ProxyOperator": {
            "OpenId": "n9527"
        },
        "ProxyAppId": ""
    },
    "FlowIds": [
        "yDwivUUckpor6wtoUuogwQHCAB0ES0pQ",
        "yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh"
    ]
}

输出示例

{
    "Response": {
        "FlowResourceUrlInfos": [
            {
                "FlowId": "yDwivUUckpor6wtoUuogwQHCAB0ES0pQ",
                "ResourceUrlInfos": [
                    {
                        "Url": "https://file.test.ess.tencent.cn/file/FLOW/yDwivUUckpor6wtoUuogwQHCAB0ES0pQ/0/0.PDF?hkey=70b1**9c63e",
                        "Name": "合同,270481027143248.pdf",
                        "Type": "PDF"
                    }
                ]
            },
            {
                "FlowId": "yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh",
                "ResourceUrlInfos": [
                    {
                        "Url": "https://file.test.ess.tencent.cn/file/FLOW/yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh/0/0.PDF?hkey=70b1**c63",
                        "Name": "合同,250151025185515.pdf",
                        "Type": "PDF"
                    }
                ]
            }
        ],
        "ErrorMessages": [
            "",
            ""
        ],
        "RequestId": "d49c0838-94b6-45f8-995e-42f61dfa0c05"
    }
}

示例2 批量获取下载链接一个成功一个失败

批量获取2个合同流程的下载链接, 因第一个合同yDwivUUckpor6wtoUuogwQHCAB0ES0p1不存在, 第二个合同获取成功

输入示例

POST / HTTP/1.1
Host: essbasic.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeResourceUrlsByFlows
<公共请求参数>

{
    "Agent": {
        "AppId": "yDwhxUUckp3gl8j5UuFX33LSNozpRsbi",
        "ProxyOrganizationOpenId": "org_dianziqian",
        "ProxyOperator": {
            "OpenId": "n9527"
        },
        "ProxyAppId": ""
    },
    "FlowIds": [
        "yDwivUUckpor6wtoUuogwQHCAB0ES0p1",
        "yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh"
    ]
}

输出示例

{
    "Response": {
        "FlowResourceUrlInfos": [
            {
                "FlowId": "yDwivUUckpor6wtoUuogwQHCAB0ES0p1",
                "ResourceUrlInfos": []
            },
            {
                "FlowId": "yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh",
                "ResourceUrlInfos": [
                    {
                        "Url": "https://file.test.ess.tencent.cn/file/FLOW/yDwi8UUckpo5fz9cUqI6nGwcuTvt9YSh/0/0.PDF?hkey=70b1***9c63",
                        "Name": "合同,250151025185515.pdf",
                        "Type": "PDF"
                    }
                ]
            }
        ],
        "ErrorMessages": [
            "查询流程不存在",
            ""
        ],
        "RequestId": "2e9fc432-53b4-4286-b706-7a5de509310b"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。