获取部门详情

POST

/topapi/v2/department/get

企业内部应用第三方企业应用oapi

调用本接口，根据部门ID获取指定部门详情。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

错误码

错误码（errcode）	错误码描述（errmsg）	解决方案
43007	需要授权	请确认access_token具有操作权限
60003	未找到对应部门	请确认dept_id是否正确
400002	无效的参数	请确认参数是否按要求输入
-1	系统繁忙	请稍后再试

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/v2/department/get?access_token=bE74xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "language": "zh_CN",
    "dept_id": 100
}'

响应示例

200 - 企业内部应用 - 成功示例

{
  "errcode": 0,
  "errmsg": "ok",
  "result": {
    "dept_permits": [
      3,
      4,
      5
    ],
    "outer_permit_users": [
      "user123",
      "1234"
    ],
    "outer_dept": false,
    "group_contain_sub_dept": false,
    "dept_group_chat_id": "chat1fccdb4b921f2bde18c26xxxx",
    "org_dept_owner": "10203029011219896",
    "auto_add_user": false,
    "parent_id": 1,
    "hide_dept": true,
    "name": "HR",
    "outer_permit_depts": [
      500,
      600
    ],
    "user_permits": [],
    "dept_id": 423499470,
    "create_dept_group": false,
    "order": 423499470
  },
  "request_id": "4e7ljtq91rgo"
}

请求参数

Query 参数

access_token

必需

调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。

示例值:

bE74xxxx

Body 参数application/json

dept_id

number

必需

部门ID，根部门ID为1。

language

string

可选

通讯录语言：zh_CN（默认）：中文en_US：英文

示例

返回响应

🟢200企业内部应用

application/json

Body

request_id

string

请求ID。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

result

object

部门详情。

可选

dept_id

number

部门ID。

可选

name

string

部门名称。

可选

parent_id

number

父部门ID。

可选

source_identifier

string

可选

部门标识字段。第三方企业应用不返回该参数。

create_dept_group

boolean

可选

是否同步创建一个关联此部门的企业群：true：创建false：不创建

auto_add_user

boolean

可选

当部门群已经创建后，是否有新人加入部门会自动加入该群：true：自动加入群false：不会自动加入群

auto_approve_apply

boolean

可选

是否默认同意加入该部门的申请：true：表示加入该部门的申请将默认同意false：表示加入该部门的申请需要有权限的管理员同意

from_union_org

boolean

可选

部门是否来自关联组织：true：是false：不是第三方企业应用不返回该参数。

获取部门详情

权限#

错误码#

请求参数

返回响应

权限

错误码