开发者社区 问答 正文

钉钉如何获取部门列表?

钉钉如何获取部门列表?

展开
收起
三分钟热度的鱼 2023-09-13 22:21:28 749 分享 版权
3 条回答
写回答
取消 提交回答
  • 在钉钉中,要获取部门列表,你可以使用钉钉的组织架构查询接口。以下是一个基本的使用示例:

    1. 首先,你需要登录到钉钉的管理员账户,然后进入到“管理中心”->“组织架构”页面,找到你要查询的公司或团队,然后点击右侧的“展开”按钮。

    2. 在展开的组织架构页面中,你会看到所有的部门列表。你可以选择一个部门,然后点击右侧的“详情”按钮。

    3. 在部门详情页面上,你会看到部门的所有子部门和员工列表。你可以在这里查看和编辑部门的信息,也可以在这里添加和删除部门。

    如果你想要通过代码来获取部门列表,你可以使用钉钉提供的API。以下是一个基本的使用示例:

    1. 首先,你需要登录到钉钉的管理员账户,然后进入到“管理中心”->“应用管理”->“我的应用”,找到你要使用的应用,然后点击“详情”按钮。

    2. 在应用详情页面上,你会看到一个“开发者模式”的开关,将其打开。

    3. 接下来,你需要获取OAuth Token。在“开发者模式”下,你可以看到一个“获取OAuth Token”的链接,点击这个链接,按照提示输入相关的信息,然后提交。提交成功后,你会得到一个OAuth Token。

    4. 现在,你可以使用这个OAuth Token来查询部门列表。你可以使用REST API或者SDK来进行查询。这里我们以REST API为例:

      URL格式:https://oapi.dingtalk.com/department/list?access_token=ACCESS_TOKEN

      其中,"ACCESS_TOKEN"是你刚刚得到的OAuth Token。

    5. 将这个URL发送给你的服务器,然后解析返回的结果,就可以得到部门列表。

    需要注意的是,这个查询接口有一定的限制,比如每天只能查询一定数量的部门,超过这个限制就会被拒绝。此外,查询结果只返回部门的基本信息,如名称、ID等,具体的员工信息是不返回的。

    2023-09-15 09:14:40
    赞同 展开评论
  • 获取部门列表

    https://open.dingtalk.com/document/orgapp/obtain-the-department-list

    image.png

    权限
    服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。

    image.png

    获取企业下所有部门列表

    3ddffd956693c926d068f88b8e1eaf28_p504672.png

    接入流程简介
    本文介绍了创建一个企业内部应用,使用通讯录管理提供的部门管理相关API,实现获取企业下所有部门列表。

    步骤一:登录开发者后台,点击应用开发-企业内部开发,创建企业内部应用。

    步骤二:单击基础信息 > 应用信息,获取应用AppKey和AppSecret。

    步骤三:添加接口调用权限。单击“通讯录管理”,申请通讯录接口对应的权限。

    步骤四:获取应用访问凭证获取企业内部应用的access_token。调用接口时,通过accessToken鉴权调用者身份。

    步骤五:调用通讯录相关API:

    调用服务端API-获取部门列表接口,入参部门字段传1,获取企业通讯录根部门下的一级子部门信息。

    根据部门ID信息,获取的结果中有部门的父部门ID和本部门ID,循环获取每一个部门下的部门列表,直到每一个部门ID作为参数时获取的结果为空,就可以获取到企业所有的部门信息。

    2023-09-14 08:44:12
    赞同 展开评论
  • 可以通过发送POST请求到https://oapi.dingtalk.com/topapi/v2/department/listsub获取当前部门的下一级部门基础信息。请求正文需要包含语言和部门ID两个参数。返回结果中,errcode为0表示请求成功,result中包含了下一级部门的信息。但需要注意,该接口只支持获取当前部门的下一级部门信息,不支持获取当前部门下所有层级子部门。
    此回答整理自钉群“钉钉开发者社区(互助群)”

    2023-09-13 22:35:22
    赞同 展开评论