钉钉 API

获取企业内部应用的accessToken

POST

/v1.0/oauth2/accessToken

企业内部应用调用本接口获取accessToken。调用服务端API获取应用资源时，需要通过accessToken来鉴权调用者身份进行授权。

说明

在使用accessToken时，请注意：

accessToken的有效期为7200秒（2小时），有效期内重复获取会返回相同结果并自动续期，过期后获取会返回新的accessToken。

开发者需要缓存accessToken，用于后续接口的调用。因为每个应用的accessToken是彼此独立的，所以进行缓存时需要区分应用来进行存储。

不能频繁调用gettoken接口，否则会受到频率拦截。

在获取accessToken前，需要在开发者后台查看应用的AppKey和AppSecret：

登录钉钉开发者后台。

在应用开发页面，单击目标应用进入应用详情页面。

在基础信息页面，复制应用的AppKey和AppSecret。

说明

请妥善保管应用的AppKey和AppSecret。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	默认开通，无需申请	API Explorer
第三方企业应用	暂不支持	默认开通，无需申请	暂不支持
第三方个人应用	暂不支持	默认开通，无需申请	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidClientIdOrSecret	无效的clientId或者clientSecret	无效的clientId或者clientSecret

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dingtalk.com/v1.0/oauth2/accessToken' \
--header 'Content-Type: application/json' \
--data-raw '{
  "appKey" : "String",
  "appSecret" : "String"
}'

响应示例

{
  "accessToken": "string",
  "expireIn": 0
}

请求参数

Body 参数application/json

appKey

string

必需

已创建的企业内部应用的AppKey。

appSecret

string

可选

已创建的企业内部应用的AppSecret。

示例

返回响应

🟢200成功

application/json

Body

accessToken

string

必需

生成的accessToken。

expireIn

integer

必需

accessToken的过期时间，单位秒。

修改于 2024-01-08 06:27:29

获取定制应用的accessToken

获取微应用后台免登的accessToken

获取企业内部应用的accessToken

权限#

错误码#

请求参数

返回响应

权限

错误码