钉钉第三方服务商应用ISV应用开发及上架教程

 当我们对接钉钉第三方服务商应用，也叫ISV应用，就是企业微信的第三方服务商应用。有以下几个要点步骤。

第一章 服务商入驻

认证产品方案服务商https://partner.dingtalk.com/indexReource#/isv_service/service_info1、打开上面的网址，点击【去认证】。注意，这里一定要使用管理员的帐号去操作，否则可能看不到网页或提示无权限。页面认证的图大概如下。这里也是需要营业执照和公司的公章。

2、这里的第一步非常的重要，如果第一步没有完成，后面的步骤是无法看到的，比如新建第三方应用等操作。

3、如果上面的认证没有完成，技术人员可以先去认证成为开发者，输入自己相关的信息，例如手机号等。

 

第二章 应用配置

钉钉企业应用列表https://open-dev.dingtalk.com/fe/app#/corp/app1、打开上面的网页，进入后，点击【应用开发】，选择【第三方企业应用】。可以参照下图。

2、选择【第三方企业应用】，然后点击右边的创建应用。

3、新建的时候，选择【H5微应用】，这样既可以在PC端也可以在手机端，本文只是DEMO，所以选择的是JSP，前后端一起的。

4、也可以参照下面的教程，都是填写一些基本信息。

钉钉第三方企业应用开发快速入门文章目录钉钉第三方企业应用开发快速入门1、创建小程序1.1. 登录开发者后台1.2. 填写基础信息1.3. 查看应用信息2、设置安全域名3、设置接口权限4、开发管理(创建回调)5、下载源码6、设置与修改源码6.1. 服务器端6.1.1. 配置代码6.2. 前端下载6.2.1. 修改前端配置7、添加体验组织并开通应用8、推送Ticket9、项目关联钉钉应用钉钉第三方企业应用开发快速入门1、创建小程序1.1. 登录开发者后台登录钉钉开发者后台，选择应用开发-第三方企业应用-小程序，点击创建应用。1.https://blog.csdn.net/a309220728/article/details/120704548

 

第三章 应用开发

1、进入到具体的开发，可以参照下面的博文，比较全面。

2、代码参照地址，记得配置IP白名单，这里叫出口IP配置，不然调用接口提示没有权限。

 出口IP配置官网文档在创建第三方企业应用后，需要完成基础配置，例如服务器出口IP并且要指定数据推送方式。https://open.dingtalk.com/document/isv/basic-configuration

钉钉H5微应用开发，服务端示例代码https://gitee.com/lne/ding-server#https://gitee.com/link?target=https%3A%2F%2Fwww.cnblogs.com%2Fapplerosa%2Fp%2F11509512.html3、该代码对应的操作图文教程，如下：

钉钉H5微应用开发，服务端示例代码-图文教程钉钉第三方企业/服务提供商的小程序/微应用开发，实现授权，回调，响应下单，用户免登等基础功能的教程说明；https://www.cnblogs.com/applerosa/p/11509512.html4、参照上面的教程后，基本的suit推送，登录都是可以的，为了后续的上架，我们还需要对现有的功能进行扩展。钉钉官网要求ISV应用上架必须具备的改造。

改造1，通讯录加密，因为后续选择价格便宜的计算巢方式上架。官方给出的教程地址如下：

通讯录加密 - 钉钉开放平台本文档介绍了通讯录加密的操作流程。https://open.dingtalk.com/document/isv/address-book-encryption1、这里需要注意，不管自己的代码逻辑有没有用到通讯录的（用户名称、用户职位、部门名称）这三个字段，接入的代码必须要有。

2、我这里多赘述一下教程。首先我们需要把自己的index页面的地址按照下面的示例，改造出来。最终的效果就是最下面的一长串一样，中间的都不用改。

 3、前端页面引入 open-data SDK，在页面中引入以下SDK。

4、如下图所示，还有一个要注意的点就是，页面要设置viewport，不然有输入框的页面，在获得焦点后，移动端页面会被放大，这个要注意。还有，下面的一堆JS，都是【安全与监控】-【监控中心】页面复制而来的代码，每个JSP或HTML的页面必须添加，用于监控，不然监控不到数据，后续是无法上架的。

 5、前端页面加载 open-data 中的数据。在页面初始化时，需要调用 DTOpenData.init 方法初始化SDK，入参是开通应用企业的corpId。该方法会返回一个boolean值，标识初始化成功或失败。如果初始化失败，一般说明当前用户未登录，需要自动跳转到上面提到的“统一登录”的url进行登录操作。

6、大概的意思就是，你原来是直接在自己的onload事件里面调用了登录接口，现在把那个登录接口放在这个if里面就可以了。可以参照下图

7、如果在PC上开发，模拟手机端，console控制台会报错，自己把它注释掉就行。或者如下图所示，如果它检测不到自己的环境，就会输出文字【这不是钉钉的环境，报错啦】，而不是不错。

 8、pom中依赖的jar。

		
			org.apache.httpcomponents
			httpclient<