Oauth2/authorize
(→URL) |
(→请求参数) |
||
| 第15行： | 第15行： | ||
{{api_args|client_id|true|string|申请应用时分配的AppKey}} | {{api_args|client_id|true|string|申请应用时分配的AppKey}} | ||
{{api_args|redirect_uri|true|string|授权后的回调地址,站外应用需与回调地址一致,站内应用需要填写canvas page的地址}} | {{api_args|redirect_uri|true|string|授权后的回调地址,站外应用需与回调地址一致,站内应用需要填写canvas page的地址}} | ||
| − | {{api_args|response_type|false|string|支持的值包括 code 和token | + | {{api_args|response_type|false|string|支持的值包括 code 和token 默认值为code}} |
{{api_args|state|false|string|用于保持请求和回调的状态。在回调时,会在Query Parameter中回传该参数}} | {{api_args|state|false|string|用于保持请求和回调的状态。在回调时,会在Query Parameter中回传该参数}} | ||
|} | |} | ||
| + | |||
==返回数据== | ==返回数据== | ||
*response_type为code | *response_type为code | ||
2011年9月8日 (四) 23:41的版本
目录 |
OAuth2/authorize
authorize接口
URL
HTTP请求方式
GET/POST
请求参数
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| client_id | true | string | 申请应用时分配的AppKey |
| redirect_uri | true | string | 授权后的回调地址,站外应用需与回调地址一致,站内应用需要填写canvas page的地址 |
| response_type | false | string | 支持的值包括 code 和token 默认值为code |
| state | false | string | 用于保持请求和回调的状态。在回调时,会在Query Parameter中回传该参数 |
返回数据
- response_type为code
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| code | true | string | 用于调用access_token接口获取授权后的access token |
| state | false | string | 如果传递参数,会回传该参数 |
- response_type为token
| 必选 | 类型及范围 | 说明 | |
|---|---|---|---|
| access_token | true | string | 用来调用其它api的授权过的accesstoken |
| expires_in | true | string | accesstoken有效期时间,unix timestamp格式 |
| refresh_token | false | string | 刷新token,如果有获取权限则返回 |
| state | false | string | 如果传递参数,会回传该参数 |
示例
- response_type为token
- 请求
- https://api.t.sina.com.cn/oauth2/authorize?client_id=123050457758183&redirect_uri=http://www.example.com/response&response_type=token
- 同意授权后会重定向
- http://www.example.com/response#access_token=ACCESS_TOKEN&expires_in=250327040&refresh_token=REFRESH_TOKEN
- response_type为code
