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

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

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

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

参数说明 :

参数必须说明
access_token调用接口凭证
id部门id。

权限说明:

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

 

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "department":
       {
           "id": 2,
           "name": "广州研发中心",
		   "name_en": "RDGZ",
		   "department_leader":["zhangsan","lisi"],
           "parentid": 1,
           "order": 10
       }
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
department部门详情。
id部门id
name部门名称,代开发自建应用需要管理员授权才返回;第三方不可获取,需要通过通讯录展示组件来展示部门名称
name_en部门英文名称,代开发自建应用需要管理员授权才返回;第三方不可获取,需要通过通讯录展示组件来展示部门名称
department_leader部门负责人的UserID,返回在应用可见范围内的部门负责人列表;第三方仅通讯录应用或者授权了“组织架构信息-应用可获取企业的部门组织架构信息-部门负责人”的第三方应用可获取
parentid父部门id。根部门为1。
order在父部门中的次序值。order值大的排序靠前。值范围是[0, 2^32)
上一篇
获取子部门ID列表
下一篇
创建标签