Asp.net【企业微信开发】部门管理（四）获取部门列表

范范

通讯录同步相关接口，可以对部门、成员、标签等通讯录信息进行查询、添加、修改、删除等操作。本次我们主要说下通讯录管理中的部门管理， 主要从一下几个接口说明：

1. 创建部门
2. 更新部门
3. 删除部门
4. 获取部门列表


获取部门列表

---

请求方式：GET（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=ACCESS_TOKEN&id=ID



请求参数说明：

[C#] 纯文本查看 复制代码

参数                       必须        说明
1. access_token        是        调用接口凭证
2. id                        否        部门id。获取指定部门及其下的子部门（以及及子部门的子部门等等，递归）。 如果不填，默认获取全量组织架构

请求返回结果实例：

[C#] 纯文本查看 复制代码

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

返回结果参数说明：

[C#] 纯文本查看 复制代码

    参数             说明
1. errcode        返回码
2. errmsg         对返回码的文本描述内容
3. department   部门列表数据。
4. id                创建的部门id
5. name           部门名称，代开发自建应用需要管理员授权才返回；此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回name，返回的name字段使用id代替，后续第三方仅通讯录应用可获取，未返回名称的情况需要通过通讯录展示组件来展示部门名称
6. name_en      英文名称，此字段从2019年12月30日起，对新创建第三方应用不再返回，2020年6月30日起，对所有历史第三方应用不再返回该字段
7. parentid        父部门id。根部门为1
8. order            在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)

---

权限说明：

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