公众号
取消
中文
中文
EN
取消
  • 服务端 API

    • # 更新草稿

    调试工具

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：draft_update

    本接口用于修改图文或图片消息草稿。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/cgi-bin/draft/update?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：11、100

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填示例说明
    media_idstring是MEDIA_ID要修改的图文消息的id
    indexnumber是0要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0
    articlesobject是-图文信息

    # Body.articles Object Payload

    图文信息

    参数名类型必填说明
    article_typestring否文章类型，分别有图文消息（news）、图片消息（newspic），不填默认为图文消息（news）
    titlestring是标题
    authorstring否作者
    digeststring否图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空。如果本字段为没有填写，则默认抓取正文前54个字。
    contentstring是图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤。 图片消息则仅支持纯文本和部分特殊功能标签如商品，商品个数不可超过50个
    content_source_urlstring否图文消息的原文地址，即点击“阅读原文”后的URL
    thumb_media_idstring否图文消息的封面图片素材id（必须是永久MediaID）
    need_open_commentnumber否是否打开评论，0不打开(默认)，1打开
    only_fans_can_commentnumber否是否粉丝才可评论，0所有人可评论(默认)，1粉丝才可评论
    pic_crop_235_1string否图文消息封面裁剪为2.35:1规格的坐标字段。以原始图片（thumb_media_id）左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其左上角所在的坐标即为（X1,Y1）,右下角所在的坐标则为（X2,Y2），用分隔符_拼接为X1_Y1_X2_Y2，每个坐标值的精度为不超过小数点后6位数字。示例见下图，图中(X1,Y1) 等于（0.1945,0）,(X2,Y2)等于（1,0.5236），所以请求参数值为0.1945_0_1_0.5236。
    pic_crop_1_1string否图文消息封面裁剪为1:1规格的坐标字段，裁剪原理同pic_crop_235_1，裁剪后的图片必须符合规格要求。
    image_infoobject是图片消息里的图片相关信息，图片数量最多为20张，首张图片即为封面图
    cover_infoobject否图片消息的封面信息
    product_infoobject否商品信息

    # Body.articles.image_info Object Payload

    图片消息里的图片相关信息，图片数量最多为20张，首张图片即为封面图

    参数名类型必填说明
    image_listobjarray是图片列表

    # Body.articles.image_info.image_list(Array) Object Payload

    图片列表

    参数名类型必填说明
    image_media_idstring是图片消息里的图片素材id（必须是永久MediaID）

    # Body.articles.cover_info Object Payload

    图片消息的封面信息

    参数名类型必填说明
    crop_percent_listobjarray否封面裁剪信息，。以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其左上角所在的坐标填入x1，y1参数，右下角所在的坐标填入x2，y2参数

    # Body.articles.cover_info.crop_percent_list(Array) Object Payload

    封面裁剪信息，。以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其左上角所在的坐标填入x1，y1参数，右下角所在的坐标填入x2，y2参数

    参数名类型必填说明
    ratiostring否裁剪比例，支持：“1_1”，“16_9”,“2.35_1”
    x1string否以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其左上角所在的坐标填入x1，y1参数
    y1string否以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其左上角所在的坐标填入x1，y1参数
    x2string否以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其右下角所在的坐标填入x2，y2参数
    y2string否以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其右下角所在的坐标填入x2，y2参数

    # Body.articles.product_info Object Payload

    商品信息

    参数名类型必填说明
    footer_product_infoobject否文末插入商品相关信息

    # Body.articles.product_info.footer_product_info Object Payload

    文末插入商品相关信息

    参数名类型必填说明
    product_keystring否商品key

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息

    # 4. 注意事项

    本接口无特殊注意事项

    # 5. 代码示例

    # 5.1 更新图文消息草稿

    请求示例

    {
    "media_id":MEDIA_ID,
    "index":INDEX,
    "articles":{
        "article_type":"news",
        "title":TITLE,
        "author":AUTHOR,
        "digest":DIGEST,
        "content":CONTENT,
        "content_source_url":CONTENT_SOURCE_URL,
        "thumb_media_id":THUMB_MEDIA_ID,
        "need_open_comment":0,
        "only_fans_can_comment":0,
        "pic_crop_235_1":X1_Y1_X2_Y2,
        "pic_crop_1_1":X1_Y1_X2_Y2
    }
}

    返回示例

    {
  "errcode": 0,
  "errmsg": "ok"
}

    # 5.2 更新图片消息草稿

    请求示例

    {
    "media_id":MEDIA_ID,
    "index":INDEX,
    "articles":{
        "article_type":"newspic",
        "title":TITLE,
        "content":CONTENT,
        "need_open_comment":0,
        "only_fans_can_comment":0,
        "image_info":{
            "image_list":[
                {
                    "image_media_id":IMAGE_MEDIA_ID
                }
            ]
        },
        "cover_info":{
            "crop_percent_list":[
                {
                    "ratio": "1_1",
                    "x1":"0.166454",
                    "y1":"0",
                    "x2":"0.833545",
                    "y2":"1"
                }
                // 如有其他比例的裁剪需求，可继续在此处填写
            ]
        },
        "product_info": {
            "footer_product_info": {
                "product_key":PRODUCT_KEY
            }
        }
    }
}

    返回示例

    {
  "errcode": 0,
  "errmsg": "ok"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    0ok成功
    40114invalid index value
    41039invalid content_source_url
    45166invalid content
    53404账号已被限制带货能力请删除商品后重试
    53405插入商品信息有误请检查参数及商品状态
    53406请先开通带货能力
    88000without comment privilege

    # 7. 适用范围

    本接口在不同账号类型下的可调用情况：
    公众号服务号
    ✔ ✔
    • ✔：该账号可调用此接口
    • 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口；