wxapi 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a96de275aacbda637fb5d2f52229cbfae165c168f7b657dd5c6608b742805e20
+  data.tar.gz: 0e4e7d0888413af25fa4392b9f5a4b7adfabbc8782721eb6fdd900392f3f3ccc
+SHA512:
+  metadata.gz: 6050182becc85a57cab38778ae027fe22497a26ee33366c36c95edcb1b4736cf72f5f6ff1f42421d908a4b7d907df1259430cfe1cba38a364d6c98d1816d0b08
+  data.tar.gz: e8522ae70f8312f1cc18b039b99e51be5e5c782ff46b7b70cb7ca0a3e16a473993fbd63f248d18e284777acb316a4f93ebbad0c3f7a8976b0322a4975ebd6074

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in wechat_public_api.gemspec
+gemspec
+
+gem "rest-client", "~> 2.1"

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 zhangS2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,26 @@
+# 简介
+
+基于ruby的微信公众号开发的API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装。
+
+API长期更新维护，建议使用最新版本。
+
+## 安装
+
+添加 Gemfile:
+
+```ruby
+gem 'wxapi'
+```
+
+执行 bundle:
+
+    $ bundle install
+
+或者直接通过 gem 安装:
+
+    $ gem install wxapi
+
+
+
+项目最早来源于 https://index.ruby-china.com/gems/wechat_public_api
+我在原项目的基础上进行了一些修改和优化，使其更加符合微信公众号开发的规范，增加了更多的扩展性。

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+task :default => :spec
+
+
+task :upload do |t|
+  sh "gem build wxapi.gemspec"
+  sh "gem push wxapi-#{WxApi::VERSION}.gem"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "wx_api"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/wx_api.rb

@@ -0,0 +1,41 @@
+require "wxapi/version"
+require "wxapi/menu"
+require "wxapi/kf_message"
+require "wxapi/templet_message"
+require "wxapi/access_token"
+require "wxapi/account"
+require "wxapi/aes"
+require "wxapi/utils"
+require "wxapi/user"
+require "wxapi/material"
+
+class WxApi
+  include AccessToken
+  include Account
+  include Aes
+  include Kf
+  include Material
+  include Menu
+  include Tp
+  include User
+  include Utils
+
+  # 默认不缓存 access_token, access_token_cache = True 缓存
+  # @param <hash> aoptions
+  # => example
+  # wechat_api = WechatPublicApi.new appid: 'xx', app_secret: 'xx', access_token_cache: true
+  # wechat_api.app_id -- get appid
+  #
+  #  api.get_access_token
+  #
+
+  attr_accessor :app_id, :app_secret, :access_token_cache
+  attr_accessor :prefix
+  def initialize(options={})
+    @app_id = options[:app_id]
+    @app_secret = options[:app_secret]
+    @access_token_cache = options[:access_token_cache]
+    @prefix = options[:api_prefix]
+    @prefix="https://api.weixin.qq.com" if @prefix.nil?
+  end
+end

data/lib/wxapi/access_token.rb

