OAuth2.0授权流程的获取访问令牌。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /v2/oauth/token
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
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"
}
错误码
访问错误中心查看更多错误码。