钉钉开发文档

名词解释

更新时间: 2018-10-30

本小节是应用开发过程中用到的各种名词的字典,开发者可先简单浏览理解一下,也可在看其他文档时回到这里查看。

第三方企业应用

ISV(钉钉、企业客户之外的第三方独立软件服务商)可以将自己开发的应用上架到钉钉应用市场,提供给钉钉其他企业用户使用。

企业内部开发

企业依托钉钉强大的开放能力,将企业自己的HR、OA、客户管理、业务管理等系统接入钉钉,实现移动化办公。

E应用

钉钉提供的一种基于钉钉容器的前端开发框架,完美兼顾性能与动态性,让移动开发者通过简捷的前端语法写出Native级别的性能体验,并支持iOS、安卓等多端部署。

CorpID

CorpID是企业在钉钉中的标识,每个企业拥有唯一的CorpID。

AccessToken

1.AccessToken是企业自建应用或者被企业授权开通的第三方应用访问钉钉服务端开放接口的全局唯一凭证。
2.正常情况下AccessToken有效期为7200秒,有效期内重复获取会返回相同的结果,并自动续期。

AppKey

AppKey是企业自建E应用的唯一性标识。开发者在创建应用时,系统会自动生成。

AppSecret

AppSecret和AppKey在企业自建E应用时一同生成,使用AppKey和AppSecret可获取AccessToken

回调

第三方企业应用创建后,开发者在开发者后台可为应用设置一个URL。一些应用相关的重要事件发生时,钉钉向该URL地址发起http请求,并推送一段加密和签名过的数据,此数据推送过程称之为回调。此URL称之为回调地址。应用收到http请求时需要验证签名并解密。

回调的主要用途:
1 企业授权开通应用事件。告知应用“开通本应用的是哪个企业”
2 定期推送suiteTicket(开发者后台也可手动点击推送)
3 其他应用相关事件。如停用、启用、解除授权等

SuiteTicket

本参数定期动态变化,用于辅助获取AccessToken。钉钉通过应用回调URL定期推送下来新值,用于提高应用在获取accessToken时的安全水位。钉钉会对正式应用做此参数检查,因此正式应用需要设置并调通回调地址。而当您正在体验测试应用开发时,钉钉不会检查此参数。

image.png

Jsticket

企业在使用微应用中的JSAPI时,需要先从钉钉开放平台接口获取jsapi_ticket生成签名数据,并将最终签名用的部分字段及签名结果返回到前端H5中,通过调用dd.config来判断H5是否有权限使用钉钉的JSAPI。

JSAPI

JSAPI是通过JavaScript调用移动端能力的API,这些移动端API将为微应用提供调用原生控件的能力,帮助开发者高效地使用拍照、定位等手机系统的能力,同时可以直接使用扫一扫、分享、钉盘等钉钉特有的能力,给微应用带来接近原生代码的体验。

UserId

员工在当前企业的唯一标识ID(不可修改)。

UnionId

跨应用用户唯一标识,一个用户的unionid在同一组织开发的多个应用内相同。

Openid

用户在当前应用内的唯一标识。

Jobnumber

员工工号,在企业管理后台https://oa.dingtalk.com可以更新。

AppId

应用ID,同一个ISV应用在不同企业的appId一致。

AgentId

代表应用和企业映射关系的ID(应用在企业开通后的开通记录ID),同一个ISV应用在不同企业的agentId不一致。

免登

“免登”是指用户免除输入钉钉用户名和密码,您所开发的系统便可获取用户身份,实现登录您系统的身份验证流程。

JSAPI鉴权

钉钉提供的JSAPI有些需要进行权限验证后才可调用,比如发钉JSAPI、通讯录选人组件等,权限验证的过程就是鉴权。