跳到主要内容

查询文件下载URL

1. 接口描述​

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

查询文件下载URL。 适用场景：通过传参合同流程编号，下载对应的合同PDF文件流到本地。

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

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数​

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

参数名称必选类型描述
Action是String公共参数，本接口取值：DescribeFileUrls。
Version是String公共参数，本接口取值：2020-11-11。
Region否String公共参数，本接口不需要传递此参数。
Operator是UserInfo调用方用户信息，UserId 必填
BusinessType是String文件对应的业务类型，目前支持：
- 流程 "FLOW"，如需下载合同文件请选择此项
- 模板 "TEMPLATE"
- 文档 "DOCUMENT"
- 印章 “SEAL”
BusinessIds.N是Array of String业务编号的数组，如流程编号、模板编号、文档编号、印章编号。如需下载合同文件请传入FlowId
最大支持20个资源
FileName否String下载后的文件命名，只有FileType为zip的时候生效
FileType否String文件类型，"JPG", "PDF","ZIP"等
Offset否Integer指定资源起始偏移量，默认0
Limit否Integer指定资源数量，查询全部资源则传入-1
UrlTtl否Integer下载url过期时间，单位秒。0: 按默认值5分钟，允许范围：1s~24x60x60s(1天)

3. 输出参数​

参数名称类型描述
FileUrlsArray of FileUrl文件URL信息；
链接不是永久链接，有效期5分钟后链接失效。
TotalCountIntegerURL数量
RequestIdString唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例​

示例1 获取下载文件链接 --- 压缩多文件​

下载文件压缩包

输入示例​

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

{
    "Operator": {
        "UserId": "f2d8********f56b7"
    },
    "FileType": "ZIP",
    "BusinessType": "DOCUMENT",
    "FileName": "合同",
    "Limit": 0,
    "Offset": 0,
    "BusinessIds": [
        "e1a5****dfabfdbec6",
        "670d****590d4dcd",
        "dc3df****07f8323"
    ]
}

输出示例​

{
    "Response": {
        "FileUrls": [
            {
                "Url": "https://file.ess.myqcloud.com/files/DOCUMENT/xxxx.ZIP?key=key********1234",
                "Option": ""
            }
        ],
        "TotalCount": 1,
        "RequestId": "XXXX"
    }
}

示例2 获取下载文件链接 --- 单个文件​

下载单个合同文件

输入示例​

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

{
    "Operator": {
        "UserId": "yDRtRUUgxxxxxx4zjEyckqC592v"
    },
    "BusinessType": "FLOW",
    "BusinessIds": [
        "yDR0dUUgxxxxxxjEvWe1SbE7r"
    ]
}

输出示例​

{
    "Response": {
        "FileUrls": [
            {
                "Option": "[\"595.00,841.00\",\"-1\"]",
                "Url": "https://file.test.ess.tencent.cn/file/FLOW/yDR0dUxxxxxxxxWe1SbE7r/0/0.PDF?hkey=c80b3f1357821exxxxxxxxxxx2ad82345c777"
            }
        ],
        "RequestId": "1e1da50xxxxxx5d570ab151c9",
        "TotalCount": 1
    }
}

示例3 获取下载文件链接 --- 多个文件​

下载多个合同文件

输入示例​

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

{
    "Operator": {
        "UserId": "yDxM6UyK********QDV8dJUuO4zjEu"
    },
    "FileType": "PDF",
    "BusinessType": "DOCUMENT",
    "FileName": "合同",
    "Limit": 0,
    "Offset": 0,
    "BusinessIds": [
        "11114444",
        "11114444555",
        "12315215515",
        "12415251512"
    ]
}

输出示例​

{
    "Response": {
        "FileUrls": [
            {
                "Url": "https://file.ess.myqcloud.com/file/xxxx.PDF?key=abc",
                "Option": ""
            },
            {
                "Url": "https://file.ess.myqcloud.com/file/DOCUMENT/xxxx.PDF?key=abc",
                "Option": ""
            },
            {
                "Url": "https://file.ess.myqcloud.com/file/DOCUMENT/xxx.PDF?key=abc",
                "Option": ""
            },
            {
                "Url": "https://file.ess.myqcloud.com/file/DOCUMENT/xxx.PDF?key=abc",
                "Option": ""
            }
        ],
        "TotalCount": 4,
        "RequestId": "XXXX"
    }
}

5. 开发者资源​

腾讯云 API 平台​

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

API Inspector​

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

SDK​

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

命令行工具​

6. 错误码​

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

错误码描述
FailedOperation操作失败。
InternalError内部错误。
InternalError.Db数据库异常。
InternalError.DbRead内部错误,数据库查询失败,请稍后重试。
InternalError.DependsApi依赖的第三方API返回错误。
InternalError.System系统错误，请稍后重试。
InvalidParameter参数错误。
InvalidParameter.BusinessId不合法的业务id，请检查是否传递，检查是否超过接口上限数量，并在修改后重试。
InvalidParameter.BusinessType不合法的业务类型，请检查后重试。
InvalidParameter.ParamError参数错误。
MissingParameter缺少参数错误。
OperationDenied.ErrNoResourceAccess此企业无该资源使用权限。
OperationDenied.FileDeleted文件已被删除，请联系客服处理。
OperationDenied.Forbid禁止此项操作。
OperationDenied.NoIdentityVerify未通过个人实名认证。
OperationDenied.NoLogin用户未登录,请先登录后再操作。
ResourceNotFound资源不存在。
ResourceNotFound.Application应用号不存在或已删除。
ResourceNotFound.NotExistDocument电子文档不存在。
ResourceNotFound.Resource未获取到文件资源，请检查资源是否完成上传，是否有效，并在修改后重试。
ResourceUnavailable资源不可用。
UnauthorizedOperation未授权操作。
UnauthorizedOperation.NoPermissionFeature请升级到对应版本后即可使用该接口。
UnknownParameter未知参数错误。