获取单个部门详情

GET

https://qyapi.weixin.qq.com/cgi-bin/department/get

企业通讯录安全特别重要，企业微信将持续升级加固通讯录接口的安全机制，以下是关键的变更点：

**【重要】**从2022年8月15日10点开始，“企业管理后台 - 管理工具 - 通讯录同步”的新增IP将不能再调用此接口，企业可通过「获取部门ID列表」接口获取部门ID列表。查看调整详情。

权限说明：

应用类型	权限说明
第三方普通应用	若企业授权了组织架构信息权限，可获取企业所有部门ID、部门负责人、父部门ID; 若未授权组织架构信息权限，只能拉取token对应的应用的可见范围内部门详情
第三方通讯录应用	可获取企业所有部门详情，部门名字除外
代开发自建应用	只能拉取token对应的应用的权限范围内的部门详情
普通自建应用	只能拉取token对应的应用的权限范围内的部门详情
通讯录同步助手	可获取企业所有部门详情

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/department/get'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "department": {
        "id": 2,
        "name": "广州研发中心",
        "name_en": "RDGZ",
        "department_leader": [
            "zhangsan",
            "lisi"
        ],
        "parentid": 1,
        "order": 10
    }
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

string

部门id。

可选

示例值:

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

department

object

部门详情。

必需

integer

部门id

必需

name

string

必需

部门名称，代开发自建应用需要管理员授权才返回；第三方不可获取，需要通过通讯录展示组件来展示部门名称

name_en

string

必需

部门英文名称，代开发自建应用需要管理员授权才返回；第三方不可获取，需要通过通讯录展示组件来展示部门名称

department_leader

array[string]

必需

部门负责人的UserID，返回在应用可见范围内的部门负责人列表；第三方仅通讯录应用或者授权了“组织架构信息-应用可获取企业的部门组织架构信息-部门负责人”的第三方应用可获取

parentid

integer

必需

父部门id。根部门为1。

order

integer

必需

在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)

修改于 2022-12-06 06:45:44

获取成员ID列表

创建部门