获取第三方应用授权企业的accessToken

POST

http://127.0.0.1/v1.0/oauth2/corpAccessToken

新版服务端API（DingTalk OpenAPI）/获取访问凭证/获取应用身份相关访问凭证

最后修改时间：2022-08-30 09:19:23

责任人：未设置

说明

定制服务商和服务商可通过此接口获取授权企业的accessToken。当第三方企业应用或定制应用调用服务端API获取应用资源时，使用获取的accessToken进行身份验证。
服务地址：api.dingtalk.com

权限

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

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

错误码

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

请求参数

Body 参数application/json

suiteKey

string

必需

已创建的第三方企业应用的SuiteKey。

suiteSecret

string

必需

已创建的第三方企业应用的SuiteSecret。

authCorpId

string

必需

授权企业的CorpId。定制应用可以在开发者后台定制应用页面查看。第三方企业应用使用钉钉开放平台向应用推送的授权企业的corpid，请参考数据格式(biz_type=4)。

suiteTicket

string

必需

钉钉推送的suiteTicket。定制应用可随意填写。第三方企业应用使用钉钉开放平台向应用推送的suite_ticket，请参考数据格式(biz_type=2)。suiteTicket是有有效期的，调用接口要确保从推送源中读取最新推送的suiteTicket值，一般五个小时推送一次。

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/v1.0/oauth2/corpAccessToken' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

accessToken

string

可选

授权企业的accessToken。

expireIn

integer

可选

授权企业的accessToken超时时间，单位秒。

示例

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

获取企业内部应用的accessToken

获取第三方企业应用的suiteAccessToken

获取第三方应用授权企业的accessToken

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码