requestAuthCode

更新于 2025-08-27

获取微应用免登授权码

调用 requestAuthCode 获取网页应用（原 H5 微应用）免登授权码。

免登是指用户进入应用后，无需输入钉钉用户名和密码，应用程序可自动获取当前用户登录系统的流程。在免登流程中需要向钉钉获取免登授权码，即是通过调用该api获取。

获取的免登授权码有效期 5 分钟，且只能使用一次。

具体免登流程如下：

调用本接口获取免登授权码。
调用获取应用的 Access Token接口，获取应用访问凭证。
调用通过免登码获取用户信息接口，获取用户userid。
调用查询用户详情接口，获取用户信息。

网页应用免登具体操作内容，可参考网页应用（H5微应用）免登流程，包含Demo 示例。

支持说明

应用能力	Android	iOS	Harmony	Mac	Windows	预览效果
网页应用（原H5微应用）	7.0.45	7.0.45	7.0.0	7.0.50	7.0.50	去预览
小程序	不支持	不支持	不支持	不支持	不支持	-

支持应用类型

应用类型	是否支持调用
企业内部应用	是
第三方企业应用	是
第三方个人应用	否

鉴权规则

无需鉴权即可直接调用

参数说明

继承通用输入对象，扩展属性描述：

名称	类型	是否必填	示例值	描述
corpId	String	是		企业的CorpId。

你可以在应用首页地址/PC端首页地址添加参数corpid=$CORPID$，例如：https://example.com?corpid=$CORPID$，当从工作台访问该应用时，会将 corpid 自动解析为当前访问用户所在的组织 ID。 | | clientId | String | 是 | | 应用的Client ID。

Client ID 说明

原企业内部应用的 AppKey。

原第三方企业应用的 SuiteKey。 |

返回结果

继承通用输出对象，扩展属性描述：

名称	类型	示例值	描述
code	String	hYLK98jkf0m	authCode

示例代码

默认出入参

dd.requestAuthCode({

corpId: 'corpid',

clientId: 'clientid',

onSuccess: function (result) {

/*{

code: 'hYLK98jkf0m' //string authCode

}*/

onFail: function (err) {},

});

success返回对象示例：

{ "code": "hYLK98jkf0m" }

Enter to Rename, ⇧Enter to Preview

requestAuthCode.md 3.5 KB History Raw