Skip to content

接口

业务平台


gm_account/station/meta_info meta_info

接口描述: 返回可见的站点和角色

请求方法: GET

请求参数: 
        stations            O       bool           查看可见站点(0 或 1)
        roles               O       bool           查看角色(0 或 1)
        station_permissions      O       bool           查看权限(0 或 1)
        station_id          O       str            管理员可以查看某个站点的权限           

响应: {
        role: [
            {
                id(不变)
                name(不变)
            }
        。。。
        ]
        stations: [
            {
                id              M           str             站点id
                name            M           str             站点名称
            }
        。。。
        ]
        station_permissions:[
            {
                id              M           id             一级权限id
                name            M           str             一级权限名称
                content         M           list(dict)[ 
                                                            id              M           id             二级权限id
                                                            name            M           str             二级权限名称
                                                            permissions     M           list(dict) [    
                                                                                                        id    M   id  权限id
                                                                                                        name  M   str 权限名称
                                                                                                    ]
                                                        ]
            }
        ]
}

示例:
    request
    https://manage.guanmai.cn/gm_account/station/meta_info

    response
            {
            "code": 0,
            "data": {stations: [ // 登录的加盟商管理员 对应的加盟商 旗下的所有站点
                        {
                            id:     123
                            name:   T123
                        }
                    ],
                    roles: [
                        {
                            id:     123
                            name:   角色1
                            type:   2
                            visible_station_id:   "T123"
                        }
                    ],
                    station_permissions: [
                        {
                            "id": 1,                        // level 1 id
                            "name": "AAA",                  // level 1 name
                            "content": [
                                {
                                    "id": 4,                // level 2 id
                                    "name": "BBB",          // level 2 name
                                    "permissions": [
                                        {
                                            "id": 4,        // permission id
                                            "name": "CCC",  // permission name
                                        },
                                    ]
                                },
                            ]
                        },
                    ]}
            "msg": "ok"
        }



逻辑:
    过滤了可见站点,用户只能看见小于或者等于自己的站点

gm_account/station/role/search 查看角色

接口描述: 查看和本身可见站点相同或者更小的角色

请求方法: GET

请求参数: 
        station_id         O       str         站点名字(不传代表全部)
        search_text         O       str         角色名字


响应: 
    roles               M           list(dict) [{
                                                    id                      M           int             角色id
                                                    name                    M           str             角色名称
                                                    description             O           str             角色描述
                                                    create_date             M           date            创建日期
                                                    station_name             M           str            站点名称
                                                    }
                                                。。。
                                                ]

示例
    request
        https://manage.guanmai.cn/gm_account/station/role/search
    response
        {
            "code": 0,
            "data": {
                "roles": [
                    {
                        "create_date": null,
                        "name": "saas测试站点",
                        "id": 124,
                        "type": 2,
                        "visible_station_id": "T123",
                        "description": "1"
                    },
                    {
                        "create_date": "2018-01-05",
                        "name": "好人",
                        "type": 1,
                        "visible_station_id": "",
                        "id": 932,
                        "description": "我是好人"
                    }
                ]
            },
            "msg": "ok"
        }

逻辑:
    搜索角色名、站点返回搜索角色或者该用户可见的角色

gm_account/station/role/permission/search 查看权限

接口描述: 查看的范围修改为当前账号的所有权限和权限信息

请求方法: GET

请求参数: 
        level_1_id      int         O       一级权限的id,不传代表全部一级权限
        level_2_id      int         O       二级,同上
        search_text     string      O       要搜索的权限名,不传代表全部

响应: 
        permissions           M       list(dict)  [
                                        {
                                            id              M       int           权限id  
                                            name            M       str           权限名称
                                            role_names           M       list(str)  角色名称
                                            user_count      M       int            拥有权限的用户数
                                            role_count      M       int            拥有权限的角色数
                                            level_1_name      M       str            一级权限名称
                                            level_2_name      M       str            二级权限名称
                                        }
                                    ]
示例:
    request
        https://manage.guanmai.cn/gm_account/station/role/permission/search

    response
        {
            "code": 0,
            "data": {
                "permissions": [
                    {
                        "id": 1,
                        "name": "增加权限",
                        role_names": [  // role_names 最多有 11 条数据
                            "经理1",
                            "经理2",
                            "经理3",
                            "经理4",
                            "经理5",
                            "经理6",
                            "经理7",
                            "经理8",
                            "经理9",
                            "经理10",
                            "经理11"
                        ],
                        "user_count": 23,
                        "role_count": 49,
                        "level_1_name": "用户权限管理",
                        "level_2_name": "权限"
                    }
                ]
            },
            "msg": "ok"
        }

逻辑:
    查询出该加盟商的所有权限
    查询登录用户的可见站点、统计并过滤单条权限对应的用户数和角色

    返回所有权限和对应的信息

    特殊:
        1. user_count 和 role_count 只统计登录用户(MA管理员)所在加盟商下面的且小于等于该用户可见站点的
        2. user_count 只统计「有效」的用户,不统计「无效」的用户

gm_account/station/user/search 查看用户

接口描述: 查看和本身可见站点相同或者更小的用户

请求方法: GET

请求参数: 
        is_valid    O   bool
        station_id     O   str
        partner_id     O   int
        role_id     O   int
        search_text O   str 用户名
        is_admin    O   bool (0 或 1)    是否是管理员
        // 分页
        offset      O   int 默认 0
        limit       O   int 默认 20

响应: 
    users           M       list(dict)  [
                                            {
                                                id              M       int           用户id  
                                                username        M       str           用户名
                                                is_admin        M       bool          是否为管理员
                                                station_name        M       str          站点名称
                                                name            M       str           姓名
                                                create_date     M       str or null   创建日期
                                                is_valid        M       bool          是否有效
                                                roles           M       list({
                                                                                id      角色id
                                                                                name    角色名
                                                                            })
                                            }
                                        ]

示例
    request
        https://manage.guanmai.cn/gm_account/station/user/search
    response
        {
            data: {
                users: [
                    {
                        id: 123
                        username:用户1
                        roles: [
                            {
                                id: 123,
                                name: '角色名'
                            }
                        ],
                        is_admin:1
                        station_name:T123
                        name:用户
                        create_date:2019-08-08
                        is_valid:1
                    }
                ]
            },
            msg: 'OK',
            code: 0,
        }

逻辑
    - request 里不传的字段代表全部