获取子部门ID列表

GET

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

权限说明：

应用类型	权限说明
第三方普通应用	若企业授权了“组织架构信息”权限，可获取企业所有部门id; 若未授权“组织架构信息”权限，只能拉取token对应的应用的权限范围内的部门列表
第三方通讯录应用	可获取企业所有部门id
代开发自建应用	只能拉取token对应的应用的权限范围内的部门列表
普通自建应用	只能拉取token对应的应用的权限范围内的部门列表
通讯录同步助手	可获取企业所有部门id

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "department_id": [
    {
      "id": 2,
      "parentid": 1,
      "order": 10
    },
    {
      "id": 3,
      "parentid": 2,
      "order": 40
    }
  ]
}

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

string

可选

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

示例值:

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

department_id

array [object {3}]

部门列表数据。

必需

integer

创建的部门id

必需

parentid

integer

必需

父部门id。根部门为1。

order

integer

必需

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

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

获取部门列表

创建标签