应用类型	开发者	使用人员	支持的能力	是否支持上架到钉钉应用广场
企业内部应用	企业内部开发者或委托的服务商开发者	安装了该应用的企业内部人员	• 小程序 ◦ 支持移动端 ◦ 支持PC端 • H5微应用 ◦ 支持移动端 ◦ 支持PC端 • 机器人	否
第三方企业应用	产品方案商的开发者	购买开通该三方应用的企业内部人员	• 小程序 ◦ 支持移动端 ◦ 支持PC端 • H5微应用 ◦ 支持移动端 ◦ 支持PC端	是，需要满足上架要求，上架流程请参考合作全流程指引。
第三方个人应用	产品方案商的开发者	钉钉的个人用户	• 小程序 ◦ 支持移动端 ◦ 支持PC端	否

基础概念

https://open.dingtalk.com/document/orgapp/basic-concepts#title-o8w-yj2-t8x

userId和UnionId

在钉钉中，每个用户都有一个唯一的标识符。其中，userId和UnionId是两个常用的标识符。

userId：userId是钉钉中的用户ID，是由钉钉生成的全局唯一标识符。每个用户在使用钉钉时都会有一个userId，可以通过API获取到。userId只在当前企业中唯一，不同企业的用户可能会有相同的userId。

UnionId：UnionId是一个跨企业的唯一标识符，可以用来标识同一个用户在不同企业中的身份。UnionId是由钉钉开放平台生成的，可以通过开放平台的API获取到。同一个用户在不同企业中的userId不同，但是其UnionId相同。因此，开发者可以通过UnionId来实现在不同企业中识别同一个用户。

总之，userId是钉钉中的用户ID，只在当前企业中唯一；而UnionId是一个跨企业的唯一标识符，可以用来标识同一个用户在不同企业中的身份。两者的区别在于应用场景不同。

钉钉应用

钉钉应用分为内部应用和第三方应用两种类型，它们之间存在以下区别：

1. 授权方式：内部应用不需要授权，因为内部应用是由企业自己开发并部署在自己的服务器上的；而第三方应用需要企业授权才能在企业内部使用。 2. 应用安全：内部应用的安全由企业自己负责，而第三方应用必须经过钉钉开放平台的审核，并且需要实现OAuth2.0授权认证机制，以确保应用的安全性。 3. 应用权限：内部应用可以访问企业内部的所有数据和资源，而第三方应用只能访问企业授权的数据和资源。 4. 应用开发方式：内部应用的开发由企业自己完成，而第三方应用的开发由开发者完成，可以在钉钉开放平台上注册应用，并使用开放平台提供的API进行开发。 5. 应用数量：每个企业最多只能创建100个内部应用，而对于第三方应用则没有数量限制。

总之，内部应用和第三方应用的主要区别在于授权方式、应用安全、应用权限、应用开发方式和应用数量等方面。企业可以根据自己的需求和实际情况选择合适的应用类型。

CorpId

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

登录钉钉开发者后台，在首页下查看企业的CorpId。

UserId

企业内每个员工都有唯一的UserId，创建后不可修改。

登录钉钉管理后台，在通讯录 > 成员管理页面，单击员工姓名可查看员工的UserId。

UnionId

用户在当前钉钉开放平台账号范围内的唯一标识，同一个钉钉开放平台账号可以包含多个开放应用，同时也包含ISV的套件应用及企业应用。

可通过调用查询用户详情接口获取unionid参数值。

AppKey/AppSecret

AppKey是企业内部应用的唯一身份标识，AppSecret是对应的调用密钥。

在钉钉开发者后台创建企业内部应用后，系统会自动生成一对AppKey和AppSecret。

登录钉钉开发者后台，在应用开发页面，单击已创建的应用，然后单击应用信息查看AppKey和AppSecret。

SuiteKey/SuiteSecret

SuiteKey是第三方企业应用的唯一身份标识，SuiteSecret是对应的调用密钥。

在钉钉开发者后台创建第三方应用后，系统会自动生成一对SuiteKey和SuiteSecret。

登录钉钉开发者后台，在应用开发页面，单击已创建的应用，然后单击应用信息查看SuiteKey和SuiteSecret。

SSOSecret

SSOSecret和CorpId用于获取微应用后台免登的access_token，微应用后台免登的access_token用于管理员在钉钉管理后台对应用进行设置和管理时，无需输入该应用的账号和密码，可直接登录应用的管理后台。

access_token

access_token是企业后台通过钉钉接口获取信息的重要凭据。在调用钉钉接口时必须携带access_token用于验证接口的访问权限。

企业内部应用，通过调用获取企业内部应用的accessToken接口获取access_token。

第三方企业应用，通过调用获取第三方应用授权企业的accessToken接口获取access_token。

AgentId

每个应用都拥有唯一的AgentId。企业在钉钉开发者后台创建应用时，或者在企业授权开通第三方企业应用时，系统会自动生成一个AgentId。

查看企业内部应用的AgentId

1. 登录

钉钉开发者后台，然后选择企业内部应用。

1. 单击已创建的应用，进入

应用详情页，在应用凭证模块查看应用的AgentId。

MiniAppId

MiniAppId是小程序的唯一身份标识。在钉钉开发者后台创建小程序后，系统会自动生成一个MiniAppId。

登录钉钉开发者后台，在应用开发页面，单击已创建的应用，然后单击应用信息查看MiniAppId。

Last update: 2024-1-30