获取定制应用的accessToken

POST

/v1.0/oauth2/corpAccessToken

产品服务商可通过此接口获取授权企业的accessToken。定制应用调用服务端API获取应用资源时，使用获取的accessToken进行身份验证。

说明

在使用accessToken时，请注意：

accessToken的有效期为7200秒（2小时），有效期内重复获取会返回新的accessToken。

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

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

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用（委托产品服务商开发时使用）	支持	默认开通，无需申请	API Explorer
第三方企业应用	支持	默认开通，无需申请	API Explorer
第三方个人应用	暂不支持	默认开通，无需申请	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidSuiteKey	suitekey不合法	suitekey不合法
400	invalidSuiteTicket	suiteTicket无效	suiteTicket无效
400	invalidAuthInfo	授权关系不存在	企业未开通对应的三方应用，无法获取该企业token

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.dingtalk.com/v1.0/oauth2/corpAccessToken' \
--header 'Content-Type: application/json' \
--data-raw '{
  "suiteKey" : "String",
  "suiteSecret" : "String",
  "authCorpId" : "String",
  "suiteTicket" : "String"
}'

响应示例

{
  "accessToken" : "1cc1bb3xxxx",
  "expireIn" : 7200
}

请求参数

Body 参数application/json

suiteKey

string

必需

定制应用的CustomKey。

suiteSecret

string

必需

定制应用的CustomSecret。

authCorpId

string

必需

授权企业的CorpId。

suiteTicket

string

必需

钉钉推送的suiteTicket，定制应用该参数自定义，比如Test。

示例

返回响应

🟢200成功

application/json

Body

accessToken

string

必需

定制应用的的accessToken。

expireIn

integer

必需

定制应用的accessToken超时时间，单位秒。

修改于 2024-01-08 06:26:25

获取jsapiTicket

获取企业内部应用的accessToken

获取定制应用的accessToken

权限#

错误码#

请求参数

返回响应

权限

错误码