企微文件下载（异步）

POST

/api/qw/doApi

下载响应的地址为临时云资源，非官方CDN地址，并且会定期清理，请自行及时下载

异步结果会通过http/mqtt的方式回调通知，详情查看开发指南->消息回调

回调通知中的requestId会与同步响应中的requestId等同

请求参数

Header 参数

Body 参数application/json

示例

{
    "method": "/cloud/wxWorkDownloadAsync",
    "params": {
        "guid": "{{guid}}",
        "fileAeskey": "4fe9c203406149e79c2ab8917da9befc",
        "fileId": "30690201020462306002010002044c9aff3e02030f42410204157a5875020468bfa27b042432663162613961612d316564372d343566642d393933342d38623931653064346136656502010002030080100410d889b75ac62fec2b3b23988deeb2d7050201050201000400",
        "fileSize": 32768,
        "fileType": 5
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/qw/doApi' \
--header 'X-QIWEI-TOKEN: {{tokenId}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "method": "/cloud/wxWorkDownloadAsync",
    "params": {
        "guid": "{{guid}}",
        "fileAeskey": "4fe9c203406149e79c2ab8917da9befc",
        "fileId": "30690201020462306002010002044c9aff3e02030f42410204157a5875020468bfa27b042432663162613961612d316564372d343566642d393933342d38623931653064346136656502010002030080100410d889b75ac62fec2b3b23988deeb2d7050201050201000400",
        "fileSize": 32768,
        "fileType": 5
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "data": {
        "cloudUrl": "https://wework.qpic.cn/w**********p2RNQHmdDjh_1709274772/0"
    },
    "msg": "成功"
}

修改于 2026-02-09 07:11:00

企微文件下载

企微大文件下载（异步）