设置高管模式
POST
/v1.0/contact/seniorSettings最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口设置员工的高管模式。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 维护通讯录的接口访问权限 | API Explorer |
第三方企业应用 | 暂不支持 | 维护通讯录的接口访问权限 | 暂不支持 |
第三方个人应用 | 暂不支持 | 维护通讯录的接口访问权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | parameter.error | 参数错误 | 参数错误 |
500 | system.error | 获取设置出错 | 获取设置出错 |
500 | parameter.orgNotExists | 组织不存在 | 组织不存在 |
500 | parameter.userNotExists | 用户不存在 | 用户不存在 |
请求参数
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
seniorStaffId
string
必需
需要设置的员工userid。
open
boolean
必需
是否开启高管模式,取值:
permitStaffIds
array[string]
可选
高管白名单员工userid列表。
参数permitStaffIds、permitDeptIds、permitTagIds列表内元素之和最大为200。
permitDeptIds
array[integer]
可选
高管白名单部门列表。
参数permitStaffIds、permitDeptIds、permitTagIds列表内元素之和最大为200。
permitTagIds
array[integer]
可选
高管白名单角色列表。
参数permitStaffIds、permitDeptIds、permitTagIds列表内元素之和最大为200。
protectScenes
array[string]
可选
高管拦截场景,取值:
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
object {0}
示例
{}
最后修改时间: 2 年前