第三方应用开发 服务端API 通讯录管理 部门管理 获取部门列表
获取部门列表
最后更新:2022/08/05
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取部门列表
最后更新:2022/08/05

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

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

 

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

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

参数说明 :

参数必须说明
access_token调用接口凭证
id部门id。获取指定部门及其下的子部门(以及子部门的子部门等等,递归)。 如果不填,默认获取全量组织架构

权限说明:

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

 

返回结果:

{
   "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
       }
   ]
}

参数说明:

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