# 查询评论列表
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:getCommenTreplyList
查询某评价下面所有的评论和回复。(目前开发者创建的第一条回复定义为评论,之后的回复都是基于这条评论去做回复的,未来会进行评论回复的展开)
# 1. 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxaapi/comment/replyandcommentreplylist/get?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:151
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| commentId | string | 是 | 评价的 id |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| list | object | 评论(评论回复第一条内容) |
# Res.list Object Payload
评论(评论回复第一条内容)
| 参数名 | 类型 | 说明 |
|---|---|---|
| reply | object | 评论 |
| commentReplyList | objarray | 回复(评论回复第二条及之后的所有集合) |
# Res.list.reply Object Payload
评论
| 参数名 | 类型 | 说明 |
|---|---|---|
| commentId | string | 评价id |
| replyId | string | 评论id |
| createTime | string | 创建时间,单位是秒 |
| updateTime | string | 更新时间,单位是秒 |
| replyContent | object | 回复 |
| replyObject | object | 评论的内容 |
# Res.list.reply.replyContent Object Payload
回复
| 参数名 | 类型 | 说明 |
|---|---|---|
| content | string | 回复的内容 |
# Res.list.reply.replyObject Object Payload
评论的内容
| 参数名 | 类型 | 说明 |
|---|---|---|
| nickname | string | 用户的昵称 |
| imgUrl | string | 用户的头像 |
# Res.list.commentReplyList(Array) Object Payload
回复(评论回复第二条及之后的所有集合)
| 参数名 | 类型 | 说明 |
|---|---|---|
| commentId | string | 评价id |
| commentReplyId | string | 回复id |
| createTime | string | 评价创建时间,单位是秒 |
| updateTime | string | 更新时间,单位是秒 |
| commentReplyContent | object | 回复 |
| commentReplyObject | object | 评论的内容 |
# Res.list.commentReplyList(Array).commentReplyContent Object Payload
回复
| 参数名 | 类型 | 说明 |
|---|---|---|
| content | string | 回复的内容 |
# Res.list.commentReplyList(Array).commentReplyObject Object Payload
评论的内容
| 参数名 | 类型 | 说明 |
|---|---|---|
| nickname | string | 用户的昵称 |
| imgUrl | string | 用户的头像 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
GET https://api.weixin.qq.com/wxaapi/comment/replyandcommentreplylist/get?commentId=123456&access_token=xxxx
返回示例
{
errcode: 0,
list: {
reply: { // 评论(评论回复第一条内容)
commentId: '123',
replyId: '1'
createTime: '1669032337',
updateTime: '1669032341',
replyContent: { content: '999' },
replyObject: {
nickname: '小程序名称',
imgUrl: 'http://xxx/xx'
},
},
commentReplyList: [ // 回复(评论回复第二条及之后的所有集合)
{
commentId: '12345',
commentReplyId: '1'
createTime: '1669032388',
updateTime: '1669032392',
commentReplyContent: { content: 'uuuuuuuuu' },
commentReplyObject: { nickname: '啊哈', imgUrl: 'xxx' },
}
]
}
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| -10403 | 无权限操作该评价/评论/回复 |
| -10008 | 服务异常 |
| -10007 | 无权限调用接口 |
| -10003 | 参数不匹配 |
| -10001 | 参数异常 |
| 10000 | 和解:不是差评/发送过模板消息;其它:参数异常 |
# 7. 适用范围
本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。