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

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

参数说明 :

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

权限说明:

应用类型权限说明
第三方普通应用若企业授权了“组织架构信息”权限,可获取企业所有部门id; 若未授权“组织架构信息”权限,只能拉取token对应的应用的权限范围内的部门列表
第三方通讯录应用可获取企业所有部门id
代开发自建应用若企业授权了“组织架构信息”-“部门及父部门ID、部门负责人”权限,可获取企业所有部门id; 若未授权“组织架构信息”-“部门及父部门ID、部门负责人”权限,只能拉取token对应的应用的权限范围内的部门列表
普通自建应用只能拉取token对应的应用的权限范围内的部门列表
通讯录同步助手可获取企业所有部门id

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "department_id": [
       {
           "id": 2,
           "parentid": 1,
           "order": 10
       },
       {
           "id": 3,
		   "parentid": 2,
           "order": 40
       }
   ]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
department_id部门列表数据。
id创建的部门id
parentid父部门id。根部门为1。
order在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)。
上一篇
获取部门列表
下一篇
获取单个部门详情