角色管理

添加角色

此接口用于 添加 角色

接口地址

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

Header说明

	实例
Method	get

接口参数

字段	类型	是否必填	示例值	说明
name	String	是	主管	角色名称(最长30个字符)
role_grade	Integer	否	1	角色等级（1:主管,2：组长,3：员工）

结果编码说明

code	说明
200	ok
404	角色已经存在
405	角色等级有误（只能1,2,3）
406	角色名称不能含有特殊字符
407	角色名称最长不能超过30个字符

结果示例

{
  "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	Integer	是	123	角色ID
name	String	是	主管	角色名称
role_grade	Integer	否	1	角色等级（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	Integer	是	123	角色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	Integer	是	123	角色ID

结果编码说明

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

结果示例

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