2015年7月15日 (三) 12:05的版本

授权机制

OAuth2.0概述

接口文档

注意事项

• • 1、OAuth2.0授权无需申请，任何应用都可以使用。如果开发者需要更长的授权有效期参考本文档授权有效期部分。
  • 2、如果你是站外网页应用或客户端应用，出于安全性考虑，需要在平台网站填写redirect_url（授权回调页），才能使用OAuth2.0，填写地址：“我的应用>应用信息>高级信息”，对于客户端，我们也提供了默认的回调页地址。详细请查看授权页功能部分。

授权界面

应用场景

https://api.weibo.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&response_type=code&redirect_uri=YOUR_REGISTERED_REDIRECT_URI

https://api.weibo.com/oauth2/access_token?client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=authorization_code&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&code=CODE

{
    "access_token": "SlAV32hkKG",
    "remind_in": 3600,
    "expires_in": 3600
}

授权有效期

授权级别和OAuth2.0 access_token有效期对应表：

注：

• 1、只有未过审核的应用才处于测试级别。
• 2、应用所属开发者授权应用时，有效期为5年。

你可以在 “我的应用>接口管理>授权机制” 上查询当前应用的授权级别。也可以在这里申请提高授权有效期。

开发者可以通过两种方式计算access_token的实效时间：

• 1、用户授权时，oauth2/access_token接口返回的expires_in值就是access_token的生命周期；
• 2、从上述对应表中，找到应用所对应的授权有效期，过期时间 = 用户授权时间 + 授权有效期；

第三方开发应用需要具备一定的健壮性，调用接口时判断接口的返回值，如果用户的access_token失效，需要引导用户重新授权。

失效原因有以下几个：

• 1、用户取消了对应用的授权；
• 2、access_token自然过期；
• 3、用户修改了密码，冻结了对应用的授权；
• 4、微博发现用户帐号被盗，冻结了用户对应用的授权；

授权有效期的延续

{
    "access_token": "SlAV32hkKG",
    "remind_in": 3600,
    "expires_in": 3600
    "refresh_token": "QXBK19xm62"
}

https://api.weibo.com/oauth2/access_token?client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=refresh_token&redirect_uri=YOUR_REGISTERED_REDIRECT_URI&refresh_token=…

返回值

{
    "access_token": "SlAV32hkKG",
    "expires_in": 3600
}

使用OAuth2.0调用API

https://api.weibo.com/2/statuses/public_timeline.json?access_token=abcd

授权中的其他功能

Scope

客户端默认回调页

强制登录

取消授权回调页

OAuth2.0相关资源

以下SDK包含了OAuth2.0及新版API接口

移动开发SDK说明文档

其他参考资料

OAuth是一种国际通用的授权方式， OAuth2.0的官方技术说明可参看 http://oauth.net/2/

如果你仍在使用Oauth1.0，请进入浏览相关文档。

OAuth2.0 错误码

微博OAuth2.0实现中，授权服务器在接收到验证授权请求时，会按照OAuth2.0协议对本请求的请求头部、请求参数进行检验，若请求不合法或验证未通过，授权服务器会返回相应的错误信息，包含以下几个参数：

• error: 错误码
• error_code: 错误的内部编号
• error_description: 错误的描述信息
• error_url: 可读的网页URI，带有关于错误的信息，用于为终端用户提供与错误有关的额外信息。

错误信息的返回方式有两种：

1. 当请求授权Endpoint：https://api.weibo.com/2/oauth2/authorize 时出现错误，返回方式是：跳转到redirect_uri，并在uri 的query parameter中附带错误的描述信息。

2. 当请求access token endpoing:https://api.weibo.com/oauth2/access_token 时出现错误，返回方式：返回JSON文本。例如：

{
    "error": "unsupported_response_type",
    "error_code": 21329,
    "error_description": "不支持的ResponseType."
}

OAuth2.0错误响应中的错误码定义如下表所示：

OAuth2.0相关问题，查看 OAuth2.0相关问题