浙政钉对接文档

*钉钉、专有钉钉、政务钉钉、浙政钉对接文档*

浙政钉 为规范浙政钉整体架构体系，按照统分结合原则，由省政府办公厅统一设计整体工作界面和系统框架，统筹指导全省统建应用建设，各单位根据自身业务特点分别建设自建应用，最终形成全省统一的政府系统掌上协同办公平台。

专有钉钉 原名政务钉钉，有更开放的设计能力、集成能力、更结构化协同产品、更定制化开发平台。支持专有化部署，数据落本地，更安全、客户可对该产品持牌运营、结构化编排，协助构建本地应用中心、提供移动应用全面安全保障体系。

简单来说，开发阶段使用的都是专有钉钉的环境（测试环境），开发完毕由业主提交浙政钉应用上架，把测试环境改为浙政钉（正式环境）即可。

*各环境域名/登录域名*

环境	开放平台域名（调接口使用）	登录域名（构造登录页面）
Saas(专有钉钉)	openplatform.dg-work.cn	login.dg-work.cn
浙政钉	openplatform-pro.ding.zj.gov.cn（域名对应政务外网IP：59.202.52.1）	login-pro.ding.zj.gov.cn（域名对应政务外网IP：59.202.52.68）

1. *免登*

免登流程：

\1. 首先需要在专有钉钉开发者后台建一个测试应用，用于配置我们后台的网址，也可 获取到我们后边调用接口要用到的ak、sk，应用创建完需要发布应用，如需修改应 用需要先下架然后修改完毕再重新发布应用。

\2. 前端获取免登授权码authCode（用于获取人员信息接口传参，有效期5分钟，且 只能用一次）

https://openplatform-portal.dg-work.cn/portal/#/helpdoc?docKey=kfzn&slug=kpkrae

\3. 后端获取应用access_token(正常情况下 access_token 有效期为7200秒)

\4. 根据免登授权码和access_token调用获取用户信息接口获取用户信息

判断免登逻辑：通过获取用户信息我们可以拿到用户的accountId(浙政钉用户唯一 标识)和lastName(浙政钉用户)姓名；我们这里是维护了一张accountId和我们系统 的user表，先根据accountId去查询出userId

（1）如果userId不为空，说明该人的浙政钉信息和我们系统的信息可以关联上， 然后根据userId从我们系统查出该人的userName,根据userName进行免登， 返回HttpResult.success，否则返回HttpResult.error，前端跟状态码判断是否 免登录。

（2）如果userId为空，我们根据lastName去查询我们系统的人员表，这里可能会 重名的情况，我们的处理方法是取第一个，如果我们系统人员存在该人，返回 HttpResult.success，否则返回HttpResult.error，前端跟状态码判断是否免登录。

开发测试阶段建议让前端搞一个vConsole,用于获取authCode，方便用于后端开发测试阶段测试。

*1.获取应用access_token（调⽤接⼝凭证）*

接口名：/gettoken.json

所在目录：企业内应用免登

调用方式：POST（HTTPS）

请求参数

名称	类型	是否必填