获取帖子关注的[列表]

  • 接口地址: /api/fresns/post/follows
  • 请求方式: POST
  • 请求格式: JSON

header 可选参数:

参数名公开模式(是否必传)私有模式(是否必传)
uidYESYES
midYESYES
tokenYESYES

body 参数:

参数名类型是否必传说明
searchTypeStringNO指定类型:内容类型扩展配置的参数,为空或者为 all,则输出全部内容
searchKeyStringNO搜索关键词(检索关注对象的帖子)
followTypeStringNO关注对象,留空输出全部
类型 member / group / hashtag
mapIdNumberNO地图服务商编号
longitudeStringNO地图经度(用于计算距离)
latitudeStringNO地图纬度(用于计算距离)
sortNumberNumberNO排序编号(插件专用)
pageSizeNumberNO每页显示条数(默认 30 条)
pageNumberNO页码(默认 1)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "common": {
            "implants": [
                //implants 参数,参考帖子列表接口 /api/fresns/post/lists
            ]
        },
        "pagination": {
            "total": "一共有多少条数据",
            "current": "当前页码",
            "pageSize": "每页有多少条数据",
            "lastPage": "最后一页页码"
        },
        "list": [
            {
                //list 参数参考帖子列表接口 /api/fresns/post/lists
                "followType": "用来标记这条帖子来源 Type,对应接口 body 请求 followType 传参,但不是把传参拿过来,是判断这条帖子是来自我的哪种关注对象",
                "hashtag": {
                    //当上面 data.list.followType = hashtag 时输出以下信息,表明来自哪个话题。
                    "huri": "hashtags > slug",
                    "hname": "hashtags > name",
                    "cover": "hashtags > cover_file_url"
                }
            }
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

失败

{
    "code": "code_messages > code",
    "message": "code_messages > message"
}
1
2
3
4

开发说明

  • 如果是私有模式,当过期后 members > expired_at,需判断到期后的状态。配置表 site_private_end 键值为 1 时,该接口不可请求;键值为 2 时,仅输出到期前的内容,到期后的新内容不输出。
  • 根据 searchType 内容类型去 plugin_usages 查询数据来源是默认(主程序)还是指定的插件,如果是指定的插件,则将请求转述给插件,由插件提供数据。
  • 获取「1.成员 / 2.小组 / 3.话题」这三个对象的帖子。
  • 成员的全部帖子,小组和话题下只输出被加精华的帖子,以发表时间倒序排列。
  • 帖子有重复时,以成员的帖子为主。比如我关注的成员,在小组里帖子被加精华了,这时候会重复,届时以成员身份输出为主。
    • 依次关系为:成员 > 小组 > 话题
    • 小组的内容,如果该发表者成员是我关注的对象,则以成员身份输出内容,小组内容不输出。
    • 话题的内容,如果该话题所属帖子的发表者成员是我关注的对象,则以成员身份输出内容,话题内容不输出。
    • 话题的内容,如果该话题所属帖子的发表者成员不是我关注的对象,但是帖子内容所属小组是我关注的,则以小组身份输出内容,话题内容不输出。
  • followType = 空
    • 我自己发表的帖子。
    • 我关注的成员,他发表的帖子都输出。
    • 我关注的小组,被设置为精华的帖子才输出。
    • 我关注的话题,被设置为精华的帖子才输出。
    • 全站二级精华无论我是否关注了发帖者,都输出。
  • followType = member 我关注的成员,他发表的帖子都输出,加上我自己发表的内容。
  • followType = group 我关注的小组,下面的帖子全部输出,不分是否为精华。
  • followType = hashtag 我关注的话题,下面的帖子全部输出,不分是否为精华。
  • 补充资料:帖子列表和详情页逻辑