使用OAuth2.0訪問豆瓣API

豆瓣支持OAuth2.0協(xié)議的授權(quán)訪問。關(guān)于OAuth2.0協(xié)議規(guī)范，請(qǐng)參考這里。

使用OAuth2.0的流程可以簡單概括為：

1. 應(yīng)用向豆瓣請(qǐng)求授權(quán)
2. 豆瓣為用戶顯示一個(gè)授權(quán)頁面，用戶在此頁面確認(rèn)是否同意應(yīng)用的請(qǐng)求
3. 如果用戶同意授權(quán)，應(yīng)用會(huì)獲取到一個(gè)訪問令牌(access_token)，通過此令牌，應(yīng)用可以訪問授權(quán)用戶的數(shù)據(jù)。
4. 如果訪問需要授權(quán)的Api，請(qǐng)使用https協(xié)議，加上access_token的Header，具體見獲取access_token

豆瓣支持三種OAuth2.0的授權(quán)流程：

• 服務(wù)器的WEB應(yīng)用的授權(quán)流程（server-side flow）
• 桌面客戶端應(yīng)用、移動(dòng)客戶端應(yīng)用的授權(quán)流程（native-application flow）
• 直接在瀏覽器中運(yùn)行的Javascript應(yīng)用的授權(quán)流程（user-agent flow）

flow 與 native-application flow

這兩種授權(quán)流程基本相同，需要通過兩步來獲取access_token。

獲取authorization_code

通過在瀏覽器中訪問下面的地址，來引導(dǎo)用戶授權(quán)，并獲得authorization_code

https://www.douban.com/service/auth2/auth

參數(shù)：

注意：此請(qǐng)求必須是HTTP GET方式

例如：

https://www.douban.com/service/auth2/auth?  client_id=0b5405e19c58e4cc21fc11a4d50aae64&  redirect_uri=https://www.example.com/back&  response_type=code&  scope=shuo_basic_r,shuo_basic_w,douban_basic_common

返回結(jié)果：

• 當(dāng)用戶拒絕授權(quán)時(shí)，瀏覽器會(huì)重定向到redirect_uri，并附加錯(cuò)誤信息

  https://www.example.com/back?error=access_denied

• 當(dāng)用戶同意授權(quán)時(shí)，瀏覽器會(huì)重定向到redirect_uri，并附加autorization_code

  https://www.example.com/back?code=9b73a4248

獲取access_token

https://www.douban.com/service/auth2/token

注意：此請(qǐng)求必須是HTTP POST方式

例如：

https://www.douban.com/service/auth2/token?  client_id=0b5405e19c58e4cc21fc11a4d50aae64&  client_secret=edfc4e395ef93375&  redirect_uri=https://www.example.com/back&  grant_type=authorization_code&  code=9b73a4248

返回結(jié)果：

{  "access_token":"a14afef0f66fcffce3e0fcd2e34f6ff4",  "expires_in":3920,  "refresh_token":"5d633d136b6d56a41829b73a424803ec",  "douban_user_id":"1221"}

使用access_token

curl "https://api.douban.com/v2/user/~me"     -H "Authorization: Bearer a14afef0f66fcffce3e0fcd2e34f6ff4"

access_token有效期 與 refresh_token

在OAuth2.0中，access_token不再長期有效。在授權(quán)獲取access_token時(shí)會(huì)一并返回其有效期，也就是返回值中的expires_in參數(shù)。

在access_token使用過程中，如果服務(wù)器返回106錯(cuò)誤：“access_token_has_expired ”，此時(shí)，說明access_token已經(jīng)過期，除了通過再次引導(dǎo)用戶進(jìn)行授權(quán)來獲取access_token外，還可以通過refresh_token的方式來換取新的access_token和refresh_token。

通過refresh_token換取access_token的處理過程如下：

https://www.douban.com/service/auth2/token

注意：此請(qǐng)求必須是HTTP POST方式，refresh_token只有在access_token過期時(shí)才能使用，并且只能使用一次。當(dāng)換取到的access_token再次過期時(shí)，使用新的refresh_token來換取access_token

例如：

https://www.douban.com/service/auth2/token?  client_id=0b5405e19c58e4cc21fc11a4d50aae64&  client_secret=edfc4e395ef93375&  redirect_uri=https://www.example.com/back&  grant_type=refresh_token&  refresh_token=5d633d136b6d56a41829b73a424803ec

返回結(jié)果：

{  "access_token":"0e63c03dfb66c4172b2b40b9f2344c45",  "expires_in":3920,  "refresh_token":"84406d40cc58e0ae8cc147c2650aa20a",  "douban_user_id":"1000"}

需要授權(quán)的Api訪問速度控制

在用戶、應(yīng)用、服務(wù)器IP、scope等維度對(duì)接口的訪問速度進(jìn)行限制。

針對(duì)服務(wù)器IP:

針對(duì)單用戶每應(yīng)用每scope：

返回結(jié)果的header里會(huì)有當(dāng)前訪問限制信息：

錯(cuò)誤代碼

如果在API使用過程中，有錯(cuò)誤，則返回結(jié)果為：

{  "code":113,  "msg":"required_parameter_is_missing: client_id",  "request":"GET /shuo/statuses/232323"}