获取第三方应用授权企业的accessToken
POST
/v1.0/oauth2/corpAccessToken最后修改时间:: 2 年前
责任人: 未设置
说明
定制服务商和服务商可通过此接口获取授权企业的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值,一般五个小时推送一次。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
accessToken
string
可选
授权企业的accessToken。
expireIn
integer
可选
授权企业的accessToken超时时间,单位秒。
示例
{
"accessToken": "string",
"expireIn": 0
}
最后修改时间: 2 年前