获取评论[列表]

• 接口地址：/api/v2/comment/list
• 请求方式：GET
• 传参方式：Query

Headers 可选参数

参数名	公开模式（是否必传）	私有模式（是否必传）
X-Fresns-Aid	NO	YES
X-Fresns-Aid-Token	NO	YES
X-Fresns-Uid	NO	YES
X-Fresns-Uid-Token	NO	YES

Query 参数

参数名	类型	是否必传	说明
mapId	Number	NO	地图服务商编号
mapLng	String	NO	地图经度（用于计算距离）
mapLat	String	NO	地图纬度（用于计算距离）
uidOrUsername	Number / String	NO	指定范围：用户
pid	String	NO	指定范围：帖子
cid	String	NO	指定范围：评论（获取该评论的子孙级评论）
hid	String	NO	指定范围：话题
gid	String	NO	指定范围：小组
includeSubgroups	Boolean	NO	与 gid 配置使用，是否包含子级小组的内容 默认为 false
sticky	Boolean	NO	是否置顶（留空输出全部）
allDigest	Boolean	NO	指定范围：全部精华，一级精华和二级精华 传参后，将忽略 digestState 参数
digestState	Number	NO	指定范围：精华（留空输出全部） digest_state 字段 1.否 2.一级精华 3.二级精华
contentType	String	NO	内容类型（内容类型扩展配置的参数）
createdDays	Number	NO	发表天数：指定天数内创建的内容
createdDate	String	NO	发表日期：today,yesterday,week,lastWeek,month,lastMonth,year,lastYear
createdDateGt	String	NO	发表时间大于 Y-m-d
createdDateLt	String	NO	发表时间小于 Y-m-d
viewCountGt	Number	NO	查看数大于
viewCountLt	Number	NO	查看数小于
likeCountGt	Number	NO	点赞数大于
likeCountLt	Number	NO	点赞数小于
dislikeCountGt	Number	NO	点踩数大于
dislikeCountLt	Number	NO	点踩数小于
followCountGt	Number	NO	关注数大于
followCountLt	Number	NO	关注数小于
blockCountGt	Number	NO	屏蔽数大于
blockCountLt	Number	NO	屏蔽数小于
commentCountGt	Number	NO	子级评论总数大于
commentCountLt	Number	NO	子级评论总数小于
orderType	String	NO	排序类型 createdTime,commentTime,random,view,like,dislike,follow,block,comment 默认 createdTime
orderDirection	String	NO	排序方向，默认 desc asc,desc
whitelistKeys	String	NO	白名单键名，只返回给定键名的键值对 多个以英文逗号隔开，支持「点表示法」表示多维数组
blacklistKeys	String	NO	黑名单键名，从返回数据中删除指定的键值对 多个以英文逗号隔开，支持「点表示法」表示多维数组
pageSize	Number	NO	每页显示条数（默认 15 条）
page	Number	NO	页码（默认 1）

接口使用说明

• uidOrUsername 参数值代表获取指定用户的评论，根据 运营 > 互动配置 > 查看别人内容设置 决定是否输出。
  • it_comments 配置，是否输出点赞我的用户
• 如果 uidOrUsername 为登录用户自己时，上方配置无效，直接输出数据，表示查看自己的内容时无视开关。

contentType 参数（大驼峰格式）	说明
	输出全部内容
All	输出全部内容
Text	输出纯文本评论
Image	输出带图片的评论
Video	输出带视频的评论
Audio	输出带音频的评论
Document	输出带文档的评论
	输出含有插件 fskey 为 AbcName 扩展内容的评论

• 内容类型列表参考 /api/v2/global/{type}/content-types

返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "Number / 一共有多少条数据",
            "pageSize": "Number / 每页有多少条数据",
            "currentPage": "Number / 当前页码",
            "lastPage": "Number / 最后一页页码"
        },
        "list": [
            {
                // 通用数据结构->评论信息
            }
        ]
    }
}