接口请求说明 | 微信开放文档

开发者可通过本接口对草稿进行修改。

# 接口请求说明

http 请求方式：POST（请使用https协议）https://api.weixin.qq.com/cgi-bin/draft/update?access_token=ACCESS_TOKEN

调用示例

图文消息：

{
    "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
    }
}

图片消息：

{
    "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
            }
        }
    }
}

请求参数说明

参数	是否必须	说明
media_id	是	要修改的图文消息的id
article_type	否	文章类型，分别有图文消息（news）、图片消息（newspic），不填默认为图文消息（news）
index	是	要更新的文章在图文消息中的位置（多图文消息时，此字段才有意义），第一篇为0
title	是	标题
author	否	作者
digest	否	图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空。如果本字段为没有填写，则默认抓取正文前54个字。
content	是	图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤。图片消息则仅支持纯文本和部分特殊功能标签如商品，商品个数不可超过50个
content_source_url	否	图文消息的原文地址，即点击“阅读原文”后的URL
thumb_media_id	是	图文消息的封面图片素材id（必须是永久MediaID）
need_open_comment	否	Uint32 是否打开评论，0不打开(默认)，1打开
only_fans_can_comment	否	Uint32 是否粉丝才可评论，0所有人可评论(默认)，1粉丝才可评论
pic_crop_235_1	否	封面裁剪为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_1	否	封面裁剪为1:1规格的坐标字段，裁剪原理同pic_crop_235_1，裁剪后的图片必须符合规格要求。
image_info	是	图片消息里的图片相关信息，图片数量最多为20张，首张图片即为封面图
image_media_id	是	图片消息里的图片素材id（必须是永久MediaID）
crop_percent_list	否	封面裁剪信息，裁剪比例ratio支持：“1_1”，“16_9”,“2.35_1”。以图片左上角（0,0），右下角（1,1）建立平面坐标系，经过裁剪后的图片，其左上角所在的坐标填入x1，y1参数，右下角所在的坐标填入x2，y2参数
product_info	否	商品相关信息
footer_product_info	否	文末插入商品相关信息
product_key	否	商品key

# 接口返回说明

{
    "errcode":ERRCODE,
    "errmsg":"ERRMSG"
}

返回参数说明

参数	说明
errcode	错误码
errmsg	错误信息

正常情况下调用成功时，errcode将为0。错误时微信会返回错误码等信息，请根据错误码查询错误信息

错误码说明

错误码	错误信息	解决方案
公共错误码	点击查看
40114	invalid index value
41039	invalid content_source_url
45166	invalid content
88000	without comment privilege
53404	账号已被限制带货能力，请删除商品后重试
53405	插入商品信息有误，请检查后重试	请检查请求参数是否合法，以及商品状态是否正常
53406	请先开通带货能力