获取部门详情
POST
/topapi/v2/department/get说明
调用本接口根据部门ID获取指定部门详情。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
部门ID,根部门ID为1。
通讯录语言:zh_CN(默认):中文en_US:英文
{
"language": "zh_CN",
"dept_id": 100
}
示例代码
返回响应
部门标识字段。第三方企业应用不返回该参数。
是否同步创建一个关联此部门的企业群:true:创建false:不创建
当部门群已经创建后,是否有新人加入部门会自动加入该群:true:自动加入群false:不会自动加入群
是否默认同意加入该部门的申请:true:表示加入该部门的申请将默认同意false:表示加入该部门的申请需要有权限的管理员同意
部门是否来自关联组织:true:是false:不是第三方企业应用不返回该参数。
教育部门标签:campus:校区period:学段grade:年级class:班级第三方企业应用不返回该参数。
在父部门中的次序值。
部门群是否包含子部门:true:包含false:不包含
是否限制本部门成员查看通讯录:true:开启限制。开启后本部门成员只能看到限定范围内的通讯录false:不限制
当限制部门成员的通讯录查看范围时(即outer_dept为true时),配置的部门员工可见部门列表。
当限制部门成员的通讯录查看范围时(即outer_dept为true时),配置的部门员工可见员工列表。
是否隐藏本部门:true:隐藏部门,隐藏后本部门将不会显示在公司通讯录中false:显示部门
当隐藏本部门时(即hide_dept为true时),配置的允许在通讯录中查看本部门的员工列表。
当隐藏本部门时(即hide_dept为true时),配置的允许在通讯录中查看本部门的部门列表。
{
"request_id": "string",
"errcode": 0,
"errmsg": "string",
"result": {
"dept_id": 0,
"name": "string",
"parent_id": 0,
"source_identifier": "string",
"create_dept_group": true,
"auto_add_user": true,
"auto_approve_apply": true,
"from_union_org": true,
"tags": "string",
"order": 0,
"dept_group_chat_id": "string",
"group_contain_sub_dept": true,
"org_dept_owner": "string",
"dept_manager_userid_list": [
"string"
],
"outer_dept": true,
"outer_permit_depts": [
0
],
"outer_permit_users": [
"string"
],
"hide_dept": true,
"user_permits": [
"string"
],
"dept_permits": [
0
]
}
}