Skip to content

获取帖子[列表] 时间线

  • 接口地址:/api/fresns/v1/post/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筛选过滤内容类型
sincePidStringNO查询该帖子之后的新内容
beforePidStringNO查询该帖子之前的旧内容
mapIdNumberNO地图服务商编号
mapLngStringNO地图经度(用于计算距离)
mapLatStringNO地图纬度(用于计算距离)
filterTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
filterKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterGroupTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 group 参数有效
filterGroupKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterHashtagTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 hashtags 参数有效
filterHashtagKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterGeotagTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 geotag 参数有效
filterGeotagKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterAuthorTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 author 参数有效
filterAuthorKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterQuotedPostTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 quotedPost 参数有效
filterQuotedPostKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterPreviewLikeUserTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 previewLikeUsers 参数有效
filterPreviewLikeUserKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
filterPreviewCommentTypeStringNOwhitelist 只返回给定键名的键值对
blacklist 从返回数据中删除指定的键值对
仅对返回结果中 previewComments 参数有效
filterPreviewCommentKeysStringNO多个以英文逗号隔开,支持「点表示法」表示多维数组
pageSizeNumberNO每页显示条数(默认 15 条)
pageNumberNO页码(默认 1)

接口使用说明

  • type 参数用于指定输出我关注对象的帖子列表,以时间线为基础,用户自己发表的帖子也包括在 user 时间线当中。
  • type 留空
    • 我自己发表的帖子。
    • 我关注的用户,他发表的帖子都输出(但不包括私有小组内的帖子)。
    • 我关注的小组、话题、地理,被设置为精华的帖子才输出。
    • 全站二级精华无论我是否关注了发帖者,都输出(但不包括私有小组内的帖子)。
    • 过滤掉我屏蔽的用户、小组、话题、地理、帖子。
  • type=user
    • 我自己发表的帖子。
    • 我关注的用户,他发表的帖子都输出(但不包括私有小组内的帖子)。
    • 过滤掉我屏蔽的帖子。
  • type=group
    • 我关注的小组下的帖子全部输出,不分是否为精华。
    • 过滤掉我屏蔽的用户、话题、帖子。
  • type=hashtaggroup 逻辑一样
  • type=geotaggroup 逻辑一样

返回结果

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