OAuth2的authorize接口
URL
https://api.weibo.com/oauth2/authorize
HTTP请求方式
GET/POST
请求参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
client_id | true | string | 申请应用时分配的AppKey。 |
redirect_uri | true | string | 授权回调地址,站外应用需与设置的回调地址一致,站内应用需填写canvas page的地址。 |
scope | false | string | 申请scope权限所需参数,可一次申请多个scope权限,用逗号分隔。 |
state | false | string | 用于保持请求和回调的状态,在回调时,会在Query Parameter中回传该参数。开发者可以用这个参数验证请求有效性,也可以记录用户请求授权页前的位置。这个参数可用于防止跨站请求伪造(CSRF)攻击 |
display | false | string | 授权页面的终端类型,取值见下面的说明。 |
forcelogin | false | boolean | 是否强制用户重新登录,true:是,false:否。默认false。 |
language | false | string | 授权页语言,缺省为中文简体版,en为英文版。英文版测试中,开发者任何意见可反馈至 @微博API |
display说明:
参数取值 | 类型说明 |
---|---|
default | 默认的授权页面,适用于web浏览器。 |
mobile | 移动终端的授权页面,适用于支持html5的手机。注:使用此版授权页请用 https://open.weibo.cn/oauth2/authorize 授权接口 |
wap | wap版授权页面,适用于非智能手机。 |
client | 客户端版本授权页面,适用于PC桌面应用。 |
apponweibo | 默认的站内应用授权页,授权后不返回access_token,只刷新站内应用父框架。 |
返回数据
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
code | string | 用于第二步调用oauth2/access_token接口,获取授权后的access token。 |
state | string | 如果传递参数,会回传该参数。 |
示例
//同意授权后会重定向
http://www.example.com/response&code=CODE
参数 scope 说明
scope是OAuth2.0授权机制中authorize接口的一个参数。
通过scope,平台将开放更多的微博核心功能给开发者,同时也加强用户隐私保护,提升了用户体验,用户在新OAuth2.0授权页中有权利选择赋予应用的功能。
注意事项
1:开发者需要先在应用控制台的接口管理中申请到相关的接口,才能使用scope功能,如果没有接口权限,调用时候会遇到10014错误。
2:满足上一条后,开发者向用户请求scope权限,就会出现高级授权页面(如下图),当用户允许后就能正常使用接口,反之会遇到10032错误。
scope权限接口
可一次申请多个scope权限,用逗号分隔。
scope参数 | 描述 |
---|---|
all | 请求下列所有scope权限 |
用户的联系邮箱,接口文档 | |
direct_messages_write | 私信发送接口,接口文档 |
direct_messages_read | 私信读取接口,接口文档 |
invitation_write | 邀请发送接口,接口文档 |
friendships_groups_read | 好友分组读取接口组,接口文档 |
friendships_groups_write | 好友分组写入接口组,接口文档 |
statuses_to_me_read | 定向微博读取接口组,接口文档 |
follow_app_official_microblog | 关注应用官方微博,该参数不对应具体接口,只需在应用控制台填写官方帐号即可。填写的路径:我的应用-选择自己的应用-应用信息-基本信息-官方运营账号(默认值是应用开发者帐号) |
相关错误代码
错误码(error) | 错误编号(error_code) | 错误描述(error_description) | 解决方法 |
---|---|---|---|
Insufficient app permissions | 10014 | 第三方应用访问api接口权限受限制 | 应用没有接口的权限,需要在应用控制台接口管理那在线申请 |
access_denied | 10032 | 用户或授权服务器拒绝授予数据访问权限 | 重新向用户申请scope权限 |
相关地址