设置部门可见性优先级

POST

/v1.0/contact/depts/settings/priorities

调用本接口，设置通讯录部门可见性优先级。

如下图所示，在默认情况下子部门（高管）部门成员对通讯录查看范围虽然与其父部门不同，但是仍会沿用父部门的配置。

如果需要使子部门（高管）单独设置的部门成员对通讯录查看范围生效，可调用本接口将子部门的优先级进行提升。

说明

部门设置的优先级默认为：父部门设置优先于子部门。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	通讯录数据可见范围管理权限	API Explorer
第三方企业应用	暂不支持	通讯录数据可见范围管理权限	暂不支持
第三方个人应用	暂不支持	通讯录数据可见范围管理权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	parameter.error	参数错误	参数错误
500	system.error	更新设置出错	更新设置出错

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dingtalk.com/v1.0/contact/depts/settings/priorities' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "enable" : true
}'

响应示例

{
    "result": true
}

修改于 2024-01-09 02:59:00

删除通讯录隐藏设置

新增或修改限制查看通讯录设置

设置部门可见性优先级

权限#

错误码#

请求参数

返回响应

权限

错误码