获取应用级账号 Token
... 2022-7-18 大约 1 分钟
# 获取应用级账号 Token
# 接口说明
本接口用于获取应用级账号的 Access Token 和 Refresh Token。
注意:
1、该账号只适用于通过开放接口操作腾讯文档,无法通过腾讯文档前端进行登录和操作,如发现对应账号出现恶意行为,可能会影响到应用的使用
2、为了防止 Client Secret 和 Token 泄密,请求需要由第三方后台服务发起
3、出于安全性考虑,该账号创建的文档不允许通过游客态访问
4、每个应用级账号的免费存储空间为1G,暂不支持扩容
# 权限说明
本接口需要拥有以下任意一项权限:
scope.auth.account
请求格式
| 描述 | 定义 |
|---|---|
| 接口名 | /oauth/v2/app-account-token |
| 请求方式 | GET |
请求参数
| 名称 | 必须 | 类型 | 备注 |
|---|---|---|---|
| client_id | 是 | string | 申请应用时分配的 client_id |
| client_secret | 是 | string | 申请应用时分配的 client_secret |
响应体
| 名称 | 类型 | 备注 |
|---|---|---|
| access_token | string | 应用级账号的访问令牌 |
| token_type | string | 目前统一返回 Bearer |
| expires_in | integer | Access Token 的过期时间,单位为秒 |
| refresh_token | string | 应用级账号的的刷新令牌,用于刷新 Access Token(1 年有效期) |
| user_id | string | 应用级账号的唯一标识,也就是 Open ID |
| scope | string | Access Token 的权限范围,用 , 分隔 |
请求示例
curl --location --request GET https://docs.qq.com/oauth/v2/app-account-token?client_id=CLIENT_ID&client_secret=CLIENT_SECRET
1
1
响应示例
{
"access_token": "ACCESSTOKENEXAMPLE",
"token_type": "Bearer",
"refresh_token": "REFRESHTOKENEXAMPLE",
"expires_in": 259200,
"scope": "scope.file.editable,scope.folder.creatable",
"user_id": "bcb50c8a4b724d86bbcf6fc64c5e2b22"
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8