角色管理 · 开发者平台

添加角色

此接口用于添加角色

接口地址

GET http://m.icsoc.net/v2/wintelapi/role/add/{name}/{role_grade}

接口参数

参数	说明	备注
name	角色名称	`必需`
role_grade	角色等级（1=》主管，2=》组长，3=》员工）默认是3	可选

结果编码说明

code	说明
200	ok
401	企业代码为空
402	企业代码不存在
403	角色名称为空或非法
404	角色已经存在
405	角色等级有误（只能1,2,3）

结果示例

{"code":200,"message":"ok","data":{"role_id":5,"name":"xx","role_grade":"主管"}}

结果字段说明

字段	说明
role_id	插入的角色ID
name	坐席名称
role_grade	坐席等级

修改角色

此接口用于修改角色

接口地址

POST http://m.icsoc.net/v2/wintelapi/role/edit

接口参数

参数	说明	备注
role_id	角色ID	`必需`
name	角色名称	`必需`
role_grade	角色等级（1=》主管，2=》组长，3=》员工）默认是3	可选

结果编码说明

code	说明
200	ok
401	企业代码为空
402	企业代码不存在
403	角色名称为空或非法
404	角色已经存在
405	角色等级有误（只能1,2,3）
406	角色不属于该企业
407	修改失败（服务器端错误）

结果示例

{"code":200,"message":"ok","data":{"role_id":5,"name":"xx","role_grade":"主管"}}

结果字段说明

字段	说明
role_id	插入的角色ID
name	坐席名称
role_grade	坐席等级

获取所有角色

此接口用于获取角色列表

接口地址

GET http://m.icsoc.net/v2/wintelapi/role/list

接口参数

无

结果编码说明

code	说明
200	ok
401	企业代码为空
402	企业代码不存在
403	角色不属于该企业
404	角色不存在
405	获取失败

结果示例

{
    "code":"200",
    "message":"ok",
    "data":
        [
            {
                "role_id":"5",
                "name":"hello",
                "role_grade":"3",
                "action_list":"gztkhgl,gztwjld,gztwdtx,"
            }
        ]
}

结果字段说明

字段说	明
role_id	角色Id
name	角色名称
role_grade	角色等级
action_list	权限列表，该权限列表为访问后台管理系统的菜单权限

获取指定角色信息

此接口用于获取指定角色信息

接口地址

GET http://m.icsoc.net/v2/wintelapi/role/list/{role_id}

接口参数

参数	说明	备注
role_id	角色ID	`必需`

结果编码说明

code	说明
200	ok
401	企业代码为空
402	企业代码不存在
403	角色不属于该企业
404	角色不存在
405	获取失败

结果示例

{
    "code":"200",
    "message":"ok",
    "data":
        [
            {
                "role_id":"5",
                "name":"hello",
                "role_grade":"3",
                "action_list":"gztkhgl,gztwjld,gztwdtx,"
            }
        ]
}

结果字段说明

字段	说明
role_id	角色Id
name	角色名称
role_grade	角色等级
action_list	权限列表，该权限列表为访问后台管理系统的菜单权限

删除角色

此接口用于删除角色

接口地址

GET http://m.icsoc.net/v2/wintelapi/role/delete/{role_id}

接口参数

参数	说明	备注
role_id	角色ID	`必需`

结果编码说明

code	说明
200	ok
401	企业代码为空
402	企业代码不存在
403	角色不属于该企业
404	删除失败
404	删除失败，该角色有坐席占用

结果示例

{"code":200,"message":"ok"}