苏飞论坛

标题: Asp.net【企业微信开发】部门管理（四）获取部门列表 [打印本页]
作者: 范范    时间: 2021-9-7 11:51
标题: 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对应的应用的权限范围内的部门列表






欢迎光临 苏飞论坛 (http://www.sufeinet.com/) Powered by Discuz! X3.4