欢迎您成为钉钉开放平台的开发者。

钉钉是阿里巴巴专为中小企业和团队打造的沟通、协同的多端平台，钉钉开放平台旨在为企业提供更为丰富的办公协同解决方案。通过钉钉开放平台，企业或第三方合作伙伴可以帮助企业快速、低成本的实现高质量的移动微应用，实现生产、管理、协作、运营的移动化。钉钉开放平台依托阿里巴巴多年的技术积累，建立业界一流的开放技术体系，帮助每一位开发者，提升开发效率，降低开发成本与难度。钉钉开放平台能帮助您获得更多的商业机会，服务更多的企业客户，从而不断的提升你的价值。

当您成功注册为开发者，可以通过本文档所描述的接口创建钉钉微应用，为企业实现更多丰富且个性化的企业移动应用。

假如你是企业用户，要为自己的公司开发微应用，查看企业接入指南。

假如你是ISV(服务提供商)，作为第三方要给其他公司提供微应用，先查看ISV接入指南。

开发者可以通过以下方式了解更多关于钉钉开放平台的消息：

• 开发者论坛

• 邮件组: open-dingtalk@list.alibaba-inc.com

企业接入指南

此处为企业接入微应用的快速指南，按照此处的实现步骤，您（企业）可以将已有系统快速接入钉钉，您也可以独立开发一个微应用按照此步骤接入钉钉。您需要经过以下几步：

• Step 1 – 注册钉钉企业

• Step 2 – 新增微应用

• Step 3 – 开发微应用

Step 1 – 注册钉钉企业

注册钉钉企业

一、进入 钉钉管理后台 页面, 点击 企业注册；（已经注册可跳过此步骤）

二、填写注册手机号码和短信验证码；

三、输入企业基本信息和管理员帐号和密码，点击 注册 按钮完成注册过程。

设置企业通讯录

• 您可以通过进入 钉钉管理后台 页面，登陆成功后，点击点击 通讯录可以看到如下图所示的组织架构操作进行添加或导入员工进行设置

• 您也可以通过调用通讯录接口进行创建、更新、删除、获取进行企业通讯录设置

Step 2 – 创建微应用

• 如果您还没有注册钉钉企业账号，您需要通过Step 1 – 注册钉钉企业完成钉钉企业账号注册；已注册则继续完成当前步骤您就可以在钉钉上使用微应用了 ### 新增微应用 您登录钉钉管理后台后可以进入 应用中心 页面对添加微应用

点击上图中 新增微应用 按钮，按下图填写微应用信息，点击确定后可以新增微应用。

首页地址 : 以http://或者https:// 开头的URL，是微应用的首页地址；在移动设备上打开微应用Tab页，点击微应用列表中的微应用将访问这个URL指向的页面。

后台地址 : 以http://或者https:// 开头的URL，是微应用的后台管理页面地址；配置后台地址后可以通过应用中心页面进入到微应用的管理后台。

您在应用中心创建微应用后，如上图所示可获取到微应用的AgentID，AgentID可用于发送企业会话消息等场景。

您也可以通过调用创建微应用接口进行微应用创建。

创建成功之后将会在手机的工作tab上显示出来

至此您已经可以在钉钉上使用微应用了，如果您需要对微应用与钉钉有进一步的融合，请进行定制开发，参考开发微应用

Step 3 – 开发微应用

• 您需要通过新增微应用获取微应用的AgentID，用来在微应用开发时调用开放平台的接口

钉钉开放提供丰富的接口、工具供您使用，用以降低您的开发成本：

• 钉钉开放平台提供了企业通讯录管理、文件管理、发送企业会话消息等功能，接口使用可以参考服务端开发文档；

• 钉钉开放平台提供了定制的微应用在钉钉客户端的专用运行容器，并提供了一组可以调用钉钉的本地能力和业务能力的JSApi接口，您可以通过这些接口使用钉钉的本地能力或者钉钉的业务逻辑，进行微应用与钉钉功能的结合；接口使用可以参考客户端开发文档。

• 钉钉开放平台提供了与钉钉PC版本集成的能力，接口使用可以参考PC端开发文档；

• 钉钉开放平台提供了开发过程中需要的调试工具和性能优化的建议，您可以参考调试工具&性能优化；

实现免登

您的微应用接入钉钉后，通过钉钉实现免登无需让员工进行二次登录，员工在进入微应用的时可以获取当前用户的信息实现与原系统中的账户打通。详细文档请参阅免登服务。

调用API接口

