获取部门列表

GET

/cgi-bin/department/list

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

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

由于该接口性能较低，建议换用获取子部门ID列表与获取单个部门详情。

权限说明：

只能拉取token对应的应用的权限范围内的部门列表

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=&id={{id}}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "department": [
        {
            "id": 2,
            "name": "广州研发中心",
            "name_en": "RDGZ",
            "department_leader": [
                "zhangsan",
                "lisi"
            ],
            "parentid": 1,
            "order": 10
        },
        {
            "id": 3,
            "name": "邮箱产品部",
            "name_en": "mail",
            "department_leader": [
                "lisi",
                "wangwu"
            ],
            "parentid": 2,
            "order": 40
        }
    ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

必需

部门id。获取指定部门及其下的子部门（以及及子部门的子部门等等，递归）。如果不填，默认获取全量组织架构

示例值:

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

department

array [object {5}]

部门列表数据。

可选

integer

创建的部门id

必需

name

string

必需

部门名称，代开发自建应用需要管理员授权才返回；此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回name，返回的name字段使用id代替，后续第三方仅通讯录应用可获取，未返回名称的情况需要通过通讯录展示组件来展示部门名称

name_en

string

必需

英文名称，此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回该字段

parentid

integer

必需

父部门id。根部门为1

order

integer

必需

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

修改于 2022-12-06 06:43:14

删除部门

获取子部门ID列表