# **myApps对接钉钉开发文档**

 

## **一、钉钉应用**

获取钉钉CorpId

![img](.\images\dd1.jpg) 

 

获取钉钉应用appKey和appSecret

登入开发者后台，点击应用开发-企业内部应用，找到您的应用，点击应用图标。

页面会跳转到应用详情页，点击“查看详情”，可以找到appKey和appSecret。

![img](.\images\dd2.jpg) 

![img](.\images\dd3.jpg) 

权限管理

申请权限

在应用详情页，提供了“接口权限”功能，您可以设置appKey对应的接口权限，比如通讯录接口权限。

![img](.\images\dd4.jpg) 

获取access_token

【注意】正常情况下access_token有效期为7200秒，有效期内重复获取返回相同结果，并自动续期。

![img](.\images\dd5.jpg) 

## **二、名词解释**

AgentId：在创建应用时，系统会自动生成一个AgentId，可用于发送企业会话消息等场景。

AppKey：在创建应用时，系统会自动分配一对AppKey和AppSecret，该AppKey是应用开发过程中的唯一性标识。

AppSecret：AppSecret和上面AppKey一同生成，使用AppKey和AppSecret来换取access_token。

 

## **三、对接流程**

用户进入钉钉开放平台创建一个应用，然后到myapps后台钉钉配置中填写相对应的Appkey,AppSecret,AgentId,CorpId还有外网访问地址，在myapps后台中生成了对应的跳转地址，前往钉钉开放平台的应用中修改应用首页地址为myapps生成的跳转地址,并且开通讯录编辑等权限，在myapps后台钉钉配置点击同步企业域组织架构到钉钉，即调用api同步企业域的用户和部门等信息到钉钉中，点击同步钉钉组织架构到企业域，即调用api同步钉钉用户和部门等信息到企业域中，然后再实现从钉钉工作台进去myapps用户免登陆。

![img](.\images\dd6.jpg) 

## **四、接口说明**

保存钉钉配置

/authtime/domain/{domainid}/dingding

更新钉钉应用AgentId

/authtime/domain/{domainid}/application/{applicationid}/agentid/{agentid}/updatedingdingagentid

更新钉钉应用Appkey

/authtime/domain/{domainid}/application/{applicationid}/appkey/{appkey}/updatedingdingappkey

更新钉钉应用AppSecret

/authtime/domain/{domainid}/application/{applicationid}/appsecret/{appsecret}/updatedingdingappsecret

生成钉钉应用跳转链接

/authtime/domain/{domainid}/application/{applicationid}/corp/{corpid}/server/{serverhost}/getdingdingurl

同步企业域组织架构到钉钉

/authtime/domain/{domainid}/synch2dingding

同步钉钉组织架构到企业域

/authtime/domain/{domainid}/synchfromdingding

钉钉进入myapps系统免登接口

/obpm/core/runtime/dingding/authlogin