应用可见范围接口
设置应用的可见角色范围
使用场景: 设置应用的可见角色范围。
权限说明
权限项 | 说明 | 备注 |
---|---|---|
应用是否需要申请白名单 | 不需要 | |
用户凭证 | 支持 | 需要机构管理员 |
机构凭证 | 不支持 | - |
请求方式: POST(HTTPS)
请求地址: https://jz.hasmartedu.com/oapi/suite/set_app_visibility?access_token=ACCESS_TOKEN
请求包体:
{
"app_id":700259,
"visibility_type":2,
"role_visibility_data":[2,12],
"select_visibility_data":[
{
"is_leaf":true,
"is_parent":false,
"level":8,
"name":"test",
"nodeid":311012
}
]
}
参数说明 :
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
app_id | 是 | 应用id |
visibility_type | 是 | 可见范围类型 1-按角色 2-按组织架构可见范围 3-全员可见 |
role_visibility_data | 否 | 角色id列表,当visibility_type传2时填写 |
select_visibility_data | 否 | 可见范围节点列表,当visibility_type传3时填写 |
select_visibility_data.is_leaf | 是 | 当前节点是否是叶子节点(叶子结点表示当前节点为用户) |
select_visibility_data.is_parent | 是 | 当前节点是否是父节点(父结点表示当前节点为组织架构Id) |
select_visibility_data.level | 否 | 当前节点层级 |
select_visibility_data.name | 是 | 当前节点名称 |
select_visibility_data.nodeid | 是 | 当前节点id(叶子节点该字段表示userid,父节点该字段表示department_id) |
返回结果:
{
"errcode":0,
"errmsg":"ok"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码,0为正常 |
errmsg | 对返回码的文本描述内容 |