获取第三方企业应用的suiteAccessToken
POST
/v1.0/oauth2/suiteAccessToken最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取第三方企业应用的suiteAccessToken。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 暂不支持 | 无需申请 | 暂不支持 |
第三方企业应用 | 支持 | 无需申请 | API Explorer |
第三方个人应用 | 暂不支持 | 无需申请 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | invalidSuiteTicket | suiteTicket无效 | suiteTicket无效 |
400 | invalidClientIdOrSecret | clientId或者clientSecret错误 | clientId或者clientSecret错误 |
请求参数
Body 参数application/json
suiteKey
string
必需
已创建的第三方企业应用的SuiteKey。
suiteSecret
string
必需
已创建的第三方企业应用的SuiteSecret。
suiteTicket
string
必需
钉钉开放平台会向应用的回调URL推送的suite_ticket(约5个小时推送一次),详细内容请参考推送suite_ticket事件。
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
accessToken
string
可选
第三方企业应用的凭证。
expireIn
integer
可选
第三方企业应用的凭证过期时间,单位秒。suiteAccessToken有效期为7200秒,过期之前建议服务端做定时器主动更新,而不是依赖钉钉的定时推送。
示例
{
"accessToken": "string",
"expireIn": 0
}
最后修改时间: 2 年前