by simsicon

simsicon / weibo_2

A ruby gem for sina weibo oauth2 api, with examples, and it actually works.

201 Stars 89 Forks Last release: Not found MIT License 95 Commits 7 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Note: I got a lot of inspiration from this gem and this gem. The first one will soon be deprecated since weibo is planning to switch to oauth2. The second one has not been fully implemented and is still lacking some features (but a nice try nevertheless). Thanks Scott and acenqiu.


WeioOAuth2 is a Ruby gem that provides a wrapper for interacting with sina weibo's v2 API, which is currently the latest version. Check out the link if you are interested in browsing the details. The output data format is Hashie::Mash, check out here. If you are not familiar with oauth2, I recommend that you read this article.


  1. weibo account
  2. weibo app API key
  3. weibo app API secret


I call it weibo2 because someone else took the name weibooauth2.

$ gem install weibo_2

Basic Usage

The example have been moved to here. It wiil be more convenient to update.

The example written with sinatra shows how to ask for oauth2 permission, get the token and send status with picture. It should cover basic usage in all ruby apps. You can run your own demo!

$ KEY=change_this_to_your_key SECRET=change_this_to_your_secret REDIR_URI=change_this_to_your_redir_uri ruby example.rb

It should work.

  1. How to get the token?

    OAuth2 is simpler than its first version. In order to get the access token, you first need to get an Authorization Code through a callback request. Now use the following code to get the token.

    WeiboOAuth2::Config.api_key = YOUR_KEY
    WeiboOAuth2::Config.api_secret = YOUR_SECRET
    WeiboOAuth2::Config.redirect_uri = YOUR_CALLBACK_URL

    If you are developing in your localhost, you can set YOURCALLBACKURL as '' something. Then set your weibo app account's callback URL as this URL too. Weibo will call the URL using GET method, which will then enable you to retrieve the authorization code.

    client =  

    Or you can pass the key and secret to new a client if you did not set WeiboOAuth2::Config

    Redirect to this URL. If user grants you permission, then you will get the authorization code.


    In your callback handling method, you should add something like the following,


    which will give permission to your client.

  2. How to post a status with picture? (or call other interfaces)

    Simply update a status


    Upload a picture.

    pic = params[:file].delete(:tempfile)
    client.statuses.upload(params[:status], pic, params[:file])

    pass params[:file] into upload method as options could help weibo_2 to build post body, useful options as:

    • filename, filename with extension of the uploading file, example 'pic.jpg'
    • type, mime type of the uploading file, example 'image/jpeg'

Setting up SSL certificates

This gem using faraday for connection, which supports ssl. According to this article, you can do as following to support ssl connection.


To locate your SSL certificate folder, type

openssl version -a
. Append
to the OPENSSLDIR listed, here it would be
    client =, YOUR_SECRET, :ssl => {:ca_path => "/usr/lib/ssl/certs"})
    # or as below if you have set WeiboOAuth2::Config.api_key and WeiboOAuth2::Config.api_secret already
    # client ='', '', :ssl => {:ca_path => "/usr/lib/ssl/certs"})

On Heroku, Fedora, CentOS

    client =, YOUR_SECRET, :ssl => {:ca_file => '/usr/lib/ssl/certs/ca-certificates.crt'})
    # or as below if you have set WeiboOAuth2::Config.api_key and WeiboOAuth2::Config.api_secret already
    # client ='', '', :ssl => {:ca_file => '/usr/lib/ssl/certs/ca-certificates.crt'})

For Fedora and CentOS, use the path and file

instead, or find your system path with
openssl version -a

Integrate with Devise and omniauth

  1. Install gems in Gemfile
     gem 'devise'
     gem 'omniauth'
     gem 'omniauth-weibo-oauth2'
     gem 'weibo_2'
  1. In devise initailize file config/initiallizers/devise.rb, add a line into setup block, please replace key and secret with yours.
     config.omniauth :weibo, 'key', 'secret', :scope => 'user,public_repo'
  1. Then you should handle omini callback controller by yourself, there is sample project show how to integrate devise and omniauth you can follow devise-omniauth-example

  2. After get the callback data, you will see

    has the value
    , store them into session or record,now you can use WeiboOAuth2 in anywhere:
     client =
     statuses = client.statuses
     statuses.update('just test from my app')

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.