3.51 批量下载文件

test-测试环境

https://oc-test.onecontract-cloud.com

POST

/api/hitf/v2/rest/async/invoke/FILE_DL

根据提供的 fileKey 列表（每次最多下载 100 个），将全部文件自动打成压缩包（压缩时间取决于处理的文件数据）。由于批量下载将占用大量资源，采取特殊的限流空值，每分钟最多6 次，建议串行下载。下载吞吐量预估：100 个 x 6 次/分钟=600 个/分钟。
接口为异步处理，需要配合 3.52 获取文件下载链接使用

请求参数

Header 参数

Body 参数application/json

示例

{
    "fileKeys": "hcbm-contract/contract-file/1273/HUAWEI_CLOUD/2025Y/10M/c57c3271a066455a9cfdb12c07a12a89@新签-服务协议-0220.pdf,hcbm-contract/1273/HUAWEI_CLOUD/2025Y/09M/2d75ec697b164727a18db6d3209b4b7f@示例合同.docx"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/FILE_DL' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fileKeys": "hcbm-contract/contract-file/1273/HUAWEI_CLOUD/2025Y/10M/c57c3271a066455a9cfdb12c07a12a89@新签-服务协议-0220.pdf,hcbm-contract/1273/HUAWEI_CLOUD/2025Y/09M/2d75ec697b164727a18db6d3209b4b7f@示例合同.docx"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例失败示例

{
    "code": "0",
    "data": {
        "fileDlUuid": "146e61f1bd0f4cad8044612c8487bb27",
        "fileKeys": "hcbm-contract/contract-file/1273/HUAWEI_CLOUD/2025Y/10M/c57c3271a066455a9cfdb12c07a12a89@新签-服务协议-0220.pdf,hcbm-contract/1273/HUAWEI_CLOUD/2025Y/09M/2d75ec697b164727a18db6d3209b4b7f@示例合同.docx",
        "subCode": "0",
        "subMessage": "成功"
    },
    "message": "成功"
}

3.15 通用附件上传接口

3.52 获取文件下载链接