获取应用级账号 Token

... 2022-7-18 大约 1 分钟

# 获取应用级账号 Token

# 接口说明

本接口用于获取应用级账号的 Access TokenRefresh Token


注意:

1、该账号只适用于通过开放接口操作腾讯文档,无法通过腾讯文档前端进行登录和操作,如发现对应账号出现恶意行为,可能会影响到应用的使用

2、为了防止 Client SecretToken 泄密,请求需要由第三方后台服务发起

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
1
2
3
4
5
6
7
8
上次编辑于: 2024年9月10日 14:07
贡献者: mylochen , livlin , muyanyang , yungli