获取企业内部应用的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 |
请求参数
Body 参数application/json
appKey
string
必需
已创建的企业内部应用的AppKey。
appSecret
string
可选
已创建的企业内部应用的AppSecret。
示例
{
"appKey": "String",
"appSecret": "String"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
accessToken
string
必需
生成的accessToken。
expireIn
integer
必需
accessToken的过期时间,单位秒。
示例
{
"accessToken": "fw8ef8we8f76e6f7s8dxxxx",
"expireIn": 7200
}
最后修改时间: 1 年前