图文消息留言管理接口 | 微信公众号 | up61教程-记录世界,记录你!
图文消息留言管理接口
- *
为了方便公众号开发者和公众号第三方平台开发者灵活使用图文消息的留言功能，上线了留言功能的相关接口。
1. 评论能力管理
新建素材时，当公众号具备留言功能的权限时，可以指定 media_id 在群发时打开留言功能，并指定该 media_id 的评论范围（所有人都可以留言，或仅公众号粉丝可以留言）。
1.1 新增永久素材（原接口有所改动）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
title
是
string
标题
thumb_media_id
是
string
图文消息的封面图片素材id（必须是永久 media_ID）
authod
是
string
作者
digest
是
string
图文消息的摘要，仅有单图文消息才有摘要，多图文此处为空
show_cover_pic
是
string
是否显示封面，0为false，即不显示，1为true，即显示
content
是
string
图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS
content_source_url
是
string
图文消息的原文地址，即点击“阅读原文”后的URL
need_open_comment（新增字段）
否
Uint32
是否打开评论，0不打开，1打开
only_fans_can_comment（新增字段）
否
Uint32
是否粉丝才可评论，0所有人可评论，1粉丝才可评论
调用示例
{ “articles”:[{ “title”: TITLE, “thumb_media_id”: THUMB_MEDIA_ID, “author”: AUTHOR, “digest” : DIGEST, “show_cover_pic”: SHOW_COVER_PIC（0/1）, “content” : CONTENT, “content_source_url”: CONTENT_SOURCE_URL, “need_open_comment” : NEED_OPEN_COMMENT（0/1）, “only_fans_can_comment” : ONLY_FANS_CAN_COMMENT（0/1） }] //若新增的是多图文素材，则此处应有几段articles结构，最多8段 }返回（json 格式）
{ “media_id” : MEDIA_ID } 新增返回码（json格式） { “errcode” : 88000， “errmsg” : “without comment privilege” //没有留言权限 }1.2 获取永久素材（原接口有所改动）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/material/get_material?access_token=ACCESS_TOKEN返回说明
新增返回字段 need_open_comment 和 only_fans_can_comment
1.3 修改永久图文素材（原接口有所改动）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/material/update_news?access_token=ACCESS_TOKEN新增参数 need_open_comment 和 only_fans_can_comment
1.4 获取素材列表（原接口有所改动）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=ACCESS_TOKEN新增参数 need_open_comment 和 only_fans_can_comment
2. 评论数据管理
2.1 打开已群发文章评论（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/open?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index” : INDEX }返回（json格式）
{ “errcode”: ERRCODE, “errmsg” : ERRMSG }返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 } { “errcode” : 88000， “errmsg” : “without comment privilege” //没有留言权限 } { “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 } { “errcode”: 88002, “errmsg” : “the article is limit for safety” //文章存在敏感信息 }2.2 关闭已群发文章评论（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/close?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index” : INDEX, }返回（json格式）
{ “errcode”: ERRCODE, “errmsg” : ERRMSG }2.3 查看指定文章的评论数据（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/list?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认返回该msg_data_id的第一篇图文
begin
是
Uint32
起始位置
count
是
Uint32
获取数目（>=50会被拒绝）
type
是
Uint32
type=0 普通评论&精选评论 type=1 普通评论 type=2 精选评论
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index” : INDEX, “begin”: BEGIN, “count”: COUNT, “type” : TYPE }返回（json格式）
{ “errcode”: 0, “errmsg” : “ok”, “total”: TOTAL //总数，非comment的size around“comment”: [{ user_comment_id : USER_COMMENT_ID //用户评论id aroundopenid : OPENID //openid aroundcreate_time : CREATE_TIME //评论时间 aroundcontent : CONTENT //评论内容aroundcomment_type : IS_ELECTED //是否精选评论，0为即非精选，1为true，即精选around reply :around { content : CONTENT //作者回复内容around create_time : CREATE_TIME //作者回复时间 } }] around}返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 } { “errcode” : 88000， “errmsg” : “open comment without comment privilege” //没有留言权限 } { “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 } { “errcode” : 88010, “errmsg” : “count range error. cout <= 0 or count > 50” //获取评论数目不合法 }2.4 将评论标记精选（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/markelect?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
user_comment_id
是
Uint32
用户评论id
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index”: INDEX, “user_comment_id”: COMMENT_ID, }返回格式（json）
{ “errcode”: ERRCODE, “errmsg” : ERRMSG }返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 } { “errcode” : 88000， “errmsg” : “open comment without comment privilege” //没有留言权限 } { “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 } { “errcode” : 88003, “errmsg” : “elected comment upper limit” //精选评论数已达上限 } { “errcode” : 88004, “errmsg” : “comment was deleted by user” //已被用户删除，无法精选 } { “errcode” : 88008, “errmsg” : “comment is not exists” //该评论不存在 }2.5 将评论取消精选
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/unmarkelect?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
user_comment_id
是
Uint32
用户评论id
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index”: INDEX, “user_comment_id”: COMMENT_ID, }返回格式（json）
{ “errcode”: ERRCODE, “errmsg” : ERRMSG }返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 }{ “errcode” : 88000， “errmsg” : “open comment without comment privilege” //没有留言权限 }{ “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 }{ “errcode” : 88008, “errmsg” : “comment is not exists” //该评论不存在 }2.6 删除评论（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/delete?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
user_comment_id
是
Uint32
评论id
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index” : INDEX, “user_comment_id”: COMMENT_ID, }返回格式（json）
{“errcode”: ERRCODE, “errmsg” : ERRMSG }返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 } { “errcode” : 88000， “errmsg” : “open comment without comment privilege” //没有留言权限 } { “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 } { “errcode” : 88008, “errmsg” : “comment is not exists” //该评论不存在 }2.7 回复评论（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/reply/add?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
user_comment_id
是
Uint32
评论id
content
是
string
回复内容
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index” : INDEX, “user_comment_id”: COMMENT_ID, “content”: CONTENT }返回格式（json）
{ “errcode”: ERRCODE, “errmsg” : ERRMSG }返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 } { “errcode” : 88000， “errmsg” : “open comment without comment privilege” //没有留言权限 } { “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 } { “errcode” : 88005, “errmsg” : “already reply” //已经回复过了 } { “errcode” : 88007, “errmsg” : “reply content beyond max len or content len is zero”//回复超过长度限制或为0 } { “errcode” : 88008, “errmsg” : “comment is not exists” //该评论不存在 }2.8 删除回复（新增接口）
接口调用请求说明
https 请求方式: POSThttps://api.weixin.qq.com/cgi-bin/comment/reply/delete?access_token=ACCESS_TOKEN参数说明
参数
是否必须
类型
说明
msg_data_id
是
Uint32
群发返回的msg_data_id
index
否
Uint32
多图文时，用来指定第几篇图文，从0开始，不带默认操作该msg_data_id的第一篇图文
user_comment_id
是
Uint32
评论id
调用示例
{ “msg_data_id” : MSG_DATA_ID, “index” : INDEX, “user_comment_id”: COMMENT_ID, }返回格式（json）
{ “errcode”: ERRCODE, “errmsg” : ERRMSG }返回码定义
{ “errcode” : 45009, “errmsg” : “reach max api daily quota limit” //没有剩余的调用次数 } { “errcode” : 88000， “errmsg” : “open comment without comment privilege” //没有留言权限 } { “errcode” : 88001, “errmsg” : “msg_data is not exists” //该图文不存在 } { “errcode” : 88008, “errmsg” : “comment is not exists” //该评论不存在 } { “errcode” : 87009, “errmsg” : “reply is not exists” //该回复不存在 }Original url: Access
Created at: 2019-08-15 15:49:31
Category: default
Tags: none
未标明原创文章均为采集，版权归作者所有，转载无需和我联系，请注明原出处，南摩阿彌陀佛，知识，不只知道，要得到
最新评论