@@ -0,0 +1,45 @@
+#####################################################
+# 获得微信公众号的 access_token (Get wechat public access_token)
+# Created by zhangmingxin
+# Date: 2018-05-17
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module AccessToken
+
+    ###
+    # 获取 access_token
+    # 判断access_token_cache，决定是否需要缓存数据
+    # @return <string> nil or access_token
+    def get_access_token()
+      appid = @app_id
+      secret = @app_secret
+      access_token_cache = @access_token_cache
+
+      unless access_token_cache
+        response = HTTParty.get("#{prefix}/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
+
+      _cache_key = "#{appid}_access_token"
+      _cached_access_token = $redis.get _cache_key
+      if _cached_access_token == nil or _cached_access_token == ''
+        response = HTTParty.get("#{prefix}/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']
+
+        _cached_access_token = response_body['access_token']
+        $redis.set _cache_key, _cached_access_token, ex: 2.minutes
+      end
+      _cached_access_token
+    end
+  end
+end

data/lib/wxapi/account.rb

@@ -0,0 +1,112 @@
+#####################################################
+# 微信公众号帐号管理 （带参二维码获得）
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Account
+    ###
+    # 获取临时场景带惨二维码，30天有效
+    # @param <int> sceneid -- 场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1--100000）
+    # @return <string> url -- 二维码网址
+    #
+    def get_qrscene(sceneid)
+      access_token = get_access_token()
+
+      # 获取ticket
+      uri = URI.parse("#{prefix}/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换取二维码
+      "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=#{ticket}"
+    end
+
+    ###
+    # 获取永久二维码
+    # @param <int> sceneid -- 场景值ID，临时二维码时为32位非0整型，永久二维码时最大值为100000（目前参数只支持1--100000）
+    # @return <string> url -- 二维码网址
+    #
+    def get_qrsrtscene(sceneid)
+      access_token = get_access_token()
+
+      # 获取ticket
+      uri = URI.parse("#{prefix}/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换取二维码
+      "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=#{ticket}"
+    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 get_shorturl(longurl)
+      access_token = get_access_token()
+      uri = URI.parse("#{prefix}/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

data/lib/wxapi/aes.rb

@@ -0,0 +1,41 @@
+#####################################################
+# 消息加密解密
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Aes
+    # 解密
+    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
+
+    private
+    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

data/lib/wxapi/kf_message.rb

@@ -0,0 +1,143 @@
+#####################################################
+# 客服消息管理 (about kf_account message)
+# Created by zhangmingxin
+# Date: 2018-05-17
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Kf
+
+    ###
+    # execute post
+    # => example
+    # message = {
+    #   touser: openid,
+    #   msgtype: 'text',
+    #   text: {content: content},
+    #   customservice:{
+    #     kf_account: 'xxxxxxxx'
+    #   }
+    # }
+    #
+    # @param <JSON> message
+    #
+    def post_customer_message(message)
+      # get access_token
+      access_token = get_access_token()
+
+      uri = URI.parse("#{prefix}/cgi-bin/message/custom/send?access_token=#{access_token}")
+      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/message/custom/send?access_token=#{access_token}")
+      request.add_field('Content-Type', 'application/json')
+      request.body = message.to_json.gsub(/\\u([0-9a-z]{4})/) {|s| [$1.to_i(16)].pack("U")}
+      response = http.request(request)
+      JSON.parse(response.body)
+    end
+
+    ###
+    # @param <string> openid  -- 用户的openid
+    # @param <string> content -- 需要发送的客服消息内容
+    #
+    # 发送文字消息
+    def kf_text_message(openid, content, kf_account=nil)
+
+      custom_message = {
+        touser: openid,
+        msgtype: 'text',
+        text: {content: content}
+      }
+
+      if kf_account
+        custom_message.merge({customservice:{account: kf_account}})
+      end
+
+      post_customer_message custom_message
+    end
+
+    ###
+    # @param <string> media_id  -- 发送的图片/语音/视频/图文消息（点击跳转到图文消息页）的媒体ID
+    #
+    # 发送图片消息
+    def kf_image_message(openid, media_id, kf_account=nil)
+
+      custom_message = {
+        touser: openid,
+        msgtype: 'image',
+        image: {media_id: media_id}
+      }
+
+      if kf_account
+        custom_message.merge({customservice:{account: kf_account}})
+      end
+
+      post_customer_message custom_message
+    end
+
+    # 发送图文消息（点击跳转到图文消息页面）
+    def kf_mpnews_message(openid, media_id, kf_account=nil)
+      custom_message = {
+        touser: openid,
+        msgtype: 'mpnews',
+        mpnews: {media_id: media_id}
+      }
+      if kf_account
+        custom_message.merge({customservice:{account: kf_account}})
+      end
+
+      post_customer_message custom_message
+    end
+
+    ###
+    # @param <JSON> articles -- 图文消息列表
+    # => example
+    # articles = [
+    #   {
+    #       "title":"Happy Day",
+    #       "description":"Is Really A Happy Day",
+    #       "url":"URL",
+    #       "picurl":"PIC_URL"
+    #   },
+    #   {
+    #       "title":"Happy Day",
+    #       "description":"Is Really A Happy Day",
+    #       "url":"URL",
+    #       "picurl":"PIC_URL"
+    #   }
+    # ]
+    #
+    # 发送图文消息（点击跳转到外链）
+    def kf_news_message(openid, articles, kf_account=nil)
+      custom_message = {
+          touser: openid,
+          msgtype: 'news',
+          news: {
+            articles: articles
+          }
+      }
+
+      if kf_account
+        custom_message.merge({customservice:{account: kf_account}})
+      end
+      post_customer_message custom_message
+    end
+
+    # 发送语音消息
+    def kf_voice_message(openid, media_id, kf_account=nil)
+
+      custom_message = {
+          touser: openid,
+          msgtype: 'voice',
+          voice: {
+            media_id: media_id
+          }
+      }
+      if kf_account
+        custom_message.merge({customservice:{account: kf_account}})
+      end
+      post_customer_message custom_message
+    end
+  end
+end

data/lib/wxapi/material.rb

@@ -0,0 +1,48 @@
+#####################################################
+# 微信公众号素材管理
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Material
+    ###
+    # 获得临时图片素材的 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 = get_access_token()
+      response = RestClient.post("#{prefix}/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 = get_access_token()
+      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

data/lib/wxapi/menu.rb

@@ -0,0 +1,72 @@
+#####################################################
+# 公众号自定义菜单栏模块 (about wechat public menu)
+# Created by zhangmingxin
+# Date: 2018-05-17
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Menu
+    ###
+    # 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"=>"...."}
+    #
+    def create_menu(post_data)
+      # request access_token
+      access_token = get_access_token()
+      post_data = post_data.to_json.gsub(/\\u([0-9a-z]{4})/) {|s| [$1.to_i(16)].pack("U")}
+
+      uri = URI.parse("#{prefix}/cgi-bin/menu/create?access_token=#{access_token}")
+      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/menu/create?access_token=#{access_token}")
+      request.add_field('Content-Type', 'application/json')
+      request.body = post_data
+      response = http.request(request)
+      (JSON.parse response.body)
+    end
+
+    # get wechat public menu list
+    def query_menu()
+      # request access_token
+      access_token = get_access_token()
+      response = HTTParty.get("#{prefix}/cgi-bin/menu/get?access_token=#{access_token}").body
+      (JSON.parse response)
+    end
+
+    ###
+    # delete wechat query from access_token
+    # @return <JSON> {"errcode"=>0, "errmsg"=>"ok"}
+    #
+    def delete_menu()
+      # request access_token
+      access_token = get_access_token
+      response = HTTParty.get("#{prefix}/cgi-bin/menu/delete?access_token=#{access_token}").body
+      (JSON.parse response)
+    end
+  end
+end

data/lib/wxapi/templet_message.rb

@@ -0,0 +1,103 @@
+#####################################################
+# 微信公众号模板消息相关接口 (About templet message of wechat public)
+# Created by zhangmingxin
+# Date: 2018-05-17
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Tp
+    ###
+    # @param <JSON> message
+    # @param <string> url_params  -- 消息路径
+    # 发送模板消息接口
+    def post_template_message(message, url_params)
+      # get access_token
+      access_token = get_access_token()
+
+      uri = URI.parse("#{prefix}/cgi-bin/message/template/#{url_params}?access_token=#{access_token}")
+      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/message/template/#{url_params}?access_token=#{access_token}")
+      request.add_field('Content-Type', 'application/json')
+      # 部分字符转换为json后  成为unicode编码
+      request.body = message.to_json.gsub(/\\u([0-9a-z]{4})/) {|s| [$1.to_i(16)].pack("U")}
+      response = http.request(request)
+      JSON.parse(response.body)
+    end
+
+    ###
+    # @param <string> openid -- 用户的openid
+    # @param <string> templet_id -- 微信公众号后台提供的模板ID
+    # @param <string> url -- 模板跳转链接
+    # @param <string> appid -- 小程序的appid
+    # @param <string> pagepath -- 小程序页面路径 (eq: /index/index)
+    # @param <JSON> data -- 模板数据
+    # => data example
+    # data = {
+    #    "first": {
+    #        "value":"恭喜你购买成功！",
+    #        "color":"#173177"
+    #    },
+    #    "keyword1":{
+    #        "value":"巧克力",
+    #        "color":"#173177"
+    #    },
+    #    "keyword2": {
+    #        "value":"39.8元",
+    #        "color":"#173177"
+    #    },
+    #    "keyword3": {
+    #        "value":"2014年9月22日",
+    #        "color":"#173177"
+    #    },
+    #    "remark":{
+    #        "value":"欢迎再次购买！",
+    #        "color":"#173177"
+    #    }
+    #  }
+    # 小程序模板消息
+    def tp_miniprogram_message(openid, templet_id, url, appid, pagepath, data)
+      message = {
+          'touser': openid,
+          'template_id': templet_id,
+          'url': url,
+          "miniprogram":{
+             "appid": appid,
+             "pagepath": pagepath
+           },
+          'data': data
+      }
+
+      post_template_message message, 'send'
+    end
+
+    # 普通的模板消息，不跳转小程序
+    def tp_general_message(openid, templet_id, url, data)
+      message = {
+          'touser': openid,
+          'template_id': templet_id,
+          'url': url,
+          'data': data
+      }
+      post_template_message message, 'send'
+    end
+
+    # 删除模板
+    def tp_delete_template(templet_id)
+      message = {
+        'template_id': template_id
+      }
+      post_template_message message, 'del_private_template'
+    end
+
+    # 获得模板列表
+    def tp_get_all()
+      access_token = get_access_token()
+      response = RestClient.get("#{prefix}cgi-bin/template/get_all_private_template?access_token=#{access_token}").body
+      response_body = (JSON.parse response)
+      response_body
+    end
+  end
+end

data/lib/wxapi/user.rb

@@ -0,0 +1,41 @@
+#####################################################
+# 公众号用户管理
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module User
+    # 获取用户信息
+    # @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 = get_access_token()
+      JSON.parse RestClient.get("#{prefix}/cgi-bin/user/info?access_token=#{access_token}&openid=#{openid}&lang=zh_CN").body
+    end
+  end
+end

data/lib/wxapi/utils.rb

@@ -0,0 +1,12 @@
+#####################################################
+# 基于微信公众号的小工具，公用
+# Created by zhangmingxin
+# Date: 2018-05-18
+# Wechat number: zmx119966
+####################################################
+
+class WxApi
+  module Utils
+    # todo
+  end
+end

data/lib/wxapi/version.rb

@@ -0,0 +1,3 @@
+class WxApi
+  VERSION = "1.0.0"
+end

data/wxapi.gemspec

@@ -0,0 +1,39 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "wxapi/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "wxapi"
+  spec.version       = WxApi::VERSION
+  spec.authors       = ["黄滚 twitter: @hg_nohair"]
+  spec.email         = ["xurenlu@gmail.com"]
+
+  spec.summary       = %q{微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装，API长期更新维护，建议使用最新版本.}
+  spec.description   = %q{微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装，API长期更新维护，建议使用最新版本，开发者使用文档：https://yuque.com/qianlansedehei/wechat_public_api}
+  spec.homepage      = "https://github.com/xurenlu/wxapi"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
+  # else
+  #   raise "RubyGems 2.0 or newer is required to protect against " \
+  #     "public gem pushes."
+  # end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "redis"
+  spec.add_development_dependency "json"
+  spec.add_development_dependency "rest-client"
+  spec.add_development_dependency 'unf_ext', '~> 0.0.7.5'
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: wxapi
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- '黄滚 twitter: @hg_nohair'
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-02-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: unf_ext
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.7.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.7.5
+description: 微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装，API长期更新维护，建议使用最新版本，开发者使用文档：https://yuque.com/qianlansedehei/wechat_public_api
+email:
+- xurenlu@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/wx_api.rb
+- lib/wxapi/access_token.rb
+- lib/wxapi/account.rb
+- lib/wxapi/aes.rb
+- lib/wxapi/kf_message.rb
+- lib/wxapi/material.rb
+- lib/wxapi/menu.rb
+- lib/wxapi/templet_message.rb
+- lib/wxapi/user.rb
+- lib/wxapi/utils.rb
+- lib/wxapi/version.rb
+- wxapi.gemspec
+homepage: https://github.com/xurenlu/wxapi
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.4
+signing_key:
+specification_version: 4
+summary: 微信公众号开发API，包含对微信公众号菜单栏、客服消息、模板消息、帐号管理等接口的封装，API长期更新维护，建议使用最新版本.
+test_files: []