wechat-gate-updater 0.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '05826f541ea10d64326fdf81f707288381a50bbc07c9c5ff33aa9bccc91eea12'
+  data.tar.gz: e87102aa758d4c6f7e55dac92ca31f18a0231e7320613186c1e6f9be83eac747
+SHA512:
+  metadata.gz: 6031f7e8729571efcfde0c7814c896c9193626d25bb3d8704588b2c7967f80bb0fd91fb1759bf48d2eb03f2e1db313d533113d77e57b75a713b7112dc2303823
+  data.tar.gz: 62a136dd45c5cdfcc4140c40c6f5d3d850f3d55c4689a28fab398544afd2e6007313df530089fb8d164c1c26e16f741ec919e7b26d58a1824c5744363c624a88

data/.gitignore

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

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,49 @@
+PATH
+  remote: .
+  specs:
+    wechat-gate (0.1.6)
+      activesupport (>= 5.0.1)
+      rest-client (>= 1.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.1.4)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (~> 0.7)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    concurrent-ruby (1.0.5)
+    domain_name (0.5.20170404)
+      unf (>= 0.0.5, < 1.0.0)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    i18n (0.9.1)
+      concurrent-ruby (~> 1.0)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    minitest (5.10.3)
+    netrc (0.11.0)
+    rake (10.5.0)
+    rest-client (2.0.2)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    thread_safe (0.3.6)
+    tzinfo (1.2.4)
+      thread_safe (~> 0.1)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (>= 1.10)
+  rake (>= 10.0)
+  wechat-gate!
+
+BUNDLED WITH
+   1.15.3

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Lei Lee
+
+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,193 @@
+# WechatGate
+
+> 搬运 from [隔壁老李的微信开发Ruby Gem](https://github.com/eggmantv/wechat_gate)，原著未支持 Application::API，这里添加
+
+**微信公众平台开发库**
+
+支持的接口:
+
+- access_token(后端API使用)
+- 用户授权信息获取(OAuth2)
+- JS-SDK
+- 回复消息封装
+- 菜单接口
+- 素材接口
+
+功能特点:
+
+- 自动管理access_token和JS-SDK的ticket刷新和过期
+- 多微信公众号支持
+- 多环境支持(development, production)，方便本地测试
+- Controler和helper方法(微信session管理等等)
+- 接口简单，方便定制
+
+使用视频教程: [微信公众号开发](https://eggman.tv/c/s-wechat-development-using-ruby-on-rails)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'wechat-gate'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install wechat-gate
+
+## 公众号
+
+在开工之前你需要在微信公众账号平台做以下配置:
+
+1. 开通你的公众号（服务号），并开通微信认证（300元认证服务费）
+2. 在公众号后台“公众号设置” － “功能设置”中设置你的JS接口安全域名，就是你的公众号调用的网站的域名
+3. 在“接口权限” － “网页授权获取用户基本信息”中设置你的授权回调页面域名，这个用于OAuth2的回调域名认证
+4. 在“基本配置”中查看并配置你的AppID和AppSecret
+
+## 配置
+
+在Rails项目config目录下建立文件wechat.yml，并配置你的公众号信息.
+
+```
+# 区分不同的环境
+eggman:
+  development:
+    host: http://wechat-test1.eggman.tv
+
+    wechat_id: xxxxxxxxxx
+    app_id: xxxxxxxxxx
+    app_secret: xxxxxxxxxx
+
+    oauth2_redirect_uri: "http://wechat-test1.eggman.tv/wechat/users/callback"
+
+    push_url: "http://wechat-test1.eggman.tv/wechat/push"
+    push_token: xxxxxxxxxxxxxxxxxxxx
+  production:
+    host: https://eggman.tv
+
+    wechat_id: xxxxxxxxxx
+    app_id: xxxxxxxxxxxxxxxxxxxx
+    app_secret: xxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# 如果不需要多环境支持，也可以这样
+app_name:
+  app_id: <%= ENV['WECHAT_APP_NAME_APP_ID'] %>
+  app_secret: <%= ENV['WECHAT_APP_NAME_APP_SECRET'] %>
+  oauth2_redirect_uri: <%= ENV['WECHAT_APP_NAME_OAUTH2_REDIRECT_URI'] %>
+```
+
+然后在ApplicationController中指定当前要读取的公众号名称：
+
+```
+self.wechat_gate_app_name = 'eggman'
+```
+
+## 后端调用
+
+后台API操作(比如微信用户信息获取等等操作)。
+
+默认情况下在controller中已经初始化了配置，方法为**wechat_gate_config**，直接使用就行。
+
+
+```ruby
+wechat_gate_config.users # 获取用户列表
+wechat_gate_config.user('ONE_OPEN_ID') # 获取一个用户的详细信息
+wechat_gate_config.access_token # 获取当前access_token
+
+# OAuth 2
+wechat_gate_config.oauth2_entrance_url(scope: "snsapi_userinfo", state: "CURENT_STATE") # 获取当前OAuth2授权入口URL
+wechat_gate_config.oauth2_access_token("TOKEN") # 根据OAuth2返回的TOKEN获取access_token
+wechat_gate_config.oauth2_user("ACCESS_TOKEN", "ONE_OPEN_ID") # 获取一个用户的信息
+
+wechat_gate_config.medias # 获取素材列表, 参数type: image | video | voice | news (图文)
+
+wechat_gate_config.menu_get # 获取菜单
+wechat_gate_config.menu_create(MENU_HASH) # 创建菜单
+
+wechat_gate_config.generate_js_request_params(REFERER_URL) # 返回JS-SDK的验证参数，供前端JS-SDK使用
+```
+
+当然你也可以手工来初始化配置，甚至指定配置文件的路径：
+
+```
+config = WechatGate::Config.new('eggman', '/path/to/what/ever/you/want.yml')
+```
+
+access_token和JS_SDK中ticket都有过期时间和刷新次数限制，这里已经考虑了，你可以不用管，如果你想手工刷新，可以这样:
+
+```
+config.refresh_access_token
+config.refresh_jsapi_ticket
+```
+
+**配置文件支持erb**
+
+> 更多接口和文档请直接看源码，写的很详细
+
+## JS-SDK
+
+```ruby
+  def ticket
+    url = CGI.unescape(params[:url]) # 微信中用户访问的页面
+    @data = wechat_gate_config.generate_js_request_params(url) # 生成微信JS-SDK所需的jsapi_ticket，signature等等参数供前段js使用
+    render content_type: "application/javascript"
+  end
+```
+
+ticket.js.erb:
+
+```
+var wxServerConfig = <%= @data.to_json.html_safe %>;
+<%= params[:callback] %>();
+```
+
+然后在微信端页面引入以下代码:
+
+```js
+(function() {
+  var ticket = document.createElement("script");
+  ticket.src = "http://localhost/api/wechat_ticket/ticket.js?url=" + encodeURIComponent(window.location.href.split('#')[0]) + "&callback=wxCallback";
+  var s = document.getElementsByTagName("script")[0];
+  s.parentNode.insertBefore(ticket, s);
+})();
+```
+
+## 其他功能
+
+### 自定义菜单
+
+首先设置菜单配置文件，config/wechat_menu.yml，支持erb，格式请参考[微信自定义菜单文档](https://mp.weixin.qq.com/wiki):
+
+```
+button:
+  - type: view
+    name: 我的2
+    url: <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'profile') %>
+  - type: view
+    name: 课程
+    sub_button:
+      - type: view
+        name: 免费课程
+        url:  <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'free') %>
+      - type: view
+        name: 付费课程
+        url:  <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'paid') %>
+```
+
+> 其中的**@config**变量为当前微信公众号实例，请不要修改，直接使用
+
+然后执行rake任务:
+
+```shell
+$rails wechat_gate:create_menu APP_NAME=eggman CONFIG=/path/to/wechat.yml MENU=/path/to/wechat_menu.yml
+```
+
+其中，CONFIG默认为config/wechat.yml，MENU默认为config/wechat_menu.yml，APP_NAME必须指定
+
+## TODO
+
+添加测试

data/RELEASE.md

@@ -0,0 +1,11 @@
+# v0.1.5
+
+  - add app_id to js-sdk API
+
+# v0.1.4
+
+  - add create_menu rake task
+
+# v0.1.3
+
+# v0.1.2

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "wechat-gate"
+
+# 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

data/bin/refresh_token_and_ticket

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "wechat-gate"
+
+# usage:
+#   output_type: "/file/to/write/js/variable" | ruby | js
+#   refresh_token_and_ticket app_name page_url output_type
+#
+
+WechatGate::Config.new(ARGV[0]) do |config|
+  config.write_token_to_file ARGV[1], ARGV[2]
+end

data/bin/setup

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

data/config/wechat.yml

@@ -0,0 +1,18 @@
+# 请参考这个配置文件
+#
+app_name:
+  development:
+    app_id: <%= ENV['WECHAT_APP_NAME_APP_ID'] %>
+    app_secret: <%= ENV['WECHAT_APP_NAME_APP_SECRET'] %>
+    oauth2_redirect_uri: <%= ENV['WECHAT_APP_NAME_OAUTH2_REDIRECT_URI'] %>
+
+  production:
+    app_id: <%= ENV['WECHAT_APP_NAME_APP_ID'] %>
+    app_secret: <%= ENV['WECHAT_APP_NAME_APP_SECRET'] %>
+    oauth2_redirect_uri: <%= ENV['WECHAT_APP_NAME_OAUTH2_REDIRECT_URI'] %>
+
+# 如果不需要多环境支持，也可以这样
+app_name:
+  app_id: <%= ENV['WECHAT_APP_NAME_APP_ID'] %>
+  app_secret: <%= ENV['WECHAT_APP_NAME_APP_SECRET'] %>
+  oauth2_redirect_uri: <%= ENV['WECHAT_APP_NAME_OAUTH2_REDIRECT_URI'] %>

data/lib/tasks/wechat_gate.rake

@@ -0,0 +1,22 @@
+require 'wechat_gate/exception'
+
+namespace :wechat_gate do
+
+  def validate_envs
+    raise WechatGate::Exception::ConfigException, 'need specify APP_NAME!' unless ENV['APP_NAME']
+  end
+
+  desc "create menu, APP_NAME=app_name, CONFIG=/path/to/config/file.yml, MENU=/path/to/menu/config/file.yml"
+  task :create_menu => :environment do
+    validate_envs
+
+    @config = WechatGate::Config.new(ENV['APP_NAME'], ENV['CONFIG'])
+
+    menu_file = ENV['MENU']
+    menu_file = "#{Dir.pwd}/config/wechat_menu.yml" unless menu_file
+    raise WechatGate::Exception::ConfigException, "MENU #{menu_file} not found!" unless File.exists?(menu_file)
+
+    menu = YAML.load(ERB.new(File.read(menu_file)).result(binding))
+    @config.menu_create(JSON.generate(menu))
+  end
+end

data/lib/wechat-gate.rb

@@ -0,0 +1,8 @@
+require "wechat_gate/version"
+require "wechat_gate/config"
+require "wechat_gate/railtie" if defined?(Rails)
+
+if defined?(ActionController)
+  ActionController::Base.send(:include, WechatGate::Controller)
+  ActionController::API.send(:include, WechatGate::Controller)
+end

data/lib/wechat_gate/config.rb

@@ -0,0 +1,64 @@
+require 'yaml'
+require 'erb'
+require 'wechat_gate/tokens/access_token'
+require 'wechat_gate/tokens/jsapi_ticket'
+require 'wechat_gate/tokens/ext'
+require 'wechat_gate/oauth'
+require 'wechat_gate/user'
+require 'wechat_gate/menu'
+require 'wechat_gate/media'
+require 'wechat_gate/message'
+require 'wechat_gate/send_message'
+require 'wechat_gate/exception'
+require 'wechat_gate/controller'
+
+module WechatGate
+  class Config
+
+    attr_reader :app_name
+    attr_reader :config
+    attr_reader :output_type
+
+    include WechatGate::Tokens::AccessToken
+    include WechatGate::Tokens::JsapiTicket
+    include WechatGate::Tokens::Ext
+    include WechatGate::Oauth
+    include WechatGate::User
+    include WechatGate::Menu
+    include WechatGate::Media
+    include WechatGate::Message
+    include WechatGate::SendMessage
+
+    def initialize app_name, config_file = nil
+      unless config_file
+        if defined?(Rails)
+          config_file = "#{Rails.root}/config/wechat.yml"
+        end
+      end
+
+      raise Exception::ConfigException, "no wechat configuration file found!" unless config_file
+      unless File.exists?(config_file)
+        raise Exception::ConfigException, "configuration file does not exist!"
+      end
+
+      config_text = ERB.new(File.read(config_file)).result
+      configs = YAML.load(config_text)
+      unless configs[app_name]
+        raise Exception::ConfigException, "no configuration found for app: #{app_name}!"
+      end
+
+      @config = if defined?(Rails)
+        configs[app_name][Rails.env] || configs[app_name]
+      else
+        configs[app_name]
+      end
+
+      @app_name = app_name
+
+      yield(self) if block_given?
+    end
+
+  end
+
+
+end

data/lib/wechat_gate/controller.rb

@@ -0,0 +1,73 @@
+require 'wechat_gate/exception'
+
+module WechatGate
+  module Controller
+
+    def self.included base
+      base.send :include, InstanceMethods
+
+      base.class_eval do
+        helper_method :is_wechat_logged_in?
+        helper_method :current_open_id
+
+        class_attribute :wechat_gate_app_name
+      end
+    end
+
+    module InstanceMethods
+      protected
+      def wechat_gate_setup
+        unless self.class.wechat_gate_app_name
+          raise Exception::ConfigException, "please specify wechat_gate_app_name!"
+        end
+
+        @wechat_gate_config = WechatGate::Config.new(self.class.wechat_gate_app_name)
+      end
+
+      def wechat_gate_config
+        @wechat_gate_config ||= wechat_gate_setup
+      end
+
+      def is_wechat_logged_in?
+        !!session[:user_open_id]
+      end
+
+      def current_open_id
+        session[:user_open_id]
+      end
+
+      def wechat_user_signin(user_open_id)
+        session[:user_open_id] = user_open_id
+      end
+
+      def wechat_user_auth
+        unless is_wechat_logged_in?
+          redirect_to wechat_gate_config.oauth2_entrance_url(scope: "snsapi_base")
+        end
+      end
+
+      def bind_user_with_open_id user_model
+        if is_wechat_logged_in? and user_model.open_id.blank?
+          user_model.update_attribute :open_id, current_open_id
+        end
+      end
+
+      def is_legal_from_wechat_server?
+        data = [
+          wechat_gate_config.config["push_token"],
+          params[:timestamp],
+          params[:nonce]
+        ]
+
+        Digest::SHA1.hexdigest(data.sort.join('')) == params[:signature]
+      end
+
+      def check_wechat_server
+        unless is_legal_from_wechat_server?
+          render text: "illegal signature!"
+        end
+      end
+    end
+
+  end
+end

data/lib/wechat_gate/exception.rb

@@ -0,0 +1,7 @@
+module WechatGate
+  module Exception
+    
+    class ConfigException < StandardError; end
+
+  end
+end

data/lib/wechat_gate/media.rb

@@ -0,0 +1,24 @@
+require 'wechat_gate/request'
+
+module WechatGate
+  module Media
+    #
+    # http://mp.weixin.qq.com/wiki/15/8386c11b7bc4cdd1499c572bfe2e95b3.html
+    #
+
+    #   type: image | video | voice | news (图文)
+    def medias(type = 'news', offset = 0, count = 20)
+      WechatGate::Request.send(
+        "https://api.weixin.qq.com/cgi-bin/material/batchget_material?access_token=#{self.access_token}",
+        :post,
+        {
+          "type": type,
+          "offset": offset,
+          "count": count
+        }.to_json
+      )
+    end
+  end
+
+
+end

data/lib/wechat_gate/menu.rb

@@ -0,0 +1,21 @@
+require 'wechat_gate/request'
+
+module WechatGate
+  module Menu
+    def menu_get
+      WechatGate::Request.send(
+        "https://api.weixin.qq.com/cgi-bin/menu/get?access_token=#{self.access_token}"
+      )
+    end
+
+    def menu_create(menu_hash)
+      WechatGate::Request.send(
+        "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=#{self.access_token}",
+        :post,
+        menu_hash
+      )
+    end
+  end
+
+
+end

data/lib/wechat_gate/message.rb

@@ -0,0 +1,53 @@
+module WechatGate
+  module Message
+    #
+    # http://mp.weixin.qq.com/wiki/17/f298879f8fb29ab98b2f2971d42552fd.html
+    #
+    # 消息发送只能是被动的，就是微信会把用户的聊天数据推送到服务器端，然后服务器利用返回值作出相应
+    #
+
+    def message_body(type, to, body)
+      content = case type.to_sym
+      when :text
+        %Q{
+          <Content><![CDATA[#{body}]]></Content>
+        }
+      when :image
+        # body: media_id
+        %Q{
+          <Image>
+            <MediaId><![CDATA[#{body}]]></MediaId>
+          </Image>
+        }
+      when :voice
+        %Q{
+          <Voice>
+            <MediaId><![CDATA[#{body}]]></MediaId>
+          </Voice>
+        }
+      when :video
+        # body: { media_id: MEDIA_ID, title: TITLE, description: DESCRIPTION }
+        %Q{
+          <Video>
+            <MediaId><![CDATA[#{body[:media_id]}]]></MediaId>
+            <Title><![CDATA[#{body[:title]}]]></Title>
+            <Description><![CDATA[#{body[:description]}]]></Description>
+          </Video>
+        }
+      end
+
+      %Q{
+        <xml>
+          <ToUserName><![CDATA[#{to}]]></ToUserName>
+          <FromUserName><![CDATA[#{self.config['wechat_id']}]]></FromUserName>
+          <CreateTime>#{Time.now.to_i}</CreateTime>
+          <MsgType><![CDATA[#{type}]]></MsgType>
+          #{content}
+        </xml>
+      }
+    end
+
+  end
+
+
+end

data/lib/wechat_gate/oauth.rb

@@ -0,0 +1,80 @@
+require 'rest-client'
+require 'wechat_gate/request'
+
+module WechatGate
+  module Oauth
+    #
+    #
+    # 此module中的access_token是微信网页授权OAuth2.0的专用access_token，和其他modules中所需需要的access_token
+    # 不是一个概念，这里的access_token主要就是用户非公众号的关注用户来进行网页授权访问的，其中：
+    #   scope:
+    #     snsapi_base 用于公众号已关注用户，已关注的用户默认已经得到了授权，这里只是为了取得当前用户的openid，
+    #       此时对用户的所有操作 (ex: WechatGate::User模块) 可以直接利用系统基本的access_token (WechatGate::Tokens::AccessToken模块) 来进行。
+    #     snsapi_userinfo 用户非关注用户取得授权，这里遵循标准的OAuth2.0授权流程，取得用户信息需要利用本模块中的方法来进行。
+    #       这里的access_token是和用户绑定的。
+    #
+    #
+
+    #
+    # 用户点击授权入口页面
+    #
+    def oauth2_entrance_url(ops = {})
+      ops = {
+        state: 'empty', # 自定义参数值
+        redirect_uri: self.config["oauth2_redirect_uri"],
+        scope: 'snsapi_base' # snsapi_base | snsapi_userinfo
+      }.merge(ops)
+
+      "https://open.weixin.qq.com/connect/oauth2/authorize?appid=#{self.config['app_id']}&redirect_uri=#{CGI.escape(ops[:redirect_uri])}&response_type=code&scope=#{ops[:scope]}&state=#{ops[:state]}#wechat_redirect"
+    end
+
+    # TODO
+    #   这里目前需要调用该gem的应用自身来保存用户的access_token, refresh_token, openid等参数以及判断有效期
+    #   不过这个地方也可以不做缓存，微信在这个地方没有限制API的调用次数。
+    #
+    # code:
+    #   code来源于网页端redirect_uri页面得到的微信端返回的参数，专门用户取得下一步的access_token
+    # 该接口会返回：
+    # {
+    #    "access_token" => "access_token",
+    #    "expires_in"=>7200,
+    #    "refresh_token"=>"refresh_token",
+    #    "openid"=>"MZkwG5sAx-d4PMQ6Lq1xisE",
+    #    "scope"=>"snsapi_base"
+    #  }
+    # 此时已经获得了用户的openid，如果用户为公众号的订阅用户，就可以直接利用Tokens::AccessToken的token来对改用户调用业务接口了，
+    # 此时这里的access_token意义就不大了，这里的access_token和Tokens::AccessToken的token是完全不一样的。
+    #
+    def oauth2_access_token(code)
+      WechatGate::Request.send("https://api.weixin.qq.com/sns/oauth2/access_token?appid=#{self.config['app_id']}&secret=#{self.config['app_secret']}&code=#{code}&grant_type=authorization_code")
+    end
+
+    # access_token拥有较短的有效期，当access_token超时后，可以使用refresh_token进行刷新，
+    # refresh_token拥有较长的有效期（7天、30天、60天、90天），当refresh_token失效的后，需要用户重新授权。
+    #
+    def oauth2_access_token_valid?(access_token, openid)
+      WechatGate::Request.send("https://api.weixin.qq.com/sns/auth?access_token=#{access_token}&openid=#{openid}")
+    end
+
+    # 利用refresh_token刷新access_token
+    #
+    # response:
+    # {
+    #    "access_token":"ACCESS_TOKEN",
+    #    "expires_in":7200,
+    #    "refresh_token":"REFRESH_TOKEN",
+    #    "openid":"OPENID",
+    #    "scope":"SCOPE"
+    # }
+    def oauth2_refresh_access_token(refresh_token)
+      WechatGate::Request.send("https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=#{self.config['app_id']}&grant_type=refresh_token&refresh_token=#{refresh_token}")
+    end
+
+    # 获取用户信息
+    #
+    def oauth2_user(access_token, openid)
+      WechatGate::Request.send("https://api.weixin.qq.com/sns/userinfo?access_token=#{access_token}&openid=#{openid}&lang=zh_CN")
+    end
+  end
+
+end

data/lib/wechat_gate/railtie.rb

@@ -0,0 +1,8 @@
+module WechatGate
+  require 'rails'
+
+  class Railtie < Rails::Railtie
+    rake_tasks { load "tasks/wechat_gate.rake" }
+  end
+
+end

data/lib/wechat_gate/request.rb

@@ -0,0 +1,34 @@
+require 'rest-client'
+
+module WechatGate
+  module Request
+    def self.send(url, method = :get, payload = nil, headers = nil, &block)
+      method = method.to_sym
+
+      opts = {
+        method: method,
+        url: url,
+        verify_ssl: false
+      }
+      if method == :post and payload
+        opts.merge! payload: payload
+      end
+
+      if headers
+        opts.merge! headers: headers
+      end
+
+      response = RestClient::Request.execute(opts)
+      response = JSON.parse(response)
+      raise response.to_s if response['errmsg'] and response['errmsg'] != 'ok'
+
+      if block_given?
+        yield(response)
+      else
+        response
+      end
+    end
+  end
+
+
+end

data/lib/wechat_gate/send_message.rb

@@ -0,0 +1,138 @@
+require 'active_support/core_ext/module/attribute_accessors'
+require 'wechat_gate/request'
+
+module WechatGate
+  module SendMessage
+
+    #
+    # https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140549&token=&lang=zh_CN
+    # 这个接口有发送限制，服务号每月只能发送4次，订阅号每天一次
+    #
+    def mass_send open_ids, msg_options = {}
+      payload = {
+         "touser": [open_ids].flatten,
+          "msgtype": "text",
+          "text": { "content": "hello from boxer."}
+      }.merge(msg_options)
+
+      WechatGate::Request.send(
+        "https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=#{self.access_token}",
+        :post,
+        payload.to_json
+      )
+    end
+
+    #
+    # 这个是微信的私有接口，在微信网页端才能使用，给单个用户发消息，而且没有发送数量限制，
+    # 这里是模拟公众号登录，然后给用户发送消息（在“用户管理”页面点击单个用户）
+    #
+    # **这个接口要求48小时内只能发送20条**
+    # **用户在48小时内与公众账号只要发生互动（点击公众号菜单或者发过消息），阀值就会刷新**
+    #
+    # Request URL:https://mp.weixin.qq.com/cgi-bin/singlesend?t=ajax-response&f=json&token=1927434739&lang=zh_CN
+    # Request Method:POST
+    # Query String:
+    #   t:ajax-response
+    #   f:json
+    #   token:1927434739
+    #   lang:zh_CN
+    # Form Data
+    #   token:1927434739
+    #   lang:zh_CN
+    #   f:json
+    #   ajax:1
+    #   random:0.9569772763087352
+    #   type:1
+    #   content:ll
+    #   tofakeid:oMZZkwziWkGiXq3-RjGHcgXn6v70
+    #   imgcode:
+    #
+    mattr_accessor :single_send_cookies
+    mattr_accessor :single_send_token
+    mattr_accessor :single_send_cookies_refreshed_at
+    mattr_accessor :single_send_cookies_expired_in
+
+    mattr_accessor :single_send_ua
+
+    #
+    # 在公众号端没有cookie过期的概念，这里把登录后的cookie和token缓存起来，为了不频繁的登录公众号
+    #
+    # **这个功能只能在生产环境的真实公众账号中测试，不支持在沙盒中测试**
+    #
+    self.single_send_cookies_refreshed_at = Time.now.to_i
+    self.single_send_cookies_expired_in = 3600
+
+    self.single_send_ua = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.110 Safari/537.36"
+
+    def single_send open_id, content
+      single_send_if_need_refresh_cookie
+
+      opts = {
+        method: :post,
+        url: "https://mp.weixin.qq.com/cgi-bin/singlesend?t=ajax-response&f=json&token=#{self.single_send_token}&lang=zh_CN",
+        verify_ssl: false,
+        payload: {
+          token: self.single_send_token,
+          lang: "zh_CN",
+          f: "json",
+          ajax: 1,
+          random: Random.rand,
+          type: 1, # 文本消息
+          content: content,
+          tofakeid: open_id,
+          imgcode: ""
+        }.to_query,
+        headers: {
+          'User-Agent': self.single_send_ua,
+          'Cookie': self.single_send_cookies,
+          'Referer': "https://mp.weixin.qq.com/cgi-bin/singlesendpage?t=message/send&action=index&tofakeid=#{open_id}&token=#{self.single_send_token}&lang=zh_CN"
+        }
+      }
+
+      response = RestClient::Request.execute(opts)
+      data = JSON.parse(response)
+      raise response.to_s if data['errmsg'] and data['errmsg'] != 'ok'
+      data
+    end
+
+    private
+    def single_send_if_need_refresh_cookie
+      if self.single_send_cookies.nil? ||
+        (Time.now.to_i - self.single_send_cookies_refreshed_at > self.single_send_cookies_expired_in)
+        single_send_login_and_refresh_cookies_w_token
+      end
+    end
+
+    #
+    # 登录公众号，缓存登录后的cookie和token
+    #
+    def single_send_login_and_refresh_cookies_w_token
+      opts = {
+        method: :post,
+        url: "https://mp.weixin.qq.com/cgi-bin/login?lang=zh_CN",
+        verify_ssl: false,
+        payload: {
+          username: self.config['wechat_login_username'],
+          pwd: Digest::MD5.hexdigest(self.config['wechat_login_password']),
+          imgcode: "",
+          f: "json"
+        }.to_query,
+        headers: {
+          'User-Agent': self.single_send_ua,
+          'Referer': 'https://mp.weixin.qq.com/'
+        }
+      }
+
+      response = RestClient::Request.execute(opts)
+      data = JSON.parse(response)
+      raise response.to_s if data['errmsg'] and data['errmsg'] != 'ok'
+
+      self.single_send_cookies = response.cookies.map {|k, v| k + "=" + v}.join("; ")
+      data["redirect_url"].gsub(/token=(\d+)/) { |x| self.single_send_token = $1 }
+      self.single_send_cookies_refreshed_at = Time.now.to_i
+    end
+
+  end
+
+
+end

data/lib/wechat_gate/tokens/access_token.rb

@@ -0,0 +1,30 @@
+require 'wechat_gate/tokens/base'
+
+module WechatGate
+  module Tokens
+    module AccessToken
+      def self.included base
+        base.send :include, InstanceMethods
+      end
+
+      module InstanceMethods
+        def access_token
+          token = WechatGate::Tokens::AccessToken::Get.refresh(self)
+        end
+      end
+
+      class Get < WechatGate::Tokens::Base
+        def url
+          "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=#{@config.config['app_id']}&secret=#{@config.config['app_secret']}"
+        end
+
+        def save response
+          File.open(saved_file, 'w') do |f|
+            f.puts "#{Time.now.to_i} #{response['access_token']}"
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/wechat_gate/tokens/base.rb

@@ -0,0 +1,66 @@
+require 'rest-client'
+require 'wechat_gate/request'
+
+module WechatGate
+  module Tokens
+    class Base
+
+      def self.refresh config
+        handler = new(config)
+        handler.run
+      end
+
+      def initialize config
+        @config = config
+      end
+
+      def run
+        fetch if is_expired?
+        File.readlines(saved_file).first.chomp.split(' ').last
+      end
+
+      def expired_in
+        7100
+      end
+
+      protected
+      def url
+        raise "need to implement #ur method in sub-class"
+      end
+
+      def save response
+        raise "need to implement #save method in sub-class"
+      end
+
+      private
+      def fetch
+        WechatGate::Request.send(url) do |response|
+          save response
+          response
+        end
+      end
+
+      def saved_file
+        # File.expand_path("../../../../data/APP-#{@config.app_name}-#{self.class.name}", __FILE__)
+        "/tmp/APP-#{@config.app_name}-#{self.class.name}-#{@config.config['app_id']}"
+      end
+
+      def is_expired?
+        if File.exists?(saved_file)
+          line = File.readlines(saved_file).first
+          unless line
+            return true
+          else
+            line = line.chomp
+            return Time.now.to_i - line.split(' ').first.to_i >= expired_in
+          end
+        else
+          FileUtils.touch(saved_file)
+          return true
+        end
+      end
+
+    end
+
+  end
+end

data/lib/wechat_gate/tokens/ext.rb

@@ -0,0 +1,50 @@
+module WechatGate
+  module Tokens
+    module Ext
+      # please refer
+      #   http://mp.weixin.qq.com/wiki/7/aaa137b55fb2e0456bf8dd9148dd613f.html
+      #
+      def generate_js_request_params current_page_url
+        current_page_url = current_page_url.gsub(/#.*/, '')
+
+        letters = ('a'..'z').to_a + (0..9).to_a
+        word_creator = proc { letters.sample }
+        noncestr = []
+        16.times { noncestr << word_creator.call }
+
+        params = {
+          "jsapi_ticket" => self.jsapi_ticket,
+          "noncestr" => noncestr.join,
+          "timestamp" => Time.now.to_i,
+          "url" => current_page_url
+        }
+
+        sign_string = params.keys.sort.inject([]) { |m, n| m << "#{n}=#{params[n]}" }.join('&')
+        sign = Digest::SHA1.hexdigest(sign_string)
+        params["signature"] = sign
+        params["app_id"] = self.config['app_id']
+
+        params
+      end
+
+      def write_token_to_file current_page_url, output_type
+        params = generate_js_request_params(current_page_url)
+        case output_type
+        when /\// # write to file
+          f = File.open(output_type, 'w')
+          f.write %Q{<script>var wxServerConfig = #{params.to_json}</script>}
+          f.close
+        when 'ruby'
+          params
+        when 'js'
+          params.to_json
+        else
+          params
+        end
+      end
+
+
+    end
+
+  end
+end

data/lib/wechat_gate/tokens/jsapi_ticket.rb

@@ -0,0 +1,31 @@
+require 'wechat_gate/tokens/base'
+
+module WechatGate
+  module Tokens
+    module JsapiTicket
+      def self.included base
+        base.send :include, InstanceMethods
+      end
+
+      module InstanceMethods
+        def jsapi_ticket
+          token = WechatGate::Tokens::JsapiTicket::Get.refresh(self)
+        end
+      end
+
+      class Get < WechatGate::Tokens::Base
+        def url
+          token = WechatGate::Tokens::AccessToken::Get.refresh(@config)
+          "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=#{token}&type=jsapi"
+        end
+
+        def save response
+          File.open(saved_file, 'w') do |f|
+            f.puts "#{Time.now.to_i} #{response['ticket']}"
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/wechat_gate/user.rb

@@ -0,0 +1,16 @@
+require 'wechat_gate/request'
+
+module WechatGate
+  module User
+    def users(next_openid = nil)
+      WechatGate::Request.send("https://api.weixin.qq.com/cgi-bin/user/get?access_token=#{self.access_token}&next_openid=#{next_openid}")
+    end
+
+    def user(openid)
+      WechatGate::Request.send("https://api.weixin.qq.com/cgi-bin/user/info?access_token=#{self.access_token}&openid=#{openid}&lang=zh_CN")
+    end
+
+  end
+
+
+end

data/lib/wechat_gate/version.rb

@@ -0,0 +1,3 @@
+module WechatGate
+  VERSION = "0.1.6"
+end

data/wechat-gate.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'wechat_gate/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "wechat-gate-updater"
+  spec.version       = WechatGate::VERSION
+  spec.authors       = ["Lei Lee"]
+  spec.email         = ["qinyuanmao.live@gmail.com"]
+
+  spec.summary       = %q{隔壁家老李的微信开发Ruby Gem}
+  spec.description   = %q{接口简单易用，实在是微信开发必备之好Gem}
+  spec.homepage      = "https://github.com/qinyuanmao/wechat_gate"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "rest-client", '>= 1.8'
+  spec.add_dependency "activesupport", '>= 5.0.1'
+
+  spec.add_development_dependency "bundler", ">= 1.10"
+  spec.add_development_dependency "rake", ">= 10.0"
+
+end

metadata

@@ -0,0 +1,130 @@
+--- !ruby/object:Gem::Specification
+name: wechat-gate-updater
+version: !ruby/object:Gem::Version
+  version: 0.1.6
+platform: ruby
+authors:
+- Lei Lee
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-02-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.0.1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !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'
+description: 接口简单易用，实在是微信开发必备之好Gem
+email:
+- qinyuanmao.live@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- RELEASE.md
+- Rakefile
+- bin/console
+- bin/refresh_token_and_ticket
+- bin/setup
+- config/wechat.yml
+- lib/tasks/wechat_gate.rake
+- lib/wechat-gate.rb
+- lib/wechat_gate/config.rb
+- lib/wechat_gate/controller.rb
+- lib/wechat_gate/exception.rb
+- lib/wechat_gate/media.rb
+- lib/wechat_gate/menu.rb
+- lib/wechat_gate/message.rb
+- lib/wechat_gate/oauth.rb
+- lib/wechat_gate/railtie.rb
+- lib/wechat_gate/request.rb
+- lib/wechat_gate/send_message.rb
+- lib/wechat_gate/tokens/access_token.rb
+- lib/wechat_gate/tokens/base.rb
+- lib/wechat_gate/tokens/ext.rb
+- lib/wechat_gate/tokens/jsapi_ticket.rb
+- lib/wechat_gate/user.rb
+- lib/wechat_gate/version.rb
+- wechat-gate.gemspec
+homepage: https://github.com/qinyuanmao/wechat_gate
+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.1.4
+signing_key:
+specification_version: 4
+summary: 隔壁家老李的微信开发Ruby Gem
+test_files: []