Baidu SDK for Ruby

Unofficial Baidu REST API SDK for Ruby. 非官方百度开放接口 Ruby 开发包。

安装

如果你通过 Bundler 来管理你的应用，添加如下一行到应用的 Gemfile 中：

gem 'baidu-sdk'

然后在终端执行：

$ bundle

或者直接安装：

$ gem install baidu-sdk

baidu-sdk 当前支持 Ruby(MRI) 版本：1.9.3, 2.0.0

使用简介

baidu-sdk api doc

本项目根据百度开放接口划分成多个独立模块，如：Baidu::OAuth, Baidu::PCS等等。

Hash 必须使用 symbol key，无论是返回值或作为参数传递给方法。

涉及到调用 Baidu REST API 并返回 Hash 时，除非特别说明，Hash 是在原始 API 返回的 JSON 结果之上 parse(JSON.parse(resp.body, symbolize_names: true)) 而来，Hash 和 JSON 拥有相同的结构，返回的具体结构可以参考各个方法的 API Doc。如：

# 返回的原始 JSON
#   {"quota":15000000000,"used":5221166,"request_id":4043312634}
result = pcs_client.quota
result[:quota]  # => 15000000000
result[:used]   # => 5221166

OAuth

首先确保已经在百度开发者中心创建了应用。如果还没有创建应用，请通过此链接百度开发者中心创建一个新的应用，获取应用的 API Key 和 Secret Key。

使用全局配置方式：
```
Baidu.config do |c|
  c.client_id     = 'an_api_key'
  c.client_secret = 'a_securet_key'
end
```
此全局配置为可选方式，还可以在新建 Baidu::OAuth::Client 实例的时候指定 API Key 和 Secret Key。

创建 Baidu::OAuth::Client 实例

require 'baidu/oauth'
client = Baidu::OAuth::Client.new
# 或者
client = Baidu::OAuth::Client.new('a_client_id', 'a_client_secret')

后者创建的实例受全局配置影响

Baidu OAuth 有四种（当前实现两种）获取 Access Token 的方式，包括 Authorization Code, Implicit Grant, Client Credentials, Device以及一个刷新方式Refresh Token

client.code_flow.authorize_url  # 使用 Authorization Code 授权流程
client.code_flow.get_token      # 使用 Authorization Code 授权流程
client.device_flow.user_and_device_code  # 使用 Device 授权流程
client.device_flow.get_token             # 使用 Device 授权流程
client.refresh                           # Access Token刷新方式

Baidu::Session 包含授权信息

session = client.code_flow.get_token
session = client.device_flow.get_token
...

Authorization Code 授权流程示例：

# 1. Edit and save this snippet as code.rb
# 2. Run by: ruby coce.rb
# 3. Visit: http://localhost:4567/auth

require 'sinatra'
require 'baidu/oauth'

Baidu.config do |c|
  c.client_id     = ENV['BAIDU_CLIENT_ID']      # Change to your client_id
  c.client_secret = ENV['BAIDU_CLIENT_SECRET']  # Change to your client_secret
end

# 使用时需要到 http://developer.baidu.com/console 将此 callback 添加到应用安全设置中
callback_uri = 'http://localhost:4567/auth/callback'

get '/' do
  'Hello world!'
end

get '/auth' do
  client = Baidu::OAuth::Client.new
  redirect client.code_flow.authorize_url(callback_uri, confirm_login: true)
end

get '/auth/callback' do
  begin
    client = Baidu::OAuth::Client.new
    session = client.code_flow.get_token params[:code], callback_uri
    "auth success: #{session.access_token}"
  rescue => e
    e.to_s
  end
end

PCS

要使用 PCS 必须到百度开发者中心开启指定应用的 PCS API 权限，参考开通PCS API权限，并获取所设置的文件目录。

文件 API 已经完全实现。API 中涉及到的文件或目录路径，都是相对于开通 PCS API 权限时所设置的文件目录。比如：上传文件时需要指定文件保存路径，假设指定为 /mydata/hi.png，那么在 PCS 中实际的保存路径为 /apps/文件目录/mydata/hi.png。

全局配置

Baidu.config do |c|
    # ...
    c.pcs_dir_name = 'notes'  # 文件目录名称
    # ...
end

全局配置非强制性的，可以在创建 Baidu::PCS::Client 实例时设置

创建 Baidu::PCS::Client 实例

require 'baidu/pcs'
client = Baidu::PCS::Client.new('token_or_session')
# 或者
client = Baidu::PCS::Client.new('token_or_session', 'notes')

API 调用

File.open('/opt/ubuntu-12.04.3-server-amd64.iso', 'r') do |f|
    client.upload(f, block_upload: true)
end

异常处理

API 的异常被封装为 Baidu::Errors::Error，包含三个子类：

Baidu::Errors::AuthError # Access Token 过期或未授权
Baidu::Errors::ClientError # API 返回 400+ 错误
Baidu::Errors::ServerError # API 返回 500+ 错误

Baidu::Errors::Error => e，异常的具体信息可以通过如下方式获取到：

begin
    client.list('apitest/movies')
rescue Baidu::Errors::Error => e
    puts e.code  # 错误代码，详情参考百度开发者中心文档
    puts e.msg   # 错误描述
end

Baidu SDK for Ruby

安装

使用简介

OAuth

Authorization Code 授权流程示例：

PCS

异常处理

Copyright