获取部门列表

GET

http://127.0.0.1/cgi-bin/department/list

智慧硬件开发/通讯录管理/部门管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

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

文档ID: 10093
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90208
https://open.work.weixin.qq.com/api/doc/90001/90143/90344
https://open.work.weixin.qq.com/api/doc/90002/90151/90827

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

string

必需

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

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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)

示例

{
  "errcode": 0,
  "errmsg": "string",
  "department": [
    {
      "id": 0,
      "name": "string",
      "name_en": "string",
      "parentid": 0,
      "order": 0
    }
  ]
}

删除部门

创建标签