角色管理(v3)

如何认证

示例

获取Token
在Header里添加 Authorization: Bearer {ACCESS_TOKEN}

角色列表接口

角色列表接口查询

接口地址

POST https://openapi.icsoc.net/ektv3/v3/wintelapi/role/list

接口参数

传参方式: Content-Type: application/json

参数	类型	说明	必填
page	int	当前页	否
rows	int	当前页大小, 默认100,最大500	否
role_name	string	角色名称	否
role_id	int	角色ID	否

结果编码说明

code	说明
0	ok
其它	具体看message返回信息

示例

请求


curl --location --request POST 'https://openapi.icsoc.net/ektv3/v3/wintelapi/role/list' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YP6iqELNsyhXcVNJfl07ebDiOfDwqENcdlbD2vYP' \
--data-raw '{
    "page":1,
    "rows":10,
    "role_name":"cc"
}'

响应

{
    "code": 0,
    "message": "success",
    "request_id": "iMoZRzE61wJce2id536a0f26wJv6PaZo",
    "data": {
        "current_page": 1,
        "data": [
            {
                "id": 114852,
                "vcc_id": 782,
                "vcc_code": "wuhan",
                "role_id": 114852,
                "role_name": "cc测试",
                "data_priv": {
                    "type": 0,
                    "departments": "",
                    "queues": ""
                },
                "create_user_id": 1026778,
                "create_user_name": "5646|xx",
                "update_user_id": 10586,
                "update_user_name": "8888 | xx",
                "remark": "样本",
                "date_create_time": "2021-06-28 15:01:26",
                "date_update_time": "2023-09-21 13:23:17"
            }
        ],
        "first_page_url": "https://openapi.icsoc.net/ektv3/v3/wintelapi/role/list?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "https://openapi.icsoc.net/ektv3/v3/wintelapi/role/list?page=1",
        "next_page_url": null,
        "path": "https://openapi.icsoc.net/ektv3/v3/wintelapi/role/list",
        "per_page": 10,
        "prev_page_url": null,
        "to": 1,
        "total": 1
    }
}

响应字段说明

参数	说明
id	ID
vcc_id	企业ID
vcc_code	企业代码
role_id	角色ID
role_name	角色名称
data_priv	数据权限
create_user_id	创建人ID
create_user_name	创建人工号姓名
update_user_id	修改人ID
update_user_name	修改人工号姓名
remark	备注
date_create_time	创建时间
date_update_time	更新时间

data_priv说明

参数	说明
type	权限类型,0:不限,1:本部门,2:本部门以及子部门,3:本技能组,4:本部门及本技能组,5:本部门及子部门及本技能组,6:本人,7:自定义
departments	可见部门ID,多个逗号隔开
queues	可见技能组ID,多个逗号隔开 (技能组权限后续会去掉,统一使用部门控制)

角色新增

角色新增接口

接口地址

POST https://openapi.icsoc.net/ektv3/v3/wintelapi/role/add

接口参数

传参方式: Content-Type: application/json

参数	类型	说明	必填
role_name	string	角色名称不能重复	是
remark	string	备注	否
data_priv	object	数据权限	否

data_priv说明

参数	说明
type	权限类型,0:不限,1:本部门,2:本部门以及子部门,3:本技能组,4:本部门及本技能组,5:本部门及子部门及本技能组,6:本人,7:自定义
departments	可见部门ID,多个逗号隔开
queues	可见技能组ID,多个逗号隔开 (技能组权限后续会去掉,统一使用部门控制)

结果编码说明

code	说明
0	ok
其它	具体看message返回信息

示例

请求

curl --location --request POST 'https://openapi.icsoc.net/ektv3/v3/wintelapi/role/add' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 1S3PezP7HM34xJpN9JITugfdCbI4XnygridosnIu' \
--data-raw '{
    "role_name":"testR",
    "remark":"xxx",
    "data_priv":{
        "type":7,
        "departments": "114979,114978,114972"
    }
}'

响应

