钉钉 API 在正式调用之前,需要让组织管理员给开发者添加“开发者权限”,不同身份的钉钉开发者可开发不同类型的应用(如果你是企业“主管理员”则无需配权限)。钉钉 API 在线地址为:https://dingtalk.apifox.cn/,这个在线地址的项目你可以克隆到 Apifox,以方便调试。
进入 钉钉 OA 系统,成为企业管理员
如果你不是企业管理员,可以登录 OA 管理后台,你可以在钉钉里面新建一个组织,让自己成为企业的主管理员,这样就拥有了全部权限。或者见下文,让企业管理员给你配置“子管理员”的权限。
子管理员权限配置
你可以给组织的特定成员设置为“子管理员”,在管理后台,依次选择“安全与权限 -> 权限管理”,然后单击“子管理员”,进入权限管理组界面。
点击“添加子管理员”,填写管理组名称,然后分配管理组成员和管理范围,最后勾选对应的开发者权限并单击“保存”即可。现在,你应该拥有了当前企业的“开发者权限”。
获取企业内部应用的 access_token
有了开发者权限,就可以调用钉钉 API,或者根据需要定制开发企业应用了。
在调用相关的 API 之前,你需要获取 access_token, access_token 是企业后台通过钉钉接口获取信息的重要凭据。在调用钉钉接口时必须携带 access_token 用于验证接口的访问权限。
在获取 access_token 前,需要在开发者后台(https://open-dev.dingtalk.com/)查看应用的 AppKey 和 AppSecret。
有了应用的 AppKey 和 AppSecret,即可获取 access_token。在 Apifox 的钉钉 API 项目中填写 AppKey 和 AppSecret 即可获取。
调试钉钉其它 API
当 access_token 获取到后,即可调用其它接口,比如下图所示的“获取通讯录权限范围”接口调用,在 Query 参数中填写 access_token 的值并发起请求。
你也可以将 access_token 存在环境变量中,其它接口就可以通过变量(如{{access_token}}
)的形式访问。
使用 Apifox 调试、管理接口
Apifox 是一个比 Postman 更强大的接口测试工具,Apifox = Postman + Swagger + Mock + JMeter,Apifox 支持调试 http(s)、WebSocket、Socket、gRPC、Dubbo 等协议的接口,并且集成了 IDEA 插件。在开发完接口后,可以通过 Apifox 的 IDEA 插件一键生成接口文档,多端同步,非常方便测试和维护。
知识扩展: