Skip to content

获取评论[列表] 时间线

  • 接口地址:/api/fresns/v1/comment/timelines
  • 请求方式:GET
  • 传参方式:Query

Headers 可选参数

参数名公开模式(是否必传)私有模式(是否必传)
X-Fresns-AidYESYES
X-Fresns-Aid-TokenYESYES
X-Fresns-UidYESYES
X-Fresns-Uid-TokenYESYES

Query 参数

参数名类型是否必传说明
typeStringNOuser, group, hashtag, geotag
留空则使用全部
langTagStringNO指定范围:语言标签
contentTypeStringNO筛选过滤内容类型
sinceCidStringNO查询该评论之后的新内容
beforeCidStringNO查询该评论之前的旧内容
mapIdNumberNO地图服务商编号
mapLngStringNO地图经度(用于计算距离)
mapLatStringNO地图纬度(用于计算距离)
filterTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
filterKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterHashtagTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 hashtags 参数有效
filterHashtagKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterGeotagTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 geotag 参数有效
filterGeotagKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterAuthorTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 author 参数有效
filterAuthorKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterPreviewLikeUserTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 previewLikeUsers 参数有效
filterPreviewLikeUserKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterPreviewCommentTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 previewComments 参数有效
filterPreviewCommentKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterReplyToPostTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 replyToPost 参数有效
filterReplyToPostKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterReplyToCommentTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 replyToComment 参数有效
filterReplyToCommentKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
pageSizeNumberNO每页显示条数(默认 15 条)
pageNumberNO页码(默认 1)

接口使用说明

返回结果

json
{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "Number / 一共有多少条数据",
            "pageSize": "Number / 每页有多少条数据",
            "currentPage": "Number / 当前页码",
            "lastPage": "Number / 最后一页页码"
        },
        "list": [
            {
                // 通用数据结构->评论信息
                "contentSource": "String / 表示来自哪种关注 null, user, group, hashtag, geotag, digest"
            }
        ]
    }
}

Released under the Apache-2.0 License