JuheRuby
聚合ruby api，目前完成了以下功能：
- 身份证实名认证
- 身份证查询
- 常用快递查询
- 电影票房
安装
在Gemfile里加入这行:
gem 'juhe_ruby'
然后执行:
$ bundle install
或者自行安装:
$ gem install juhe_ruby
用法
先创建文件config/initializers/juhe_ruby_config.rb设置各接口的app_key
Juhe::IdVerify.app_key = "d85fa433fb8f30419dc1b3697b035b3d"
Juhe::IdCard.app_key = "d85fa433fb8f30419dc1b3697b035b3d"
Juhe::Express.app_key = "d85fa433fb8f30419dc1b3697b035b3d"
Juhe::Boxoffice.app_key = "d85fa433fd8430419dc1b3697b035b3d"
身份证实名认证
如果事先设置了app_key，就直接进行查询认证：
Juhe::IdVerify.search("32010819820114203X","王大锤")
或者直接将app_key作为参数：
Juhe::IdVerify.search("32010819820114203X","王大锤", app_key: "54be350eb2fdefe5a9a087bf6669cc68")
应答后返回的json格式，如果请求失败会抛出异常：
{
"realname": "董好帅", # 真实姓名
"idcard": "330329199001020012", # 身份证号码
"res": 1 # 1：匹配 2：不匹配
}
获取应答结果的方式：
result=Juhe::IdVerify.search("32010819820114203X","王大锤")
if(result["res"] == 0)
puts "实名认证匹配通过"
else if(result["res"] == 1)
puts "实名认证匹配未通过"
end
身份证查询
如果事先设置了app_key，就直接进行查询认证：
Juhe::IdCard.search("32010819820114203X")
或者直接将app_key作为参数：
Juhe::IdCard.search("32010819820114203X", app_key: "54be350eb2fdefe5a9a087bf6669cc68")
应答后返回的json格式，如果请求失败会抛出异常：
{
"area":"浙江省温州市平阳县",
"sex":"男",
"birthday":"1989年03月08日"
}
获取应答结果的方式：
result=Juhe::IdCard.search("32010819820114203X")
pust(result["area"])
常用快递查询
目前支持的快递公司，%w[顺丰 申通 圆通 韵达 天天 EMS 中通 汇通]详细的请在聚合页面上查看。
api在第一次查询时也会调用快递公司查询接口。
如果事先设置了app_key，就直接进行查询认证：
Juhe::Express.search("顺丰", "575677355677")
或者直接将app_key作为参数：
Juhe::Express.search("顺丰", "575677355677", app_key: "d85fa433fb8f30419dc1b3697b035b3d")
返回Hash数组：
[
{
"datetime":"2013-06-25 10:44:05", # 时间
"remark":"已收件", # 描述
"zone":"台州市" # 区域
},
{
"datetime":"2013-06-25 11:05:21",
"remark":"快件在 台州 ,准备送往下一站 台州集散中心 ",
"zone":"台州市"
},
{
"datetime":"2013-06-25 20:36:02",
"remark":"快件在 台州集散中心 ,准备送往下一站 台州集散中心 ",
"zone":"台州市"
},
{
"datetime":"2013-06-25 21:17:36",
"remark":"快件在 台州集散中心 ,准备送往下一站 杭州集散中心 ",
"zone":"台州市"
},
{
"datetime":"2013-06-26 12:20:00",
"remark":"快件在 杭州集散中心 ,准备送往下一站 西安集散中心 ",
"zone":"杭州市"
},
{
"datetime":"2013-06-27 05:48:42",
"remark":"快件在 西安集散中心 ,准备送往下一站 西安 ",
"zone":"西安市/咸阳市"
},
{
"datetime":"2013-06-27 08:03:03",
"remark":"正在派件..",
"zone":"西安市/咸阳市"
},
{
"datetime":"2013-06-27 08:51:33",
"remark":"派件已签收",
"zone":"西安市/咸阳市"
},
{
"datetime":"2013-06-27 08:51",
"remark":"签收人是：已签收 ",
"zone":"西安市/咸阳市"
}
]
程序第一次运行会获取快递公司列表，如果想手动刷新快递公司信息：
Juhe::Express.refresh_companies
# or
Juhe::Express.refresh_companies(app_key: "d85fa433fb8f30419dc1b3697b035b3d")
电影票房
最新票房榜
票房榜的区域,CN-内地，US-北美，HK-香港。 示例：
Juhe::Boxoffice.latest("HK") # 香港最新票房榜
# 或者app_key直接作为参数
Juhe::Boxoffice.latest("HK", app_key: "d85fa433fd8430419dc1b3697b035b3d") # 香港最新票房榜
返回Hash数组：
[
{
"rid":"1",
"name":"中国合伙人",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥20900万",
"tboxoffice":"￥31700万"
},
{
"rid":"2",
"name":"钢铁侠3",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥4480万",
"tboxoffice":"￥74480万"
},
{
"rid":"3",
"name":"疯狂原始人",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥3050万",
"tboxoffice":"￥35240万"
},
{
"rid":"4",
"name":"遗落战境",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥2680万",
"tboxoffice":"￥13980万"
},
{
"rid":"5",
"name":"致我们终将逝去的青春",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥2290万",
"tboxoffice":"￥71206万"
},
{
"rid":"6",
"name":"圣诞玫瑰(new)",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥1390万",
"tboxoffice":"￥1390万"
},
{
"rid":"7",
"name":"一路狂奔(new)",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥350万",
"tboxoffice":"￥350万"
},
{
"rid":"8",
"name":"被解救的姜戈",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥309万",
"tboxoffice":"￥1664万"
},
{
"rid":"9",
"name":"临终囧事",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥285万",
"tboxoffice":"￥660万"
},
{
"rid":"10",
"name":"西柏坡2：王二小",
"wk":"2013.5.20--2013.5.26（单位：人民币）",
"wboxoffice":"￥25万",
"tboxoffice":"￥45万"
}
]
网票票房
示例：
Juhe::Boxoffice.wp # 网票票房
# 或者app_key直接作为参数
Juhe::Boxoffice.wp(app_key: "d85fa433fd8430419dc1b3697b035b3d") # 网票票房
返回Hash数组：
[
{
"name": "惊天危机（数字）", # 影片名称
"totals": "2262", # 总场次
"statistics": "1111", # 统计场次
"averaging": "27", # 场均
"attendance": "15%", # 上座率
"people": "29999", # 人次
"fare": "39", # 票价（元）
"boxoffice": "1164731" # 票房（元）
},
{
"name": "大明猩（数字3D）",
"totals": "1278",
"statistics": "613",
"averaging": "21",
"attendance": "13%",
"people": "12726",
"fare": "48",
"boxoffice": "607759"
}
]