获取评论管理列表

拥有此API的权限集
商品管理-查询

请求方式及url

• 请求方式：POST
• 请求头：Content-Type:application/json
• 接口地址：https://api.xiaoe-tech.com/xe.goods.comments.list.get/1.0.0
• 频率限制：10秒500次

接口调试

GETPOSTPUTDELETE

https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/

请求参数

响应结果

暂无响应数据

请求参数

参数名	必选	类型	说明
access_token	是	string	专属token
record_id	否	string	课程或资源ID；不传时查询店铺下的评论
search	否	string	搜索类型：name-用户昵称，title-课程标题，content-评论内容
content	否	string	搜索内容，与search配合使用
state	否	int	筛选状态：0-显示，1-隐藏，2-未精选，3-精选，4-禁言用户，5-屏蔽
source	否	int	评论来源：1-H5，2-PC
order_field	否	string	排序字段；传num时按点赞数排序，不传时按评论时间排序
order_direction	否	string	排序方向：asc-升序，desc-降序，默认值为desc
page	否	int	页码，最小值为1，默认值为1
page_size	否	int	每页数量，最小值为1，默认值为10

请求示例

{
    "access_token": "xe_xxxxx",
    "record_id": "v_xxxxxxxxx",
    "search": "content",
    "content": "课程讲得很好",
    "state": 0,
    "source": 1,
    "order_field": "num",
    "order_direction": "desc",
    "page": 1,
    "page_size": 10
}

返回参数

参数名	类型	说明	备注
code	int	返回码	0-成功，其他为失败
msg	string	返回信息	无
data	object	请求结果	无
data.data	array	评论列表	不返回用户昵称、头像、封禁状态等用户信息
data.data[].id	int	评论ID	无
data.data[].app_id	string	店铺ID	无
data.data[].user_id	string	评论用户ID	无
data.data[].type	int	评论对应的资源类型	0-图文，1-音频，2-视频，3-圈子，20-电子书
data.data[].record_id	string	课程或资源ID	无
data.data[].record_title	string	课程或资源标题	无
data.data[].content	string	评论内容	无
data.data[].comment_state	int	评论状态	0-显示，1-隐藏，3-屏蔽
data.data[].sub_comment_state	int	关联评论状态	0-显示，1-被关联隐藏
data.data[].src_comment_id	int	被回复的评论ID	无被回复评论时为0
data.data[].src_user_id	string	被回复的用户ID	无被回复用户时为空字符串
data.data[].src_content	string	被回复的评论内容	无被回复评论时为空字符串
data.data[].is_admin	int	是否为管理员回复	0-否，1-是
data.data[].admin_name	string	管理员名称	无管理员回复时为空字符串
data.data[].admin_content	string	管理员回复内容	无管理员回复时为空字符串
data.data[].admin_created_at	string	管理员回复时间	格式为YYYY-MM-DD HH:mm:ss；无管理员回复时为空字符串
data.data[].zan_num	int	点赞数	无
data.data[].is_top	int	是否精选	0-未精选，1-精选
data.data[].is_exception	int	是否为异常评论	0-否，1-是
data.data[].exception_category	string	异常分类	非异常评论时为空字符串
data.data[].created_at	string	评论时间	格式为YYYY-MM-DD HH:mm:ss
data.data[].updated_at	string	更新时间	格式为YYYY-MM-DD HH:mm:ss
data.data[].is_read	int	是否已读	0-未读，1-已读
data.total	int	符合条件的评论总数	无
data.current_page	int	当前页码	无
data.per_page	int	每页数量	无
data.last_page	int	总页数	无

返回示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "data": [
            {
                "id": 123456,
                "app_id": "appxxxxxxxxxxxxxx",
                "user_id": "u_xxxxxxxxx",
                "type": 2,
                "record_id": "v_xxxxxxxxx",
                "record_title": "示例视频课程",
                "content": "课程讲得很好",
                "comment_state": 0,
                "sub_comment_state": 0,
                "src_comment_id": 0,
                "src_user_id": "",
                "src_content": "",
                "is_admin": 0,
                "admin_name": "",
                "admin_content": "",
                "admin_created_at": "",
                "zan_num": 5,
                "is_top": 1,
                "is_exception": 0,
                "exception_category": "",
                "created_at": "2026-08-24 10:00:00",
                "updated_at": "2026-08-24 10:00:00",
                "is_read": 0
            }
        ],
        "total": 1,
        "current_page": 1,
        "per_page": 10,
        "last_page": 1
    }
}