wechat-sns 0.3 → 0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8241ec82a3b4c5bc58fa6cef8d01460b8dc8cfe1
-  data.tar.gz: 979479374d24ec788f4e6072dce4642bedd43ea0
+  metadata.gz: e1243379a4457716883ee3744a2c8b617a8d0801
+  data.tar.gz: 9611bd6bb6e351571c364cf0166acbcce1e1e7e7
 SHA512:
-  metadata.gz: 627cd9f16ec99f45e6cd067302d0214f48e29f83bf61b788a30eff2fd70f1364d727f11b29b1e43ed88be128bf4306b1ab951291c91814e4e4c14cb721c932b0
-  data.tar.gz: c56980daf80df6ed17d8e3c9adce03c3ecbc34745674366065aea8117d6b10137d404719ce587c2dfe673d94bf401be6c95aebd213ae1b8ea954eb399e17cdd3
+  metadata.gz: 2ac83a6c132dd7b6eb7b05fd10e2819757205564f1591dcf31447649cdaa5e60b4655a206ced0c7906d6430003b3068b208e338364d0e171aba6808773eaf5a6
+  data.tar.gz: 77faf0979f3346a05a85386ffad25aad19272007305457676524fbd339caee06efe5f9d2000e40c4bfadcda1e0e41c6f8006447bef89a920c7f5de953ac37c06

data/CHANGELOG.md

@@ -8,3 +8,6 @@
 
 ## v0.3
 1. User Profile wrapper class.
+
+## v0.4
+1, Improved Access Token wrapper class to paramiterize the Wechat App ID and Wechat App Secret.

data/README.md

@@ -23,9 +23,50 @@ Or install it yourself as:
 
 ## Usage
 
-Generate an authorize URL.
+[Generate an Authorize URL and Redirect 第一步：用户同意授权，获取code](http://mp.weixin.qq.com/wiki/9/01f711493b5a02f24b04365ac5d8fd95.html#.E7.AC.AC.E4.B8.80.E6.AD.A5.EF.BC.9A.E7.94.A8.E6.88.B7.E5.90.8C.E6.84.8F.E6.8E.88.E6.9D.83.EF.BC.8C.E8.8E.B7.E5.8F.96code)
 ```ruby
-redirect_to Wechat::SNS::AuthorizeLink.create(Rails.application.secrets.wechat_app_id, 'http://project.company.com/dashboards/~')
+redirect_to Wechat::SNS::AuthorizeLink.create(Rails.application.secrets.wechat_app_id, 'http://product.company.com/promotion/page.html')
+```
+
+[Get Access Token per Code 第二步：通过code换取网页授权access_token](http://mp.weixin.qq.com/wiki/9/01f711493b5a02f24b04365ac5d8fd95.html#.E7.AC.AC.E4.BA.8C.E6.AD.A5.EF.BC.9A.E9.80.9A.E8.BF.87code.E6.8D.A2.E5.8F.96.E7.BD.91.E9.A1.B5.E6.8E.88.E6.9D.83access_token)
+```ruby
+response = Wechat::SNS::AccessToken.create Rails.application.secrets.wechat_app_id, Rails.application.secrets.wechat_app_secret, params[:code]
+if response.present?
+  access_token  = response['access_token']
+  expires_in    = response['expires_in']
+  refresh_token = response['refresh_token']
+  open_id       = response['openid']
+  scope         = response['scope']
+  union_id      = response['unionid']
+end
+```
+
+[Refresh Access Token 第三步：刷新access_token（如果需要）](http://mp.weixin.qq.com/wiki/9/01f711493b5a02f24b04365ac5d8fd95.html#.E7.AC.AC.E4.B8.89.E6.AD.A5.EF.BC.9A.E5.88.B7.E6.96.B0access_token.EF.BC.88.E5.A6.82.E6.9E.9C.E9.9C.80.E8.A6.81.EF.BC.89)
+```ruby
+response = Wechat::SNS::AccessToken.update Rails.application.secrets.wechat_app_id, refresh_token
+if response.present?
+  access_token  = response['access_token']
+  expires_in    = response['expires_in']
+  refresh_token = response['refresh_token']
+  open_id       = response['openid']
+  scope         = response['scope']
+end
+```
+
+[Get User Profile per Access Token 第四步：拉取用户信息(需scope为 snsapi_userinfo)](http://mp.weixin.qq.com/wiki/9/01f711493b5a02f24b04365ac5d8fd95.html#.E7.AC.AC.E5.9B.9B.E6.AD.A5.EF.BC.9A.E6.8B.89.E5.8F.96.E7.94.A8.E6.88.B7.E4.BF.A1.E6.81.AF.28.E9.9C.80scope.E4.B8.BA_snsapi_userinfo.29)
+```ruby
+response = Wechat::Sns::UserProfile.load access_token, open_id
+if response.present? && response['errcode'].blank?
+  open_id        = response['openid']
+  nick_name      = response['nickname']
+  sex            = response['sex']
+  city           = response['city']
+  province       = response['province']
+  country        = response['country']
+  head_image_url = response['headimgurl']
+  privilege      = response['privilege']
+  union_id       = response['unionid']
+end
 ```
 
 ## Development

data/ROADMAP.md

@@ -8,3 +8,6 @@
 
 ## v0.3
 1. User Profile wrapper class.
+
+## v0.4
+1, Improved Access Token wrapper class to paramiterize the Wechat App ID and Wechat App Secret.

data/lib/wechat/sns/access_token.rb

@@ -44,10 +44,10 @@ class Wechat::SNS::AccessToken
   #   errcode: <ERROR_CODE>,
   #   errmsg:  <ERROR_MESSAGE>
   # }
-  def self.update(refresh_token)
+  def self.update(app_id, refresh_token)
     message = ::JSONClient.new.get 'https://api.weixin.qq.com/sns/oauth2/refresh_token',
       {
-        appid:         Rails.application.secrets.wechat_app_id,
+        appid:         app_id,
         grant_type:    'refresh_token',
         refresh_token: refresh_token
       }
@@ -72,11 +72,11 @@ class Wechat::SNS::AccessToken
   #   errcode: <ERROR_CODE>,
   #   errmsg:  <ERROR_MESSAGE>
   # }
-  def self.create(code)
+  def self.create(app_id, app_secret, code)
     message = ::JSONClient.new.get 'https://api.weixin.qq.com/sns/oauth2/access_token',
       {
-        appid:      Rails.application.secrets.wechat_app_id,
-        secret:     Rails.application.secrets.wechat_app_secret,
+        appid:      app_id,
+        secret:     app_secret,
         code:       code,
         grant_type: 'authorization_code'
       }

data/lib/wechat/sns/version.rb

@@ -1,5 +1,5 @@
 module Wechat
   module SNS
-    VERSION = '0.3'.freeze
+    VERSION = '0.4'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: wechat-sns
 version: !ruby/object:Gem::Version
-  version: '0.3'
+  version: '0.4'
 platform: ruby
 authors:
 - Topbit Du
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-02-18 00:00:00.000000000 Z
+date: 2016-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler