wechat_public_api 0.1.1 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bed6ccb358f95e9f869f07ecee7062de0fe186d9
-  data.tar.gz: 26e0fc2bd8ec03557bd73121292c7b7a761f6163
+  metadata.gz: 98dfee4a07d505f15fb5e2b6c8e34d9210f050ee
+  data.tar.gz: 9866e3df655cb9cdc1e39a7d8ed33922b012bc9f
 SHA512:
-  metadata.gz: 65b6ee27a31430294041f827c3743aeecf00dc629ac742615c0d1a40d832b9424983ca06e6128effc0ba41b59ffc0ca52d1d54bfc090b1b4e0cba5be2b96a1b4
-  data.tar.gz: 45fbfac8144f482c114a44a43c271fca6782a1bf62251b76868674541b8ba5a9db62ebc1e2521917cb91a9569c497870b956888c56b64d34900310823d01580e
+  metadata.gz: 912aa2de176603be919d491a4453561abb531b9aa937cbd77b417d7104337594a9af642a0dce0ad3711b14a1035606494a384b441c3290fb3221c97597dd6094
+  data.tar.gz: 7bd5188cc0c6e69832326a5428e3be01afebe1059df2f32738636b4df79880484471409020794c26c4fa8efbcd274a63df0f92097b2f1962152f24bae11d1aef

data/Gemfile.lock

@@ -0,0 +1,45 @@
+PATH
+  remote: .
+  specs:
+    wechat_public_api (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    domain_name (0.5.20180417)
+      unf (>= 0.0.5, < 1.0.0)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    httparty (0.16.2)
+      multi_xml (>= 0.5.2)
+    json (2.1.0)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    multi_xml (0.6.0)
+    netrc (0.11.0)
+    rake (10.5.0)
+    redis (4.0.1)
+    rest-client (2.0.2)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  httparty
+  json
+  rake (~> 10.0)
+  redis
+  rest-client
+  unf_ext (~> 0.0.7.5)
+  wechat_public_api!
+
+BUNDLED WITH
+   1.16.1

data/README.md

@@ -1,43 +1,189 @@
-# WechatPublicApi
+# 简介
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/wechat_public_api`. To experiment with that code, run `bin/console` for an interactive prompt.
+基于ruby的微信公众号开发的API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装。
 
-TODO: Delete this and the text above, and describe your gem
+API长期更新维护，建议使用最新版本。
 
-## Installation
+## 安装
 
-Add this line to your application's Gemfile:
+添加 Gemfile:
 
 ```ruby
 gem 'wechat_public_api'
 ```
 
-And then execute:
+执行 bundle:
 
-    $ bundle
+    $ bundle install
 
-Or install it yourself as:
+或者直接通过 gem 安装:
 
     $ gem install wechat_public_api
 
-## Usage
+## 三行代码获得 access_token
 
-TODO: Write usage instructions here
+```ruby
+WechatPublicApi.app_id = 'appid'
+WechatPublicApi.app_secret = 'secret'
+access_token = WechatPublicApi::AccessToken.get() # access_token
+```
+## API文档
+
+### WechatPublicApi模块配置，开启你的新项目
+
+**参数说明**
+
+* @param <String> app_id      # 公众号后台->开发->基本配置提供的AppID
+* @param <String> app_secret  # 公众号后台->开发->基本配置提供的AppSecret
+* @param <Boolearn> access_token_cache # 默认false，用于标识是否使用redis缓存查询到的access_token
+
+使用`WechatPublicApi`模块封装的方法之前，需要配置 app_id、app_secret和access_token_cache（可选），具体如下：
 
-## Development
+```ruby
+WechatPublicApi.app_id = 'wx440415e4c3b4b8f9'
+WechatPublicApi.app_secret = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+access_token = WechatPublicApi::AccessToken.get() # access_token
+```
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+**注意：** access_token_cache是一个布尔值，用于判断是否需要缓存access_token_cache，默认可不填，即默认不缓存access_token，如需缓存，请依照下方代码设置参数：
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```ruby
+WechatPublicApi.access_token_cache = true
+```
 
-## Contributing
+### API功能概览
+
+* 菜单栏操作
+	* 创建菜单栏：`WechatPublicApi::Menu.create(post_data)`
+	* 查询菜单栏：`WechatPublicApi::Menu.query()`
+	* 删除菜单栏：`WechatPublicApi::Menu.delete()`
+* 客服消息管理
+	* 发送文字消息：`WechatPublicApi::Kf.text_message(openid, content)`
+	* 发送图片消息：`WechatPublicApi::Kf.image_message(openid, media_id)`
+	* 发送图文消息：`WechatPublicApi::Kf.mpnews_message(openid, media_id)`
+	* 发送图文消息（点击跳转外链）: `WechatPublicApi::Kf.news_message(openid, articles)`
+	* 发送语音消息：`WechatPublicApi::Kf.voice_message(openid, media_id)`
+* 模板消息管理
+	* 获取模板列表：`WechatPublicApi::Tp.get_all()`
+	* 删除模板：`WechatPublicApi::Tp.delete(templet_id)`
+	* 发送普通模板消息（不跳转小程序）`WechatPublicApi::Tp.general_message(openid, templet_id, url, data)`
+	* 发送跳转小程序的模板消息：`WechatPublicApi::Tp.miniprogram_message(openid, templet_id, url, appid, pagepath, data)`
+* 用户管理
+  * 获取用户基本信息: `WechatPublicApi::User.get_userinfo(openid)`
+* 帐号管理
+  * 获取临时带参二维码: `WechatPublicApi::Account.qrscene(sceneid)`
+  * 获取永久带参二维码: `WechatPublicApi::Account.qrsrtscene(sceneid)`
+  * 保存带参二维码到本地： `WechatPublicApi::Account.save_qrcode(path, *filename)`
+  * 生成短链接：`WechatPublicApi::Account.shorturl(longurl)`
+* 素材管理
+  * 获得临时图片素材的 media_id： `WechatPublicApi::Material.upload_image_media(file_path)`
+  * 获得永久图片素材的 media_id： `WechatPublicApi::Material.upload_image_material(file_path)`
+* 消息加密解密
+  * 加密： `WechatPublicApi::Aes.encrypt(aes_key, text, app_id)`
+  * 解密： `WechatPublicApi::Aes.decrypt(key, dicrypted_string)`
+
+### 菜单栏操作API
+
+1. 自定义菜单查询
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/wechat_public_api. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+```ruby
+# no params
+# @return
+# {
+#   "menu": {
+#       "button": [
+#       {
+#        "type": "view",
+#        "name": "",
+#        "url": "",
+#        "sub_button": []
+#       },
+#       {
+#        "type": "click",
+#        "name": "",
+#        "key": "menu_3",
+#        "sub_button": []
+#       }
+#     ]
+#   }
+# }
+#
+menu_list = WechatPublicApi::Menu.query()
+```
 
-## License
+2. 自定义菜单创建
+
+```ruby
+###
+# create wechat public menu
+# @param <json> post_data
+#
+# =>  post_data example
+# {
+# 	  "button": [
+#     {
+#  		 "type": "view",
+#  		 "name": "",
+#  		 "url": "",
+#  		 "sub_button": []
+#  	  },
+#     {
+#  		 "type": "click",
+#  		 "name": "",
+#  		 "key": "menu_3",
+#  		 "sub_button": []
+#  	  }
+#   ]
+# }
+#
+# if success
+# @return <JSON> {"errcode"=>0, "errmsg"=>"ok"}
+# if failed
+# @return <JSON> {"errcode"=>40166, "errmsg"=>"...."}
+#
+status = WechatPublicApi::Menu.create(post_data)
+```
+
+3. 自定义菜单删除
+
+```ruby
+# @return <JSON> {"errcode"=>0, "errmsg"=>"ok"}
+status = WechatPublicApi::Menu.delete()
+```
+
+菜单栏操作API主要包含以上三个方法，接下来看一个完整示例：
+
+```ruby
+# 创建菜单栏 -> 查询菜单栏列表
+# 初始化配置
+WechatPublicApi.app_id = 'wx440415e4c3b4b8f9'
+WechatPublicApi.app_secret = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
+# 创建菜单栏
+post_data = {
+	  "button": [
+    {
+ 		 "type": "view",
+ 		 "name": "",
+ 		 "url": "",
+ 		 "sub_button": []
+ 	  },
+    {
+ 		 "type": "click",
+ 		 "name": "",
+ 		 "key": "menu_3",
+ 		 "sub_button": []
+ 	  }
+  ]
+}
+status = WechatPublicApi::Menu.create(post_data)
+if status.errcode.to_i == 0 && status.errmsg == 'ok'
+  # 返回菜单栏列表
+  menu_list = WechatPublicApi::Menu.query()
+end
+```
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+**注意：** 菜单栏创建和查询的方法包含了查询access_token
 
-## Code of Conduct
+### 客服消息管理API
 
-Everyone interacting in the WechatPublicApi project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/wechat_public_api/blob/master/CODE_OF_CONDUCT.md).
+待更新... 可参考源代码，注释比较详细

data/lib/wechat_public_api.rb

@@ -3,6 +3,11 @@ require "wechat_public_api/menu"
 require "wechat_public_api/kf_message"
 require "wechat_public_api/templet_message"
 require "wechat_public_api/access_token"
+require "wechat_public_api/accout"
+require "wechat_public_api/aes"
+require "wechat_public_api/utils"
+require "wechat_public_api/user"
+require "wechat_public_api/material"
 
 module WechatPublicApi
   class << self

data/lib/wechat_public_api/access_token.rb

@@ -21,6 +21,10 @@ module WechatPublicApi
         unless access_token_cache
           response = HTTParty.get("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=#{appid}&secret=#{secret}").body
           response_body = (JSON.parse response)
+
+          # 抛出异常
+          throw response_body['errmsg']  unless response_body['access_token']
+
           return response_body['access_token']
         end
 
@@ -29,7 +33,10 @@ module WechatPublicApi
         if _cached_access_token == nil or _cached_access_token == ''
           response = HTTParty.get("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=#{appid}&secret=#{secret}").body
           response_body = (JSON.parse response)
-          Rails.logger.info response_body
+
+          # 抛出异常
+          throw response_body['errmsg']  unless response_body['access_token']
+
           _cached_access_token = response_body['access_token']
           $redis.set _cache_key, _cached_access_token, ex: 2.minutes
         end

data/lib/wechat_public_api/account.rb

@@ -0,0 +1,119 @@
+#####################################################
+# 微信公众号帐号管理 （带参二维码获得）
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+require "wechat_public_api/access_token"
+
+module WechatPublicApi
+  module Account
+    class << self
+
+      ###
+      # 获取临时场景带惨二维码，30天有效
+      # @param <int> sceneid -- 场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1--100000）
+      # @return <string> url -- 二维码网址
+      #
+      def qrscene(sceneid)
+        access_token = AccessToken.get()
+
+        # 获取ticket
+        uri = URI.parse("https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=#{access_token}")
+        post_data = {
+            'expire_seconds' => 2592000,
+            'action_name' => 'QR_SCENE',
+            'action_info' => {'scene' => {'scene_id' => sceneid}}}
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        request = Net::HTTP::Post.new("/cgi-bin/qrcode/create?access_token=#{access_token}")
+        request.add_field('Content-Type', 'application/json')
+        request.body = post_data.to_json
+        response = http.request(request)
+        content = JSON.parse(response.body)
+        ticket = content['ticket']
+
+        # 通过ticket换取二维码
+        url = 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=' + ticket
+        url
+      end
+
+      ###
+      # 获取永久二维码
+      # @param <int> sceneid -- 场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1--100000）
+      # @return <string> url -- 二维码网址
+      #
+      def qrsrtscene(sceneid)
+        access_token = AccessToken.get()
+
+        # 获取ticket
+        uri = URI.parse("https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=#{access_token}")
+        post_data = {
+            'action_name' => 'QR_LIMIT_STR_SCENE',
+            'action_info' => {'scene' => {'scene_id' => sceneid}}}
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        request = Net::HTTP::Post.new("/cgi-bin/qrcode/create?access_token=#{access_token}")
+        request.add_field('Content-Type', 'application/json')
+        request.body = post_data.to_json
+        response = http.request(request)
+        content = JSON.parse(response.body)
+        ticket = content['ticket']
+
+        # 通过ticket换取二维码
+        url = 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=' + ticket
+        url
+      end
+
+      ###
+      # 保存带参数二维码到指定位置
+      # @param <string> path -- 例如： "#{Rails.root}/public/qrcode"
+      # @param <string> filename -- 文件名，可选参数，默认不填写则使用时间戳+随机数的方式命名
+      #
+      # @return <string> path -- 二维码的保存路径
+      def save_qrcode(path, *filename)
+        # 判断是否需要新建文件
+        unless File.exist?(path)
+          FileUtils.makedirs(path)
+        end
+
+        if filename
+          path = "#{path}/#{filename}"
+        else
+          path = "#{path}/#{Time.now.to_i.to_s}_#{rand 1000.9999}"
+        end
+
+        File.open(path, 'wb') do |f|
+          f.write(HTTParty.get(url).body)
+        end
+
+        path
+      end
+
+      ###
+      # @param <string> longurl -- 需要被压缩的url
+      #
+      # @return <json> shorturl -- 返回短链接 {"errcode":0,"errmsg":"ok","short_url":"http:\/\/w.url.cn\/s\/AvCo6Ih"}
+      # if false
+      # @return {"errcode":40013,"errmsg":"invalid appid"}
+      #
+      def shorturl(longurl)
+        access_token = AccessToken.get()
+        uri = URI.parse("https://api.weixin.qq.com/cgi-bin/shorturl?access_token=#{access_token}")
+        post_data = {action: "long2short", long_url: longurl}
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        request = Net::HTTP::Post.new("/cgi-bin/shorturl?access_token=#{access_token}")
+        request.add_field('Content-Type', 'application/json')
+        request.body = post_data.to_json
+        response = http.request(request)
+
+        JSON.parse(response.body)
+      end
+    end
+  end
+end

data/lib/wechat_public_api/aes.rb

@@ -0,0 +1,44 @@
+#####################################################
+# 消息加密解密
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+require "wechat_public_api/access_token"
+module WechatPublicApi
+  module Aes
+    class << self
+
+      # 解密
+      def decrypt(key, dicrypted_string)
+        cipher = OpenSSL::Cipher::AES.new(256, :CBC)
+        cipher.decrypt
+        cipher.key = key
+        cipher.iv = '0000000000000000'
+        cipher.padding = 0
+        cipher.update(dicrypted_string) << cipher.final
+      end
+
+      # 加密
+      def encrypt(aes_key, text, app_id)
+        text    = text.force_encoding("ASCII-8BIT")
+        random  = SecureRandom.hex(8)
+        msg_len = [text.length].pack("N")
+        text    = "#{random}#{msg_len}#{text}#{app_id}"
+        text    = WxAuth.encode(text)
+        text    = handle_cipher(:encrypt, aes_key, text)
+        Base64.encode64(text)
+      end
+
+      def handle_cipher(action, aes_key, text)
+        cipher = OpenSSL::Cipher.new('AES-256-CBC')
+        cipher.send(action)
+        cipher.padding = 0
+        cipher.key = aes_key
+        cipher.iv  = aes_key[0...16]
+        cipher.update(text) + cipher.final
+      end
+    end
+  end
+end

data/lib/wechat_public_api/kf_message.rb

@@ -29,7 +29,7 @@ module WechatPublicApi
       #
       # @param <JSON> message
       #
-      def self.post_customer_message(message)
+      def post_customer_message(message)
         # get access_token
         access_token = AccessToken.get()
 
@@ -49,7 +49,7 @@ module WechatPublicApi
       # @param <string> content -- 需要发送的客服消息内容
       #
       # 发送文字消息
-      def self.text_message(openid, content)
+      def text_message(openid, content)
 
         custom_message = {
           touser: openid,
@@ -68,7 +68,7 @@ module WechatPublicApi
       # @param <string> media_id  -- 发送的图片/语音/视频/图文消息（点击跳转到图文消息页）的媒体ID
       #
       # 发送图片消息
-      def self.image_message(openid, media_id)
+      def image_message(openid, media_id)
 
         custom_message = {
           touser: openid,
@@ -116,7 +116,7 @@ module WechatPublicApi
       # ]
       #
       # 发送图文消息（点击跳转到外链）
-      def self.news_message(openid, articles)
+      def news_message(openid, articles)
         custom_message = {
             touser: openid,
             msgtype: 'news',
@@ -132,7 +132,7 @@ module WechatPublicApi
       end
 
       # 发送语音消息
-      def self.voice_message(openid, media_id)
+      def voice_message(openid, media_id)
 
         custom_message = {
             touser: openid,

data/lib/wechat_public_api/material.rb

@@ -0,0 +1,53 @@
+#####################################################
+# 微信公众号素材管理
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+require "wechat_public_api/access_token"
+
+module WechatPublicApi
+  module Material
+    class << self
+
+      ###
+      # 获得临时图片素材的 media_id
+      # @param <string> file_path -- 图片素材的路径
+      #
+      # @return <json> {"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
+      # if false
+      # @return <json> {"errcode":40004,"errmsg":"invalid media type"}
+      #
+      def upload_image_media(file_path)
+        # request access_token
+        access_token = AccessToken.get()
+        response = RestClient.post('https://api.weixin.qq.com/cgi-bin/media/upload',
+                                   {
+                                       access_token: access_token,
+                                       type: 'image',
+                                       media: File.new(file_path, 'rb')})
+        JSON.parse(response)
+      end
+
+      ###
+      # 新增永久图片素材
+      # @param <string> file_path -- 图片素材的路径
+      #
+      # @return <json> {"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
+      # if false
+      # @return <json> {"errcode":40004,"errmsg":"invalid media type"}
+      #
+      def upload_image_material(file_path)
+        # request access_token
+        access_token = AccessToken.get()
+        response = RestClient.post('https://api.weixin.qq.com/cgi-bin/material/add_material',
+                                   {
+                                       access_token: access_token,
+                                       type: 'image',
+                                       media: File.new(file_path, 'rb')})
+        JSON.parse(response)
+      end
+    end
+  end
+end

data/lib/wechat_public_api/menu.rb

@@ -17,7 +17,7 @@ module WechatPublicApi
       #
       # =>  post_data example
       # {
-      #	  "button": [
+      # 	  "button": [
       #     {
       #  		 "type": "view",
       #  		 "name": "",
@@ -41,9 +41,9 @@ module WechatPublicApi
       def create(post_data)
         # request access_token
         access_token = AccessToken.get()
+        post_data = post_data.to_json.gsub(/\\u([0-9a-z]{4})/) {|s| [$1.to_i(16)].pack("U")}
 
         uri = URI.parse("https://api.weixin.qq.com/cgi-bin/menu/create?access_token=#{access_token}")
-        post_data = post_data
         http = Net::HTTP.new(uri.host, uri.port)
         http.use_ssl = true
         http.verify_mode = OpenSSL::SSL::VERIFY_NONE
@@ -58,7 +58,7 @@ module WechatPublicApi
       def query()
         # request access_token
         access_token = AccessToken.get()
-        response = HTTParty.get("https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN=#{access_token}").body
+        response = HTTParty.get("https://api.weixin.qq.com/cgi-bin/menu/get?access_token=#{access_token}").body
         (JSON.parse response)
       end
 
@@ -69,7 +69,7 @@ module WechatPublicApi
       def delete()
         # request access_token
         access_token = AccessToken.get()
-        response = HTTParty.get("https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN=#{access_token}").body
+        response = HTTParty.get("https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=#{access_token}").body
         (JSON.parse response)
       end
     end

data/lib/wechat_public_api/templet_message.rb

@@ -8,7 +8,7 @@
 require "wechat_public_api/access_token"
 
 module WechatPublicApi
-  module TP
+  module Tp
     class << self
 
       ###

data/lib/wechat_public_api/user.rb

@@ -0,0 +1,46 @@
+#####################################################
+# 公众号用户管理
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+require "wechat_public_api/access_token"
+
+module WechatPublicApi
+  module User
+    class << self
+
+      # 获取用户信息
+      # @return <JSON>
+      # {
+      #     "subscribe": 1,
+      #     "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
+      #     "nickname": "Band",
+      #     "sex": 1,
+      #     "language": "zh_CN",
+      #     "city": "广州",
+      #     "province": "广东",
+      #     "country": "中国",
+      #     "headimgurl":"http://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
+      #     "subscribe_time": 1382694957,
+      #     "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
+      #     "remark": "",
+      #     "groupid": 0,
+      #     "tagid_list":[128,2],
+      #     "subscribe_scene": "ADD_SCENE_QR_CODE",
+      #     "qr_scene": 98765,
+      #     "qr_scene_str": ""
+      # }
+      #
+      # if failed
+      # {"errcode":40013,"errmsg":"invalid appid"}
+      #
+      def get_userinfo(openid)
+        # request access_token
+        access_token = AccessToken.get()
+        JSON.parse HTTParty.get("https://api.weixin.qq.com/cgi-bin/user/info?access_token=#{access_token}&openid=#{openid}&lang=zh_CN").body
+      end
+    end
+  end
+end

data/lib/wechat_public_api/utils.rb

@@ -0,0 +1,15 @@
+#####################################################
+# 基于微信公众号的小工具，公用
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+require "wechat_public_api/access_token"
+module WechatPublicApi
+  module Utils
+    class << self
+      # Todo
+    end
+  end
+end

data/lib/wechat_public_api/version.rb

@@ -1,3 +1,3 @@
 module WechatPublicApi
-  VERSION = "0.1.1"
+  VERSION = "0.1.4"
 end

data/wechat_public_api.gemspec

@@ -6,10 +6,10 @@ require "wechat_public_api/version"
 Gem::Specification.new do |spec|
   spec.name          = "wechat_public_api"
   spec.version       = WechatPublicApi::VERSION
-  spec.authors       = ["张明鑫"]
+  spec.authors       = ["张明鑫 wechat number: zmx119966"]
   spec.email         = ["mnzmx_z@163.com"]
 
-  spec.summary       = %q{微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装}
+  spec.summary       = %q{微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装，API长期更新维护，建议使用最新版本.}
   spec.description   = %q{}
   spec.homepage      = "https://github.com/Diyilou/wechat_public_api.git"
   spec.license       = "MIT"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wechat_public_api
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.4
 platform: ruby
 authors:
-- 张明鑫
+- '张明鑫 wechat number: zmx119966'
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-05-17 00:00:00.000000000 Z
+date: 2018-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -118,6 +118,7 @@ files:
 - ".gitignore"
 - CODE_OF_CONDUCT.md
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -125,10 +126,17 @@ files:
 - bin/setup
 - lib/wechat_public_api.rb
 - lib/wechat_public_api/access_token.rb
+- lib/wechat_public_api/account.rb
+- lib/wechat_public_api/aes.rb
 - lib/wechat_public_api/kf_message.rb
+- lib/wechat_public_api/material.rb
 - lib/wechat_public_api/menu.rb
 - lib/wechat_public_api/templet_message.rb
+- lib/wechat_public_api/user.rb
+- lib/wechat_public_api/utils.rb
 - lib/wechat_public_api/version.rb
+- wechat_public_api-0.1.1.gem
+- wechat_public_api-0.1.2.gem
 - wechat_public_api.gemspec
 homepage: https://github.com/Diyilou/wechat_public_api.git
 licenses:
@@ -153,5 +161,5 @@ rubyforge_project:
 rubygems_version: 2.5.2.1
 signing_key: 
 specification_version: 4
-summary: 微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装
+summary: 微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装，API长期更新维护，建议使用最新版本.
 test_files: []