Oauth2/authorize
第21行: | 第21行: | ||
{{api_args|display|false|string|授权页面的终端类型,取值见下面的说明。}} | {{api_args|display|false|string|授权页面的终端类型,取值见下面的说明。}} | ||
|} | |} | ||
+ | |||
;display说明: | ;display说明: | ||
{| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" | {| border="1" cellspacing="0" cellpadding="0" width="100%" class="parameters" style="border-color: #CCCCCC;" | ||
|- | |- | ||
− | !width="30%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"| | + | !width="30%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|参数取值 |
!width="70%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|类型说明 | !width="70%" style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|类型说明 | ||
− | + | |- | |
− | + | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|default | |
− | + | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|默认的授权页面,适用于web浏览器。 | |
− | + | |- | |
− | + | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|mobile | |
− | + | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|移动终端的授权页面,适用于支持html5的手机。 | |
− | + | |- | |
+ | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|popup | ||
+ | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|弹窗类型的授权页,适用于web浏览器小窗口。 | ||
+ | |- | ||
+ | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|wap1.2 | ||
+ | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|wap1.2的授权页面。 | ||
+ | |- | ||
+ | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|wap2.0 | ||
+ | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|wap2.0的授权页面。 | ||
+ | |- | ||
+ | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|js | ||
+ | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|微博JS-SDK专用授权页面,弹窗类型,返回结果为JSONP回掉函数。 | ||
+ | |- | ||
+ | |style="text-align:left;padding-left:5px;font-weight:bolder;border:1px solid #cccccc"|apponweibo | ||
+ | |style="text-align:left;padding-left:5px;border:1px solid #cccccc"|站内应用专用,站内应用不传display参数,并且response_type为token时,默认使用该类型,授权后不返回access_token,只刷新站内应用父框架。 | ||
|} | |} | ||
第71行: | 第86行: | ||
:同意授权后会重定向 | :同意授权后会重定向 | ||
:http://www.example.com/response&code=CODE | :http://www.example.com/response&code=CODE | ||
+ | |||
+ | |||
+ | |||
+ | __NOTOC__ |
2011年12月9日 (五) 15:01的版本
oauth2/authorize
OAuth2的authorize接口
URL
https://api.weibo.com/oauth2/authorize
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中回传该参数。 |
display | false | string | 授权页面的终端类型,取值见下面的说明。 |
- display说明:
参数取值 | 类型说明 |
---|---|
default | 默认的授权页面,适用于web浏览器。 |
mobile | 移动终端的授权页面,适用于支持html5的手机。 |
popup | 弹窗类型的授权页,适用于web浏览器小窗口。 |
wap1.2 | wap1.2的授权页面。 |
wap2.0 | wap2.0的授权页面。 |
js | 微博JS-SDK专用授权页面,弹窗类型,返回结果为JSONP回掉函数。 |
apponweibo | 站内应用专用,站内应用不传display参数,并且response_type为token时,默认使用该类型,授权后不返回access_token,只刷新站内应用父框架。 |
返回数据
- 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
- 请求
- https://api.t.sina.com.cn/oauth2/authorize?client_id=123050457758183&redirect_uri=http://www.example.com/response&response_type=code
- 同意授权后会重定向
- http://www.example.com/response&code=CODE