获取帖子附近的[列表]

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

header 可选参数:

参数名公开模式(是否必传)私有模式(是否必传)
uidNOYES
midNOYES
tokenNOYES

body 参数:

参数名类型是否必传说明
searchTypeStringNO指定类型:内容类型扩展配置的参数,为空或者为 all,则输出全部内容
searchKeyStringNO搜索关键词(检索附近的帖子)
mapIdNumberYES地图服务商编号
longitudeStringYES地图经度(用于查询附近帖子)
latitudeStringYES地图纬度(用于查询附近帖子)
lengthNumberNO范围,默认值来源配置表 nearby_length 键值
lengthUnitsStringNO范围单位 km / mi
sortNumberNumberNO排序编号(插件专用)
pageSizeNumberNO每页显示条数(默认 30 条)
pageNumberNO页码(默认 1)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "common": {
            "implants": [
                //implants 参数,参考帖子列表接口 /api/fresns/post/lists
            ]
        },
        "pagination": {
            "total": "一共有多少条数据",
            "current": "当前页码",
            "pageSize": "每页有多少条数据",
            "lastPage": "最后一页页码"
        },
        "list": [
            // lists 参数,参考帖子列表接口 /api/fresns/post/lists
        ]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

失败

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

开发说明

  • 如果是私有模式,当过期后 members > expired_at,需判断到期后的状态。配置表 site_private_end 键值为 1 时,该接口不可请求;键值为 2 时,仅输出到期前的内容,到期后的新内容不输出。
  • 根据 searchType 内容类型去 plugin_usages 查询数据来源是默认(主程序)还是指定的插件,如果是指定的插件,则将请求转述给插件,由插件提供数据。
  • latitudelongitude 为中心,length 为范围,将范围内帖子以时间为倒序排列输出。
  • 非公开小组和过滤屏蔽对象的帖子(成员、小组、话题、帖子),数据不输出。
  • 帖子所属小组,小组 groupstype_mode = 2 + type_find = 2 只有当前请求接口的成员已经 follow 了该小组才输出,否则不输出在列表中。
  • 补充资料:帖子列表和详情页逻辑