dian_ping 0.0.7 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 94764fd268d2738c2a9fe451f1d3463a10d51695
-  data.tar.gz: 1bb755231a039fdc22400a87171f46610f6b4129
+  metadata.gz: 0dcc6881a2d3b37f355dc67ddd6e27f6b6c4b1c9
+  data.tar.gz: 4ed633d1d4aa70b6a812250c58dfcb51d94238b0
 SHA512:
-  metadata.gz: 612b02c74d0713dc6b830c2c326b59909ce55afb06494c4ed8560d61683160d6f327342825134b7a91d3cc1e89af9ee0bfc7927fe5c4a8a4a66c51e6fd0fa6ed
-  data.tar.gz: 0bf6e0b645d7ae2f90a4dcd69f52f6857e1c76c33264bb2f6dda04cf6b347a0f6ee844164dfe5a0aaa781fb8392059c2be22bada1235f10e36d56d70992edcbc
+  metadata.gz: 2460e6bb7dcb98c66509fb8acc4fbda27cd1008e732da3599fe28d90f443e082b2dd34ef0039018b425fdb6d3bd65a86bb86027709f4063736da37592a581025
+  data.tar.gz: 005a64593b123ac5d8e6eec4689eb3648f3984ae44fc13f307b3c6fcc1660b3a3935cf6588f2ccac0b9bafdb849546c6160990d29aa9621647eacd02c75ae7cf

data/README.md

@@ -1,20 +1,63 @@
-dian-ping
-=========
+## 大众点评API
 
-[ruby]大众点评api
-
-Install
-=========
+### 安装
 
+```
 gem install 'dian_ping'
+```
 
-Usage
-=========
+### 优点
 
-```ruby
-require 'dian_ping'
+#### 可选参数都映射为方法链
+#### 参考[API](http://developer.dianping.com/app/api/v1/business/find_businesses)
+
+### 使用
 
+```
+require 'dian_ping'
 dp = DianPing.new(key: 'Your key', secret: 'Your secret')
-dp.coordinate([31.18268013000488,121.42769622802734]).page(1).has_coupon.get('/v1/business/find_businesses')
+
+# 搜索商户
+# 搜索上海有优惠卷的商家
+dp.has_coupon.city('上海').find
+
+# 分页
+dp.city('上海').page(1).find
+
+# 获取指定商户信息
+dp.shop('2951611')
+
+# 获取指定商户最新点评片断
+dp.reviews('2951611')
+
+# 获取支持商户搜索的最新城市列表
+dp.cities
+
+# 获取支持商户搜索的最新分类列表
+dp.categories
+
+# 获取支持商户搜索的最新城市下属区域列表
+dp.regions('上海')
+
+# 获取支持在线预订的全部商户ID列表
+dp.reservations('上海')
+
+# 获取当前在线的全部团购ID列表
+dp.deals('上海')
+
+# 获取指定团购信息
+dp.deal('1-5097286')
+
+# 通过api地址调用
+dp.get('/v1/deal/get_deals_by_business_id', {city: '上海', business_id: '2951611'})
 
 ```
+
+### Rails
+
+* 在Gemfile添加gem
+* 执行bundle exec rake dian_ping:install
+* 在config/dian_ping.yml补全
+* 使用DP.进行调用
+
+

data/lib/dian_ping.rb

@@ -6,7 +6,7 @@ require 'dianping/parameter'
 class DianPing
   include HTTParty
 
-  VERSION = '0.0.7'
+  VERSION = '0.1.0'
 
   attr_accessor :key, :secret
 
@@ -16,7 +16,15 @@ class DianPing
     @key, @secret = opts.values_at(:key, :secret)
   end
 
-  def get(route, param)
+  # @param route [String] 请求的URL
+  # @param param [Hash] 传递的参数
+  # @return [Hash]
+  #
+  # @example
+  #   dp = DianPing.new(key: 'Your key', secret: 'Your secret')
+  #   dp.get('/v1/reservation/get_all_id_list', {city: '上海'})
+  #
+  def get(route, param = {})
     param[:sign]   = signature(param)
     param[:appkey] = @key
     self.class.get route, query: param

data/lib/dianping/parameter.rb

@@ -22,11 +22,24 @@ class DianPing
       client.get(route, self)
     end
 
+    # 商户类
+
+    # 搜索商户
+    # @example
+    #   DP.has_coupon.city('上海').find
+    def find
+      get '/v1/business/find_businesses'
+    end
+
     # 获取指定商户信息
+    # @example
+    #   DP.business('2951611')
+    #   DP.shop('2951611')
     def business(id)
       add :business_id, id
       get '/v1/business/get_single_business'
     end
+    alias_method :shop, :business
 
     # 获取指定商户最新点评片断
     def reviews(id)
@@ -34,6 +47,11 @@ class DianPing
       get '/v1/review/get_recent_reviews'
     end
 
+    # 获取支持商户搜索的最新城市列表
+    def cities
+      get '/v1/metadata/get_cities_with_businesses'
+    end
+
     # 获取支持商户搜索的最新分类列表
     def categories(city = nil)
       add :city, city

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dian_ping
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.1.0
 platform: ruby
 authors:
 - zires
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-16 00:00:00.000000000 Z
+date: 2014-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -112,7 +112,8 @@ files:
 - Rakefile
 - README.md
 homepage: https://github.com/zires/dian-ping
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []