OAuth2.0授权流程的获取访问令牌。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /v2/oauth/token HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
grant_type | string | 是 | 授权类型,有以下取值: authorization_code (通过认证完成后获取的 code 来换取 token) refresh_token(通过上次授权获取的 refresh_token 来获取 token) urn:ietf:params:oauth:grant-type:jwt-bearer(通过 JWT 方式获取 token) | refresh_token |
code | string | 否 | 认证完成后回调地址中携带的 code,当 grant_type 为 authorization_code 时,此参数必传 | 0045157fa8e24f4f9a0d9e3ff158c1e0 |
redirect_uri | string | 否 | 填写发起 authorize 时传入的 redirect_uri,当 grant_type 为 authorization_code 时必填 | https://aliyun.com/pds |
client_id | string | 是 | 在阿里云 PDS 控制台申请的 App 对应的 ID | 1Zu***flH |
client_secret | string | 否 | 在阿里云 PDS 控制台申请的 App 对应的 Secret,WebServer 类型的 App 必填此参数 | 80D***3i5 |
refresh_token | string | 否 | 用于刷新 Token 的令牌,当 grant_type 为 refresh_token 时此参数必传 | 399623e13353490391266c7d48a13ed1 |
assertion | string | 否 | 通过 JWT 私钥签名的字符串,里面包含待授权的用户信息和授权参数,结构参考 JWTPayload。当 grant_type 为 urn:ietf:params:oauth:grant-type:jwt-bearer 时此参数必填。 | ey***asd |
返回参数
示例
正常返回示例
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
}
错误码
访问错误中心查看更多错误码。