开发文档

1. 概述

如果百度用户访问第三方应用网页，则第三方应用可以通过网页授权机制，来获取百度用户基本信息，进而实现自身业务功能。

具体而言，百度帐号网页授权流程分为四步：

1. 引导用户进入授权页面同意授权，获取code；

2. 通过code换取网页授权access_token；

3. 如果需要，开发者可以刷新网页授权access_token，避免过期；

4. 通过网页授权access_token获取用户基本信息。

2. 引导用户完成授权获取code

开发时，需要将用户浏览器重定向到如下URL地址。

接口调用请求说明：

GET https://openapi.baidu.com/oauth/2.0/authorize?response_type=CODE&client_id=API_KEY&redirect_uri=REDIRECT_URI&scope=SCOPE&state=STATE

参数说明：

下图为登录授权页面：

无scope权限或redirect_uri不合法时，会展示错误页面，并提示出错原因，如下图示：

用户同意授权后：页面将跳转至redirect_uri/?code=CODE&state=STATE。

code说明：code作为换取access_token的票据，每次用户授权带上的code将不一样，code只能使用一次，10分钟未被使用自动过期。

3. code获取授权access_token

redirect_uri指定的开发者服务器地址，在获取到授权code参数后，从服务端向百度开放平台发起如下HTTP请求，通过code换取网页授权access_token。

注意：access_token长度保留256字符。

接口调用请求说明：

GET https://openapi.baidu.com/oauth/2.0/token?grant_type=authorization_code&code=CODE&client_id=AP I_KEY&client_secret=SECRET_KEY&redirect_uri=REDIRECT_URI    

参数说明：

返回值说明：

错误情况下：

返回值示例：

{  
     "access_token":  "1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328",  
     "expires_in":  86400,  
     "refresh_token":  "2.385d55f8615fdfd9edb7c4b5ebdc3e39.604800.1293440400-2346678-124328",               
     "scope":  "basic  email",  
     "session_key":  "ANXxSNjwQDugf8615OnqeikRMu2bKaXCdlLxn",  
     "session_secret":  "248APxvxjCZ0VEC43EYrvxqaK4oZExMB"  
} 

出错时返回：

{  
     "error":  "invalid_grant",  
     "error_description":  "Invalid  authorization  code:  ANXxSNjwQDugOnqeikRMu2bKaXCdlLxn"   
} 

4. 按需刷新access_token

当access_token过期后，可以使用refresh_token进行刷新。refresh_token有效期为十年。

接口调用请求说明：

GET https://openapi.baidu.com/oauth/2.0/token?grant_type=refresh_token&refresh_token=REFRESH_TOKEN &client_id=API_KEY&client_secret=SECRET_KEY 

参数说明：

返回值说明：

错误情况下：

返回值示例：

{  
     "access_token":  "1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328",               
     "expires_in":  86400,  
     "refresh_token":  "2.af3d55f8615fdfd9edb7c4b5ebdc3e32.604800.1293440400-2346678-124328",               
     "scope":  "basic  email",  
     "session_key":  "ANXxSNjwQDugf8615OnqeikRMu2bKaXCdlLxn",  
     "session_secret":  "248APxvxjCZ0VEC43EYrvxqaK4oZExMB"  
} 

出错时返回：

{
     "error": "expired_token",
     "error_description": "refresh token has been used"
}

5. 获取授权用户信息

获取access_token之后，开发者可以通过access_token拉取用户信息。

接口调用请求说明：

GET https://openapi.baidu.com/rest/2.0/passport/users/getInfo?access_token=access_token 

参数说明：

返回参数：

错误情况下：

关于错误码的详细信息请参考附录Ⅰ-5.4

返回值示例：

{    
     "openid": "oPXyY4O0ZTmUqSX4MRxYDDCccT6Kc9E",
     "unionid": "uA91qQ6gAISTuy0mMqoeh7lZ0w6x478",
     "userid": "2097322476",
     "username": "u***9",
     "userdetail": "喜欢自由", 
     "birthday": "1987-01-01",
     "marriage": "0",
     "sex": "1",
     "blood": "3",
     "is_bind_mobile": "1",
     "is_realname": "1" 
}

出错时返回：

{  
     "error_code": "100",  
     "error_msg": "Invalid parameter"   
}