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

# 接口请求说明

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

调用示例

{
    "media_id":MEDIA_ID,
    "index":INDEX,
    "articles":{
        "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 要修改的图文消息的id
index 要更新的文章在图文消息中的位置(多图文消息时,此字段才有意义),第一篇为0
title 标题
author 作者
digest 图文消息的摘要,仅有单图文消息才有摘要,多图文此处为空。如果本字段为没有填写,则默认抓取正文前54个字。
content 图文消息的具体内容,支持HTML标签,必须少于2万字符,小于1M,且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤。
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,裁剪后的图片必须符合规格要求。

# 接口返回说明

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

返回参数说明

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

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

错误码说明

错误码 错误信息 解决方案
公共错误码 点击查看
40114 invalid index value
41039 invalid content_source_url
45166 invalid content
88000 without comment privilege