{
    "code": 0,
    "message": "success",
    "request_id": "fy9uTAJthxofGtN1O0n9JmibEmk1UoCx",
    "data": {
        "role_name": "testR",
        "remark": "xxx",
        "data_priv": {
            "type": 7,
            "departments": "114979,114978,114972"
        },
        "vcc_id": 782,
        "vcc_code": "wuhan",
        "create_user_id": 1024437,
        "create_user_name": "系统-xx",
        "update_user_id": 1024437,
        "update_user_name": "系统-xx",
        "id": 117227
    }
}

角色编辑

角色编辑接口

接口地址

POST https://openapi.icsoc.net/ektv3/v3/wintelapi/role/edit

接口参数

传参方式: Content-Type: application/json

参数	类型	说明	必填
role_id	int	角色ID	是
role_name	string	角色名称不能重复	否
remark	string	备注	否
data_priv	object	数据权限	否

data_priv说明

参数	说明
type	权限类型,0:不限,1:本部门,2:本部门以及子部门,3:本技能组,4:本部门及本技能组,5:本部门及子部门及本技能组,6:本人,7:自定义
departments	可见部门ID,多个逗号隔开
queues	可见技能组ID,多个逗号隔开 (技能组权限后续会去掉,统一使用部门控制)

结果编码说明

code	说明
0	ok
其它	具体看message返回信息

示例

请求


curl --location --request POST 'https://openapi.icsoc.net/ektv3/v3/wintelapi/role/edit' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 1S3PezP7HM34xJpN9JITugfdCbI4XnygridosnIu' \
--data-raw '{
    "role_id":117227,
    "role_name":"testUpdate",
    "remark":"update"
}'

响应

{
    "code": 0,
    "message": "success",
    "request_id": "xrMVQeDzfN2QU1JYJD7i1rqWWPe7haLl",
    "data": {
        "id": 117227,
        "vcc_id": 782,
        "vcc_code": "wuhan",
        "role_id": 117227,
        "role_name": "testUpdate",
        "data_priv": {
            "type": 0,
            "departments": "114979,114978,114972"
        },
        "create_user_id": 1024437,
        "create_user_name": "系统-xx",
        "update_user_id": 1024437,
        "update_user_name": "系统-xx",
        "remark": "update"
    }
}

角色删除

角色删除接口

接口地址

POST https://openapi.icsoc.net/ektv3/v3/wintelapi/role/delete

接口参数

传参方式: Content-Type: application/json

参数	类型	说明	必填
ids	string	角色ID（列表接口返回得role_id）多个逗号隔开	是

结果编码说明

code	说明
0	ok
其它	具体看message返回信息

示例

请求


curl --location --request POST 'https://openapi.icsoc.net/ektv3/v3/wintelapi/role/delete' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YP6iqELNsyhXcVNJfl07ebDiOfDwqENcdlbD2vYP' \
--data-raw '{
    "ids": "117088"
}'

响应

{
    "code": 0,
    "message": "success",
    "request_id": "QPjlLiIQy8uDC5mnDulB81WLnrrDbVoX",
    "data": []
}

如何认证​

示例​

角色列表接口​

接口地址​

接口参数​

结果编码说明​

示例​

请求​

响应​

响应字段说明​

data_priv说明​

角色新增​

接口地址​

接口参数​

data_priv说明​

结果编码说明​

示例​

请求​

响应​

角色编辑​

接口地址​

接口参数​

data_priv说明​

结果编码说明​

示例​

请求​

响应​

角色删除​

接口地址​

接口参数​

结果编码说明​

示例​

请求​

响应​

如何认证

示例

角色列表接口

接口地址

接口参数

结果编码说明

示例

请求

响应

响应字段说明

data_priv说明

角色新增

接口地址

接口参数

data_priv说明

结果编码说明

示例

请求

响应

角色编辑

接口地址

接口参数

data_priv说明

结果编码说明

示例

请求

响应

角色删除

接口地址

接口参数

结果编码说明

示例

请求

响应