# 下载消息文件

[异步回调] 目前成员发给机器人的文件消息不会预下载 当成员发给机器人或机器人发给成员的消息中包含图片、视频、文件时,可以通过该接口下载文件。

请求方式:POST

请求地址:https://$basehost/gateway/qopen/MessageFileDownload

body参数

{
  "robot_id": "accsvQ1yOXP95Hdwk2MLA0I",
  "file_id": "d293b595a31c2f9b01288f9b3b6a89b7",
  "download_file_type": 3
}
字段 类型 必填 说明
robot_id string 机器人id
file_id string 文件id
download_file_type int 下载文件类型: 1:文件/图片/视频 3:视频和视频缩略图

返回值:

{
    "data": {
        "serial_no": "c679e94d247a4af0b17e977da617171f"
    },
    "errcode": 0,
    "errmsg": "",
    "hint": "D8T3BfgL3RhDDqr0rjQA"
}

处理结果,异步返回值:

{
    "data": {
        "cover_url": "https://health-picture-1259287960.cos.ap-guangzhou.myqcloud.com/5c0b39aaeef149ebb6eb7684d0efbf8d.jpg",
        "file_sn": "d293b595a31c2f9b01288f9b3b6a89b7",
        "file_url": "https://health-picture-1259287960.cos.ap-guangzhou.myqcloud.com/632d9b07dde4499ab546af219686a41f.mp4"
    },
    "err_code": 0,
    "err_msg": "success",
    "event_type": 400007,
    "hint": "jxXD3WYL3RhDUevK0j0A.Wb8ibK.bLjGXdEL3RhDUevxpqYA.kSqfRO.1748331154",
    "robot_id": "accsvQ1yOXP95Hdwk2MLA0I",
    "serial_no": "0657e64279e047d7a39afb6db11e1258"
}

说明

字段 类型 说明
event_type int 事件类型,400007
robot_id string 机器人id
serial_no string 请求的流水号
data json json返回值
cover_url string 缩略图链接地址,下载类型为3时有值
file_sn string 文件id
file_url string 文件下载链接地址

完整请求示例:

curl -X POST \
  https://$basehost/gateway/eaopen/SendSystemMsg \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
  -d '{
  "robot_id": "accsvQ1yOXP95Hdwk2MLA0I",
  "file_id": "d293b595a31c2f9b01288f9b3b6a89b7",
  "download_file_type": 3
}'
最后更新时间: 2025/5/28 10:24:16