# 朋友圈图片及视频的下载
[异步回调]朋友圈图片及视频的下载
说明:可调用此接口下载企业微信机器人获取的朋友圈的图片或视频信息。
请求方式:POST
请求地址:https://$basehost/gateway/qopen/MomentDownload
body参数:
{
"robot_id": "机器人id",
"moment_id": "推送至微信客户端成功返回的朋友圈id",
"media_id": "下载编号",
"post_id": "推送至企业微信成功返回的朋友圈id",
"moment_type": 2002
}
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
robot_id | string | 是 | 机器人id |
moment_id | string | 是 | 必传,推送至微信客户端成功返回的朋友圈id |
media_id | string | 是 | 下载编号 |
post_id | string | 是 | 必传,推送至企业微信成功返回的朋友圈id |
moment_type | int | 是 | 2002:图片,2004:视频 |
返回值:
{
"data": {
"serial_no": "xxxxxx"
},
"errcode": 0,
"errmsg": "",
"hint": ""
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
errcode | int | 状态码,0为正常,非0代表错误 |
errmsg | string | 错误信息 |
data | json | json返回值 |
serial_no | string | 操作序列号 |
hint | string | 请求日志ID |
处理结果,异步返回值:
{
"event_type": 401010,
"serial_no": "操作序列号",
"err_code": 0,
"err_msg": "success",
"data": {
"post_id": "推送至企业微信成功返回的朋友圈id",
"moment_id": "推送至微信客户端成功返回的朋友圈id",
"media_id": "下载编号",
"media_url": "下载图片/视频地址"
}
}
返回说明
字段 | 类型 | 说明 |
---|---|---|
event_type | int | 事件类型,401010 |
serial_no | string | 操作序列号 |
err_code | int | 状态码,0为正常,非0代表错误 |
err_msg | string | 错误信息 |
data | object | 返回数据 |
data.post_id | string | 推送至企业微信成功返回的朋友圈id |
data.moment_id | string | 推送至微信客户端成功返回的朋友圈id |
data.media_id | string | 下载编号 |
data.media_url | string | 下载图片/视频地址 |
完整请求示例:
curl -X POST https://$basehost/gateway/qopen/MomentDownload \
-H 'Content-Type: application/json; charset=UTF-8' \
-H 'Token: c2NdxDHKXIJ5j1zrhJeq2eJEHjh9xxx' \
-d '{
"robot_id": "机器人id",
"moment_id": "推送至微信客户端成功返回的朋友圈id",
"media_id": "下载编号",
"post_id": "推送至企业微信成功返回的朋友圈id",
"moment_type": 2002,
}'