开发者可通过本接口对草稿进行修改。
# 接口请求说明
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 |