1. 应用或角色授权
针对应用或角色的授权
1.1. 新增授权
接口地址
https://www.fdccloud.com/api/tenant-open/add-app-auth?access_token=ACCESS_TOKEN
请求方式
POST
请求参数
{
"role_code":"3023",
"user_ids":"1,2,3",
"dept_ids":"a,b,c",
"touser_value_type":"user_code",
"party_id":"1"
}
参数说明
参数 | 必须 | 说明 |
---|---|---|
role_code | 是 | 应用code 或角色code |
user_ids | 是 | 用户id,p_user表的id,多个用逗号分隔 |
dept_ids | 是 | 部门id,多个用逗号分隔 |
party_id | 否 | 通讯录组织id,如果是企业通讯录可以填空,如"party_id":"" |
touser_value_type | 否 | 非必填,默认当做'user_id' 1、当'touser_value_type'='user_code'时,表示上面的字段'user_ids'使用user_code进行授权(适用于第三方用户体系与云助手一致,user_code相同,无需做用户打通) |
返回结果
成功:
{
"errcode": "0",//0代表成功
"errmsg":"ok",
"data":""
}
失败:
{
"errcode": "-110",
"errmsg":"部分用户或者部门不存在,user_id:1,2,3,dept_id:a,b,c",
"data":{
“user_id”:[1,2],
“dept_id”:[a,b]
}
}
参数说明
参数 | 说明 |
---|---|
errcode | 非0代表错误对应的状态码,-110:部分用户或者部门不存在 |
user_id | 当errcode为-110时此数据为不存在的user_id和dept_id |
dept_id | 当errcode为-110时此数据为不存在的user_id和dept_id |
1.2. 删除授权
接口地址
https://www.fdccloud.com/api/tenant-open/delete-app-auth?access_token=ACCESS_TOKEN
请求方式
POST
请求参数(json)
{
"role_code":"3023",
"user_ids":"1,2,3",
"dept_ids":"a,b,c",
"touser_value_type":"user_code",
"party_id":"1"
}
参数说明
参数 | 必须 | 说明 |
---|---|---|
role_code | 是 | 应用code 或角色code |
user_ids | 是 | 用户id,p_user表的id,多个用逗号分隔 |
dept_ids | 是 | 部门id,多个用逗号分隔 |
party_id | 否 | 通讯录组织id,如果是企业通讯录可以填空,如"party_id":"" |
touser_value_type | 否 | 非必填,默认当做'user_id' 1、当'touser_value_type'='user_code'时,表示上面的字段'user_ids'使用user_code进行授权(适用于第三方用户体系与云助手一致,user_code相同,无需做用户打通) |
返回结果
成功:
{
"errcode": "0",//0代表成功
"errmsg":"ok",
"data":""
}
失败:
{
"errcode":"-1",//非0代表异常
"errmsg": "错误信息",
"data":""
}