获取异步下载视频消息结果

根据异步下载任务 ID 查询视频下载进度和下载结果。

接口地址： POST /getMsgVideoRes

前置条件

• 已调用 异步下载消息中的视频，并拿到返回的 data.id。
• 下载任务仍在有效期内。

请求参数

参数名	必选	类型	说明
id	是	string	异步下载任务 ID

请求示例

{
  "id": "6eb5d834-1dfe-47ad-b7a5-b9f2fb60a35a"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	下载结果
data.url	string	下载完成后的视频地址
data.type	int	下载状态：0 下载中，1 下载完成，2 下载失败
data.des	string / null	描述信息
data.id	string	任务 ID

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "url": "https://cdn.e-yun.example/msgVideo/f0aa717e-4c34-4185-a420-c831fa40be94.mp4",
    "type": 1,
    "des": null,
    "id": "6eb5d834-1dfe-47ad-b7a5-b9f2fb60a35a"
  }
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• type=0 时继续等待，不要重复提交下载任务。
• type=1 时及时保存或转存 url。
• type=2 时可根据 des 排查失败原因，再决定是否重新提交下载任务。