Token - 获取访问令牌

OAuth2.0授权流程的获取访问令牌。

接口说明

详细使用方法参考用户指南:用户指南链接

JWT 方式登录参考文档: JWT 登录链接

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /v2/oauth/token HTTP/1.1

请求参数

名称类型必填描述示例值
grant_typestring

授权类型,有以下取值:

authorization_code (通过认证完成后获取的 code 来换取 token)

refresh_token(通过上次授权获取的 refresh_token 来获取 token)

urn:ietf:params:oauth:grant-type:jwt-bearer(通过 JWT 方式获取 token)

refresh_token
codestring

认证完成后回调地址中携带的 code,当 grant_type 为 authorization_code 时,此参数必传

0045157fa8e24f4f9a0d9e3ff158c1e0
redirect_uristring

填写发起 authorize 时传入的 redirect_uri,当 grant_type 为 authorization_code 时必填

https://aliyun.com/pds
client_idstring

在阿里云 PDS 控制台申请的 App 对应的 ID

1Zu***flH
client_secretstring

在阿里云 PDS 控制台申请的 App 对应的 Secret,WebServer 类型的 App 必填此参数

80D***3i5
refresh_tokenstring

用于刷新 Token 的令牌,当 grant_type 为 refresh_token 时此参数必传

399623e13353490391266c7d48a13ed1
assertionstring

通过 JWT 私钥签名的字符串,里面包含待授权的用户信息和授权参数,结构参考 JWTPayload。当 grant_type 为 urn:ietf:params:oauth:grant-type:jwt-bearer 时此参数必填。

ey***asd

返回参数

名称类型描述示例值
Token

访问令牌信息

示例

正常返回示例

JSON格式

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs",
  "refresh_token": "060e78d36afb4879b51e4264e9541c16",
  "expires_in": 3600,
  "token_type": "Bearer",
  "user_id": "DING-xxxxx",
  "user_name": "pdsuser",
  "avatar": "aliyunpds.com/a.jpg",
  "nick_name": "pdsuser",
  "default_drive_id": "1",
  "role": "admin",
  "status": "enabled",
  "expire_time": "2019-09-01T06:57:48.813Z",
  "is_first_login": false,
  "device_id": "8574ecc3d4904dc095cc49202e74db94",
  "device_name": "4683C25F",
  "domain_id": "bj1",
  "default_sbox_drive_id": "1",
  "user_data": {
    "key": ""
  },
  "pin_setup": false,
  "need_rp_verify": false,
  "state": "klafhjas-asdasd-asd-as-d-asd-asd-asdasd",
  "exist_link": [
    {
      "type": "",
      "identity": "",
      "extra": ""
    }
  ],
  "need_link": false
}

错误码

访问错误中心查看更多错误码。