钉钉如何获取部门列表?
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在钉钉中,要获取部门列表,你可以使用钉钉的组织架构查询接口。以下是一个基本的使用示例:
首先,你需要登录到钉钉的管理员账户,然后进入到“管理中心”->“组织架构”页面,找到你要查询的公司或团队,然后点击右侧的“展开”按钮。
在展开的组织架构页面中,你会看到所有的部门列表。你可以选择一个部门,然后点击右侧的“详情”按钮。
在部门详情页面上,你会看到部门的所有子部门和员工列表。你可以在这里查看和编辑部门的信息,也可以在这里添加和删除部门。
如果你想要通过代码来获取部门列表,你可以使用钉钉提供的API。以下是一个基本的使用示例:
首先,你需要登录到钉钉的管理员账户,然后进入到“管理中心”->“应用管理”->“我的应用”,找到你要使用的应用,然后点击“详情”按钮。
在应用详情页面上,你会看到一个“开发者模式”的开关,将其打开。
接下来,你需要获取OAuth Token。在“开发者模式”下,你可以看到一个“获取OAuth Token”的链接,点击这个链接,按照提示输入相关的信息,然后提交。提交成功后,你会得到一个OAuth Token。
现在,你可以使用这个OAuth Token来查询部门列表。你可以使用REST API或者SDK来进行查询。这里我们以REST API为例:
URL格式:https://oapi.dingtalk.com/department/list?access_token=ACCESS_TOKEN
其中,"ACCESS_TOKEN"是你刚刚得到的OAuth Token。
将这个URL发送给你的服务器,然后解析返回的结果,就可以得到部门列表。
需要注意的是,这个查询接口有一定的限制,比如每天只能查询一定数量的部门,超过这个限制就会被拒绝。此外,查询结果只返回部门的基本信息,如名称、ID等,具体的员工信息是不返回的。
获取部门列表
https://open.dingtalk.com/document/orgapp/obtain-the-department-list
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
获取企业下所有部门列表
接入流程简介
本文介绍了创建一个企业内部应用,使用通讯录管理提供的部门管理相关API,实现获取企业下所有部门列表。
步骤一:登录开发者后台,点击应用开发-企业内部开发,创建企业内部应用。
步骤二:单击基础信息 > 应用信息,获取应用AppKey和AppSecret。
步骤三:添加接口调用权限。单击“通讯录管理”,申请通讯录接口对应的权限。
步骤四:获取应用访问凭证获取企业内部应用的access_token。调用接口时,通过accessToken鉴权调用者身份。
步骤五:调用通讯录相关API:
调用服务端API-获取部门列表接口,入参部门字段传1,获取企业通讯录根部门下的一级子部门信息。
根据部门ID信息,获取的结果中有部门的父部门ID和本部门ID,循环获取每一个部门下的部门列表,直到每一个部门ID作为参数时获取的结果为空,就可以获取到企业所有的部门信息。
可以通过发送POST请求到https://oapi.dingtalk.com/topapi/v2/department/listsub
获取当前部门的下一级部门基础信息。请求正文需要包含语言和部门ID两个参数。返回结果中,errcode为0表示请求成功,result中包含了下一级部门的信息。但需要注意,该接口只支持获取当前部门的下一级部门信息,不支持获取当前部门下所有层级子部门。
此回答整理自钉群“钉钉开发者社区(互助群)”