# 查看指定文章的评论数据
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南
接口英文名：listComment
本接口用于查看指定文章的评论数据
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/comment/list?access_token=ACCESS_TOKEN
# 云调用
调用方法：officialAccount.comment.list
出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：7
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证，可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| msg_data_id | number | 是 | 群发返回的msg_data_id |
| index | number | 否 | 多图文时，用来指定第几篇图文，从0开始，不带默认返回该msg_data_id的第一篇图文 |
| begin | number | 是 | 起始位置 |
| count | number | 是 | 获取数目（>=50会被拒绝） |
| type | number | 是 | type=0 普通评论&精选评论 type=1 普通评论 type=2 精选评论 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误描述 |
| comment | objarray | 评论列表 |
| total | number | 评论总数 |
# Res.comment(Array) Object Payload
评论列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| user_comment_id | number | 用户评论id |
| create_time | number | 评论时间 |
| content | string | 评论内容 |
| comment_type | number | 是否精选评论，0为即非精选，1为true，即精选 |
| openid | string | openid，用户如果用非微信身份评论，不返回openid |
| reply | object | 回复信息 |
# Res.comment(Array).reply Object Payload
回复信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| content | string | 回复内容 |
| create_time | number | 回复时间 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"msg_data_id" : MSG_DATA_ID,
"index" : 0,
"begin": 0,
"count": 40,
"type" : 0
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"total": TOTAL,
"comment": [{
"user_comment_id" : USER_COMMENT_ID,
"openid": OPENID //openid，用户如果用非微信身份评论，不返回openid
"create_time": CREATE_TIME,
"content": CONTENT,
"comment_type": IS_ELECTED,
"reply": {
"content": CONTENT,
"create_time" : CREATE_TIME
}
}]
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙，此时请开发者稍候再试 |
| 40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口 |
| 45009 | reach max api daily quota limit | 调用超过天级别频率限制。可调用clear_quota接口恢复调用额度。 |
| 88000 | without comment privilege | |
| 88010 | count range error. cout <= 0 or count > 50 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况：
| 公众号 | 服务号 |
|---|---|
| 仅认证 | 仅认证 |
- 仅认证：表示仅允许企业主体已认证账号调用，未认证或不支持认证的账号无法调用
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口；