Project

open_qq

0.0
No commit activity in last 3 years
No release in over 3 years
腾讯开放平台ruby版SDK(v3版本)http://open.qq.com/
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
>= 0

Runtime

 Project Readme

open_qq

腾讯开放平台ruby版SDK(v3版本)

安装

gem install open_qq

使用

使用非常简单,传入应用的appid, appkey和环境地址env

require 'rubygems'
require 'open_qq'

OpenQq.setup(:appid => '123', :appkey => '456', :env => 'http://119.147.19.43')

# 或者https
OpenQq.setup(:appid => '123', :appkey => '456', :env => 'https://119.147.19.43')

# get请求
user_info = OpenQq.get('/v3/user/get_info', :openid => '111',:openkey => '222')

# 或者post请求
user_info = OpenQq.post('/v3/user/get_info',:openid => '111',:openkey => '222')

user_info.ret # => 0
user_info.nickname # => 'foo'

如果你只想原样返回未加工的数据,使用raw => true

user_info = OpenQq.post('/v3/user/get_info', {:openid => '111', :openkey => '222'}, :raw => true)
puts user_info
# => '{ "ret": 0, "is_lost": 0, "nickname": "foo" }'

如果你不想使用全局的配置

options   = {:appid => 'newappid', :appkey => 'newappkey', :env => 'http://newenv'}

user_info = OpenQq.call('/v3/user/get_info', options) do |request|
  
  request.get {:openid => '111',:openkey => '222'}

  #或者
  request.post {:openid => '111',:openkey => '222'}

end

user_info.nickname
# => 'foo'

回调协议签名验证

params = {openid: 'test001', appid: '33758', sig: 'VvKwcaMqUNpKhx0XfCvOqPRiAnU%3D'}
OpenQq.verify_callback_sig(:get, '/cgi-bin/temp.py', params)
# => true or false

#指定特定的appkey
OpenQq.verify_callback_sig(:get, '/cgi-bin/temp.py', params, 'xxxxxx')

# 在rails中使用
class OpenQqController < ApplicationController
  include OpenQq::Rails::ActionController

  def index
    if verify_callback_sig
      ...do something
    end
  end
end

在rails中使用

首先在Gemfile中添加

gem 'open_qq'

执行bundle install

在config目录下生成配置文件config/open_qq.yml

rails g open_qq:install

在配置文件中填入appid, appkey和env的值,启动服务后全局都可以使用,例如:

class OpenQqController < ApplicationController
  
  # 假设这里是应用的入口
  def index
    user_info = OpenQq.post('/v3/user/get_info', params.slice!(:action, :controller))
    if user_info.ret == 0
      # do something
    end
  end

end

注意和说明

  • 当传入的format为xml时,不会对返回的结果做处理,直接字符串返回
  • 当传入的format不为xml时,会使用JSON#parse转换成hash,并且使用OpenStruct封装
  • 当ret返回2001时,是由本api抛出
  • 关于signature verification failed,先仔细对照文档
可以通过联调工具看下签名是否一致

OpenQq.setup(:appid => '123', :appkey => '456', :env => 'http://119.147.19.43')
opts = {:openid => '1111',:openkey => '2222',:pf => 'pengyou'}
sig = OpenQq.wrap(:post, '/v3/user/get_info', opts)[:sig]

puts sig # 与联调结果比对

  • 如果不想使用open_qq.yml,只要在使用前全局配置好OpenQq即可
  • 测试基本覆盖,可以下载下来执行rake
  • bug反馈Issue

Changelog

  • 2012/09/11 增加对https的支持 支持支付回调协议签名验证

This project rocks and uses MIT-LICENSE.