钉钉开放平台接入基本介绍

一、整体介绍

钉钉分企业内部开发、ISV开发和集成服务商。

下面介绍的是ISV的接入流程。

应用服务商(ISV)是独立于企业、钉钉之外的第三方软件开发商。应用服务商(ISV)开发微应用并上架到钉钉应用市场，供钉钉上的企业/组织选用，企业管理员在钉钉应用市场授权安装该微应用后，该企业/组织内的成员即可使用该应用。

1、创建套件，创建完毕之后，有相关的key，套件是需要授权的。

当您注册套件时，钉钉服务器为了避免无效推送，将会验证回调url的有效性，对回调url推送“验证回调URL有效性事件”，收到推送后您需要需要返回“success”的加密值，才能成功创建套件。

https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.mJtxff&treeId=366&articleId=104943&docType=1

在套件管理页面可以看到套件的基本配置信息，比如套件Key，套件secret。套件的suiteKey和suiteSecret在套件授权的过程中会用到，注意：suiteSecret 需要配置到项目的配置文件中，具体参考：套件授权。

2、套件下面创建微应用，一个套件下面可以有多个微应用。

3、创建测试企业才能获取到通讯录权限，也方便测试。

4、开发套件

1.钉钉开放平台提供了一组应用接入与授权的接口，通过实现接入与授权接口，开发者可以快速发布自己的套件。在企业用户授权开通套件时，开发者需要为企业主动激活套件。企业用户可以在授权后直接使用您的套件（应用），接口使用可以参考ISV应用授权流程。

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

3.我们提供了一组可以调用钉钉的本地能力和业务逻辑的JSAPI，开发者可以通过这些接口调用钉钉的原生控件，降低开发成本，提升微应用在移动客户端的体验。接口使用可以参考移动端开发文档。

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

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

二、ISV授权流程

有了企业的access_token就可以进行免登以及调用服务端接口。

获取企业的access_token以后，可以通过前端免登服务换取登录用户的用户信息，例如userid等。

获取userid和企业的access_token以后，可以通过调用通讯录管理的user/get接口来获取当前登录用户的基本信息，参见文档。

应用服务商（ISV）默认无管理通讯录的权限，只有user/get接口调用权限。

三、ISV应用授权管理

开发者在完成应用授权的开发之后，应该也会需要重新授权以及ISV为授权方的企业单独设置IP白名单的接口。

四、免登鉴权

免登：钉钉提供了OAuth的授权登录方式，可以让用户从钉钉客户端打开的网页直接获取成员的身份信息，从而免去登录的环节。

企业或者ISV开发的应用，需要让用户在登录钉钉进入应用的时候通过授权获取用户信息而不用输入用户名密码。这里面企业授权获取access_token和ISV授权获取access_token的方式不一样。

五、消息体加密解密

为了验证调用者的合法性，钉钉在回调url中增加了消息签名，以参数signature标识，企业需要验证此参数的正确性后再解密。

更多具体细节参考官方文档。

---

如需了解更多，欢迎访问石榴CRM官网：http://www.shiliucrm.com/