# 下载消息文件
[异步回调] 目前成员发给机器人的文件消息不会预下载 当成员发给机器人或机器人发给成员的消息中包含图片、视频、文件时,可以通过该接口下载文件。
请求方式: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
}'
← 发送系统消息 新群聊 - 20002 →