您在调用钉钉开放平台接口时需要附加AccessToken，AccessToken可以通过CorpID和CorpSecret获取。

获取CorpID和CorpSecret

CorpID是企业的唯一标识，获取CorpID和CorpSecret的步骤如下:

一、使用管理员帐号登录 钉钉管理后台 ；

二、选择顶部菜单 微应用 进入微应用页面，在左侧菜单选择 微应用设置 进入微应用设置页；

三、在微应用设置页面底部点击 获取 按钮即可获取CorpID和CorpSecret。

获取AccessToken

开发者在调用开放平台接口前需要通过CorpID和CorpSecret获取AccessToken。获取AccessToken的方法是向https://oapi.dingtalk.com/gettoken?corpid=id&corpsecret=secrect GET请求。

开发者获取AccessToken后便可以调用开放平台其他接口。

以获取部门列表接口为例，获取部门列表接口为：

oapi.dingtalk.com/department/list

在请求该接口时，需要将获取的AccessToken作为请求参数拼装到URL中：

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

更多关于AccessToken的信息请参考《服务端开发文档-建立连接》一节。

发送企业会话消息

用户可以在企业会话中查看微应用发送的消息，开发者可以通过发送消息接口将消息发送到企业会话中。

调用消息发送接口时需要使用HTTPS协议，发送的数据包为JSON格式。目前钉钉开放平台支持文本、图片、声音、文件、链接、办公消息等消息类型。

示例程序

在《Open API - 代码示例》中有发送消息的代码演示，开发者可以下载参考。

如果在使用开放平台中遇到困难请浏览《常见问题》一节，若仍不能解决请按概述中的提供的反馈方式联系我们。

ISV接入指南

此处为ISV套件接入钉钉开放平台的指南，按照此处描述步骤，您（ISV）可以从成为钉钉企业及开发者，按照文档描述的接口实现进行套件开发，完成开发后您可以选择通过钉钉应用中心的方式推广，也可以采用线下快速部署的方式进行推广。从接触钉钉到推广您需要经过以下几步：

• Step 1 – 注册、认证钉钉企业

• Step 2 – 成为钉钉开发者

• Step 3 – 开发套件（微应用）

• Step 4 – 推广套件 <!– - Step 4.1 – 钉钉应用中心推广套件 –>

• Step 4.1 – 线下快速部署推广套件

Step 1 – 注册、认证钉钉企业账号

1.注册钉钉企业账号

一、进入 钉钉管理后台 页面, 点击 企业注册；（已经注册可跳过此步骤）

二、填写注册手机号码和短信验证码；

三、输入企业基本信息和管理密码，点击 注册 按钮完成注册过程。

2.分配管理员子账号

一、登录钉钉后台管理系统，按下图进入安全中心的添加管理员子帐号页面；

二、按下图提示填写子帐号信息

完成管理员子帐号设置后，子帐号关联的钉钉用户会在钉钉客户端的 钉小秘 会话中收到已将您设置为管理员的通知，该钉钉用户可以通过收到通知中的链接地址登录管理后台，设置管理员密码 钉钉管理后台 。

3.完成企业认证

您可以通过管理员后台完成企业认证

Step 2 – 成为钉钉开发者

在注册钉钉开发者之前，您需要做好以下准备工作 - 服务端环境搭建和域名注册； - 开发环境搭建；

1.服务端环境搭建和域名注册

开发者可以自己搭建服务器也可以购买云主机来搭建自己的服务端环境，开发者需要为自己的微应用注册合法有效的域名

2.开发环境搭建

钉钉开放平台的服务端接口不区分语言和平台，开发者可以使用自己熟悉的技术搭建开发环境来开发微应用

3.注册钉钉开发者

在开发钉钉应用前，首先要创建一个套件，套件可以包含一组应用，并对这组应用统一进行权限管理。

基本流程（Basic Flow）

1. 点击进入控制台，使用阿里云账号登录。如果您当前没有阿里云账号，请先注册阿里云账号

2. 进行实名认证（已经实名认证过的开发者直接看f.步骤）

用户未通过实名认证，需要实名认证后，才能申请开发者，流程如下：

3. 点击“立即认证”

4. 新开窗口跳转到阿里云认证页面

5. 实名认证通过，在弹窗点击“立即刷新”按钮

6. 显示已通过实名认证

7. 选择开发应用类型为“钉钉企业类型”，填入“钉钉企业账号”

数据项说明

8. 显示申请开发者成功

9. 绑定钉钉认证企业

注册成功之后您需要开通钉钉服务能力，此时您需要绑定ISV当前注册并通过认证