钉钉开放平台

适用主体

企业内部开发者、获得组织授权的开发团队、企业软件服务商、个人工具开发者

接入方式

企业应用使用 Client ID、Client Secret 和 corpId 获取应用级 Access Token / 自定义机器人使用目标群的 Webhook 凭证 / 不同应用类型与客户端能力按各自授权流程接入

申请概况

企业数据需组织和应用权限；个人应用类型有独立能力范围。

• 先选择企业内部、第三方企业或第三方个人应用，确认服务对象与所需能力。
• 企业数据接入需获得目标组织的应用开发及资源授权；应用凭证仅用于获授权范围。
• 使用当前应用级凭证接口时提交 Client ID、Client Secret、grant_type 和运行组织 corpId，并维护凭证有效期。
• 将密钥保存在服务端，按实际任务申请权限，并在资源管理中确认 API、消息通道和 QPS 权益。

1. 01

   选择应用类型

   按单一组织、多企业分发或个人用户场景，选择支持目标能力的应用类型。

2. 02

   创建应用并配置权限

   进入开发者后台创建应用，添加能力、使用范围和必要权限；第三方企业应用另外安排分发审核。

3. 03

   获取对应身份凭证

   企业应用按当前 Access Token 文档获取运行组织凭证；自定义机器人使用自己的 Webhook 配置。

4. 04

   验证小范围流程

   先在专用应用、群或授权资源中验证读取和交互，检查错误、重试及资源消耗，再扩大使用。

使用范围与限制

• 能向群发送 Webhook 消息不代表能读取组织聊天历史或任意成员数据。
• 企业内部应用仅供单一企业内部使用；面向多个企业的第三方应用需按当前规则完成上架审核。
• 不要把第三方个人应用理解为企业开放能力的免授权入口，其支持的应用形态和资源范围不同。
• OpenAPI 与 Webhook/Stream 的月额度分开计算；月额度与接口 QPS 限制也需分别处理。
• 基础接口及基础事件存在不计入相应用量的清单，应逐项核对，不能一概认为所有调用都收费或都免费。

如何进行开发测试

• 使用独立测试应用、群和有限资源范围验证，避免影响日常组织工作。
• 官方学习地图提供创建、开发、测试发布与使用流程；具体能力的测试条件需要分别核对。
• 本次未确认覆盖全部能力的统一免费沙箱，调试和测试仍需留意真实组织数据及用量。

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

1. 01
   钉钉开发文档中心：开放接口与能力介绍已核对官方资料 · 2026-10-15
2. 02
   应用类型与能力说明，2026-05-19 更新已核对官方资料 · 2026-10-15
3. 03
   企业内部应用学习地图已核对官方资料 · 2026-10-15
4. 04
   获取应用的 Access Token，2026-06-08 更新已核对官方资料 · 2026-10-15
5. 05
   计费模型说明，2026-05-09 更新已核对官方资料 · 2026-10-15
6. 06
   开发者后台，未登录核验账号权益官方入口 · 细则待复核 · 2026-10-15