获取小组[树结构列表]

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

header 可选参数:

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

body 参数:

参数名类型是否必传说明
groupSizeNumberNO每条树结构输出多少个小组(默认 30 条)
pageSizeNumberNO每页显示父级树条数(默认 30 条)
pageNumberNO页码(默认 1)

返回结果:

成功

{
    "code": 0,
    "message": "ok",
    "data": {
        "pagination": {
            "total": "一共有多少条数据",
            "current": "当前页码",
            "pageSize": "每页有多少条数据",
            "lastPage": "最后一页页码"
        },
        "list": [
            {
                // 分类列表
                "gid": "groups > uuid",
                "gname": "groups > name 多语言",
                "description": "groups > description 多语言",
                "cover": "groups > cover_file_url",
                "banner": "groups > banner_file_url",
                "groupCount": "实时计算该父级下面可以显示的小组有多少个",
                "groups": [
                    // 小组列表
                    {
                        "gid": "groups > uuid",
                        "gname": "groups > name 多语言",
                        "type": "groups > type",
                        "description": "groups > description 多语言",
                        "cover": "groups > cover_file_url",
                        "banner": "groups > banner_file_url",
                        "recommend": "groups > is_recommend",
                        "mode": "groups > type_mode",
                        "find": "groups > type_find",
                        "followSetting": "配置表键名 follow_group_setting 布尔型",
                        "followName": "配置表键名 follow_group_name 多语言",
                        "followStatus": "查询 member_follows 表。输出 0.未关注 1.已关注",
                        "followType": "groups > type_follow",
                        "followUrl": "groups > plugin_unikey 如果 type_follow=2 则生成插件 URL",
                        "likeSetting": "配置表键名 like_group_setting 布尔型",
                        "likeName": "配置表键名 like_group_name 多语言",
                        "likeStatus": "查询 member_likes 表。输出 0.未点赞 1.已点赞",
                        "shieldSetting": "配置表键名 shield_group_setting 布尔型",
                        "shieldName": "配置表键名 shield_group_name 多语言",
                        "shieldStatus": "查询 member_shields 表。输出 0.未屏蔽 1.已屏蔽",
                        "groupName": "配置表键名 group_name 多语言",
                        "viewCount": "groups > view_count",
                        "likeCount": "groups > like_count",
                        "followCount": "groups > follow_count",
                        "shieldCount": "groups > shield_count",
                        "postCount": "groups > post_count",
                        "essenceCount": "groups > essence_count",
                        "admins": [
                            //groups > permission > admin.members 小组管理员列表
                            {
                                "mid": "members > uuid",
                                "mname": "members > name",
                                "nickname": "members > nickname",
                                "nicknameColor": "主角色的值 member_roles > nickname_color",
                                "avatar": "members > avatar_file_url",
                            }
                        ],
                        "publishRule": {
                            "allowPost": "groups > permission > publish.post 和 publish.post.roles 当前请求接口的成员,是否拥有该小组发表帖子权限",
                            "reviewPost": "groups > permission > publish.post.review 当前请求接口的成员,发帖是否需要审核(如果是管理员,无需审核)",
                            "allowComment": "groups > permission > publish.post 和 publish.post.roles 当前请求接口的成员,是否拥有该小组发表评论权限",
                            "reviewComment": "groups > permission > publish.comment.review 当前请求接口的成员,评论是否需要审核(如果是管理员,无需审核)"
                        },
                        "permission": {
                            // groups 表 permission 字段其他内容
                            // 删除输出 admin.members、publish.post、publish.post.review、publish.post、publish.comment.review 这几个参数,因为上面已经使用。
                            "权限名称": "值",
                            "权限名称": [
                                "值"
                            ],
                            "权限名称": "值"
                        }
                    }
                ]
            }
        ]
    }
}
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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

失败

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

开发说明

  • 小组数据表 type_find=2 只有当前请求的用户已经 follow 了该小组才输出,否则不输出在列表中。
  • 父级和小组分别输出 30 条。
  • 根据 groups > rank_num 升序排序输出列表结果。
  • 所有涉及图片的参数,需要判断是否开启了防盗链,如果开启了,不能直接使用 URL 字段值,需要获取防盗链链接。