获取部门列表

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

参数说明 :

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

权限说明:

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

返回结果:

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

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
department 部门列表数据。
id 创建的部门id
name 部门名称,此字段从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回,后续第三方仅通讯录应用可获取,第三方页面需要通过通讯录展示组件来展示部门名称
name_en 英文名称
parentid 父部门id。根部门为1
order 在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)
© 1998 - 2020 Tencent Inc. All Rights Reserved