钉钉 API 调用教程,图文讲解钉钉接口的用法

钉钉 API 在正式调用之前,需要让组织管理员给开发者添加“开发者权限”,不同身份的钉钉开发者可开发不同类型的应用(如果你是企业“主管理员”则无需配权限)。

用 Apifox,节省研发团队的每一分钟

钉钉 API 调用教程,图文讲解钉钉接口的用法

免费使用 Apifox

相关推荐

最新文章

API

一体化协作平台

API 设计

API 文档

API 调试

自动化测试

API Mock

API Hub

立即体验 Apifox
目录

钉钉 API 在正式调用之前,需要让组织管理员给开发者添加“开发者权限”,不同身份的钉钉开发者可开发不同类型的应用(如果你是企业“主管理员”则无需配权限)。钉钉 API 在线地址为:https://dingtalk.apifox.cn/,这个在线地址的项目你可以克隆到 Apifox,以方便调试。

钉钉 API 调用教程
钉钉 API 调用教程

进入 钉钉 OA 系统,成为企业管理员

如果你不是企业管理员,可以登录 OA 管理后台,你可以在钉钉里面新建一个组织,让自己成为企业的主管理员,这样就拥有了全部权限。或者见下文,让企业管理员给你配置“子管理员”的权限。

钉钉API 成为企业管理员
钉钉注册企业

子管理员权限配置

你可以给组织的特定成员设置为“子管理员”,在管理后台,依次选择“安全与权限 -> 权限管理”,然后单击“子管理员”,进入权限管理组界面。

钉钉 API 子管理员配置
钉钉 API 子管理员配置


点击“添加子管理员”,填写管理组名称,然后分配管理组成员和管理范围,最后勾选对应的开发者权限并单击“保存”即可。现在,你应该拥有了当前企业的“开发者权限”

钉钉 API 配置开发者权限
钉钉 API 配置开发者权限

获取企业内部应用的 access_token


有了开发者权限,就可以调用钉钉 API,或者根据需要定制开发企业应用了。


在调用相关的 API 之前,你需要获取 access_token, access_token 是企业后台通过钉钉接口获取信息的重要凭据。在调用钉钉接口时必须携带 access_token 用于验证接口的访问权限。


在获取 access_token 前,需要在开发者后台(https://open-dev.dingtalk.com/查看应用的 AppKey 和 AppSecret。

钉钉API的AppKey 和 AppSecret
钉钉 API 的 AppKey 和 AppSecret


有了应用的 AppKey 和 AppSecret,即可获取 access_token。在 Apifox 的钉钉 API 项目中填写 AppKey 和 AppSecret 即可获取。

钉钉 API 的 access_token
钉钉 API 的 access_token

调试钉钉其它 API

当 access_token 获取到后,即可调用其它接口,比如下图所示的“获取通讯录权限范围”接口调用,在 Query 参数中填写 access_token 的值并发起请求。

调试钉钉 API 接口
调试钉钉 API 接口

你也可以将 access_token 存在环境变量中,其它接口就可以通过变量(如{{access_token}} )的形式访问。

调试钉钉 API 接口

使用 Apifox 调试、管理接口

Apifox 是一个比 Postman 更强大的接口测试工具,Apifox = Postman + Swagger + Mock + JMeter,Apifox 支持调试 http(s)、WebSocket、Socket、gRPC、Dubbo 等协议的接口,并且集成了 IDEA 插件。在开发完接口后,可以通过 Apifox 的 IDEA 插件一键生成接口文档,多端同步,非常方便测试和维护。

Apifox

知识扩展: