# 朋友圈图片及视频的下载

[异步回调]朋友圈图片及视频的下载

说明:可调用此接口下载企业微信机器人获取的朋友圈的图片或视频信息。

请求方式: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,
         }'
最后更新时间: 2025/4/27 20:36:54