ringcentral-sdk 0.8.2 → 0.9.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d48fd9aeb0ce08172f73e2922121f31713cbd626
-  data.tar.gz: 5ae74b326aed1c61ba8a98745174a3a7d19eb2dc
+SHA256:
+  metadata.gz: 1540372aa98b7028d885a28cc968a3348cf39c19611e2d86dbbcd67e115152bd
+  data.tar.gz: d6e4c9cbacec4d74422b2c692ac0f99e4213191e7ec47e43d5205776b1c60808
 SHA512:
-  metadata.gz: d2cfe606abaa3f47c4b1b745f15eb1ce7bc2f00258ccf31aca1ab16210aba4de87488df119646eee6b6183bf19bf18ade336fd626e5125606eed2c716b4e260d
-  data.tar.gz: e669a6ba874cf06b7190300fdeb6b23102d820801370644470619c8d1d73e1b6591370465e56eb3d54e958d4d887682952aee99bedc697ce25925cb9770cdef5
+  metadata.gz: accae1e8fa5df89849746124c4f5f51587b7c9d67c4bf8498d5c726bbc541719a2b2117aa278535271cba3ddc0602b76827140a6a2bc25fec3a4fae1613eecef
+  data.tar.gz: ba5d969dabb7b891f2b22597097388e2c7a08dff9262dcd209be7bdbaa9da49c35ce18b48502fb982889c4a7a138128e79c9e2c6ecdcebbcccb41c9cc5ca8676

data/README.md

@@ -1,9 +1,17 @@
-# ringcentral-ruby
+# RingCentral SDK for Ruby
 
-[![Build Status](https://travis-ci.org/ringcentral/ringcentral-ruby.svg?branch=master)](https://travis-ci.org/ringcentral/ringcentral-ruby)
-[![Coverage Status](https://coveralls.io/repos/github/ringcentral/ringcentral-ruby/badge.svg?branch=master)](https://coveralls.io/github/ringcentral/ringcentral-ruby?branch=master)
+[![Ruby](https://github.com/ringcentral/ringcentral-ruby/actions/workflows/ruby.yml/badge.svg)](https://github.com/ringcentral/ringcentral-ruby/actions/workflows/ruby.yml)
+[![Twitter](https://img.shields.io/twitter/follow/ringcentraldevs.svg?style=social&label=follow)](https://twitter.com/RingCentralDevs)
 
-Ruby SDK for RingCentral.
+__[RingCentral Developers](https://developer.ringcentral.com/api-products)__ is a cloud communications platform which can be accessed via more than 70 APIs. The platform's main capabilities include technologies that enable:
+__[Voice](https://developer.ringcentral.com/api-products/voice), [SMS/MMS](https://developer.ringcentral.com/api-products/sms), [Fax](https://developer.ringcentral.com/api-products/fax), [Glip Team Messaging](https://developer.ringcentral.com/api-products/team-messaging), [Data and Configurations](https://developer.ringcentral.com/api-products/configuration)__.
+
+[API Reference](https://developer.ringcentral.com/api-docs/latest/index.html) and [APIs Explorer](https://developer.ringcentral.com/api-explorer/latest/index.html).
+
+
+## Getting help and support
+
+If you are having difficulty using this SDK, or working with the RingCentral API, please visit our [developer community forums](https://community.ringcentral.com/spaces/144/) for help and to get quick answers to your questions. If you wish to contact the RingCentral Developer Support team directly, please [submit a help ticket](https://developers.ringcentral.com/support/create-case) from our developer website.
 
 
 ## Installation
@@ -13,6 +21,15 @@ gem install ringcentral-sdk
 ```
 
 
+### Name collision with `ringcentral` gem
+
+The `ringcentral` gem is using RingCentral's legacy API which was End-of-Lifed in 2018. Everyone is recommended to move to the REST API.
+
+If you have both the `ringcentral` and `ringcentral-sdk` gems installed, you will run into a collision error when attempting to initialize the `ringcentral-sdk` RingCentral SDK.
+
+The solution is `gem uninstall ringcentral`
+
+
 ## Documentation
 
 https://developer.ringcentral.com/api-docs/latest/index.html
@@ -23,28 +40,66 @@ https://developer.ringcentral.com/api-docs/latest/index.html
 ```ruby
 require 'ringcentral'
 
-rc = RingCentral.new(ENV['clientId'], ENV['clientSecret'], ENV['server'])
-rc.authorize(username: ENV['username'], extension: ENV['extension'], password: ENV['password'])
+rc = RingCentral.new('clientID', 'clientSecret', 'serverURL')
+rc.authorize(username: 'username', extension: 'extension', password: 'password')
 
 # get
 r = rc.get('/restapi/v1.0/account/~/extension/~')
 expect(r).not_to be_nil
-expect('101').to eq(JSON.parse(r.body)['extensionNumber'])
+expect('101').to eq(r.body['extensionNumber'])
+```
+
+
+## How to specify query parameters
+
+### for get & delete
+
+```ruby
+rc.get('/restapi/v1.0/account/~/extension', { hello: 'world' })
+```
+
+### for post, put & patch
+
+```ruby
+rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: body, params: { hello: 'world' })
 ```
 
+### multi-value query parameter
+
+```ruby
+rc.get('/restapi/v1.0/account/~/extension', { hello: ['world1', 'world2'] })
+```
+
+Above will be translated to `/restapi/v1.0/account/~/extension?hello=world1&hello=world2`.
+
 
 ### Token Refresh
 
-Access token expires. You need to call `rc.refresh()` before it expores.
+Access token expires. You need to call `rc.refresh()` before it expires.
 If you want the SDK to do auto refresh please `rc.auto_refresh = true` before authorization.
 
 
+### Load preexisting token
+
+Let's say you already have a token. Then you can load it like this: `rc.token = your_token_object`.
+
+The benifits of loading a preexisting token is you don't need to go through any authorization flow.
+
+If what you have is a JSON string instead of a Ruby object, you need to convert it first: `JSON.parse(your_token_string)`.
+
+If you only have a string for the access token instead of for the whole object, you can set it like this:
+
+```ruby
+rc.token = { access_token: 'the token string' }
+```
+
+
 ### Send SMS
 
 ```ruby
 r = rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
-    to: [{phoneNumber: ENV['receiver']}],
-    from: {phoneNumber: ENV['username']},
+    to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
+    from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
     text: 'Hello world'
 })
 ```
@@ -54,7 +109,7 @@ r = rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
 
 ```ruby
 rc.post('/restapi/v1.0/account/~/extension/~/fax',
-payload: { to: [{ phoneNumber: ENV['receiver'] }] },
+payload: { to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }] },
     files: [
         ['spec/test.txt', 'text/plain'],
         ['spec/test.png', 'image/png']
@@ -68,8 +123,8 @@ payload: { to: [{ phoneNumber: ENV['receiver'] }] },
 ```ruby
 r = rc.post('/restapi/v1.0/account/~/extension/~/sms',
     payload: {
-        to: [{ phoneNumber: ENV['receiver'] }],
-        from: { phoneNumber: ENV['username'] },
+        to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }],
+        from: { phoneNumber: ENV['RINGCENTRAL_USERNAME'] },
         text: 'hello world'
     },
     files: [
@@ -104,20 +159,25 @@ For more sample code, please refer to the [test cases](/spec).
 
 ## How to test
 
+```
+bundle install --path vendor/bundle
+```
+
 Create `.env` file with the following content:
 
 ```
-production=false
-server=https://platform.devtest.ringcentral.com
-clientId=clientId
-clientSecret=clientSecret
-username=username
-extension=extension
-password=password
-receiver=number-to-receiver-sms
+RINGCENTRAL_SERVER_URL=https://platform.devtest.ringcentral.com
+RINGCENTRAL_CLIENT_ID=
+RINGCENTRAL_CLIENT_SECRET=
+RINGCENTRAL_USERNAME=
+RINGCENTRAL_EXTENSION=
+RINGCENTRAL_PASSWORD=
+RINGCENTRAL_RECEIVER=
 ```
 
-Run `rspec`
+`RINGCENTRAL_RECEIVER` is a phone number to receive SMS, Fax..etc.
+
+Run `bundle exec rspec`
 
 
 ## License

data/lib/ringcentral.rb

@@ -3,6 +3,7 @@ require 'addressable/uri'
 require 'json'
 require 'concurrent'
 require 'faraday'
+require 'faraday_middleware'
 require 'tmpdir'
 
 class RingCentral
@@ -14,19 +15,20 @@ class RingCentral
     'https://platform.ringcentral.com'
   end
 
-  attr_reader :app_key, :app_secret, :server, :token
+  attr_reader :client_id, :client_secret, :server, :token
   attr_accessor :auto_refresh
 
-  def initialize(app_key, app_secret, server)
-    @app_key = app_key
-    @app_secret = app_secret
+  def initialize(client_id, client_secret, server)
+    @client_id = client_id
+    @client_secret = client_secret
     @server = server
     @auto_refresh = false
     @token = nil
     @timer = nil
-    @faraday = Faraday.new(url: server) do |faraday|
+    @faraday = Faraday.new(url: server, request: { params_encoder: Faraday::FlatParamsEncoder }) do |faraday|
       faraday.request :multipart
       faraday.request :url_encoded
+      faraday.response :json, content_type: /\bjson$/
       faraday.adapter Faraday.default_adapter
     end
   end
@@ -43,13 +45,21 @@ class RingCentral
     end
   end
 
-  def authorize(username: nil, extension: nil, password: nil, auth_code: nil, redirect_uri: nil)
+  def authorize(username: nil, extension: nil, password: nil, auth_code: nil, redirect_uri: nil, jwt: nil, verifier: nil)
     if auth_code != nil
       payload = {
         grant_type: 'authorization_code',
         code: auth_code,
         redirect_uri: redirect_uri,
       }
+      if verifier != nil
+        payload["code_verifier"] = verifier
+      end
+    elsif jwt != nil
+      payload = {
+        grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',
+        assertion: jwt
+      }
     else
       payload = {
         grant_type: 'password',
@@ -60,7 +70,7 @@ class RingCentral
     end
     self.token = nil
     r = self.post('/restapi/oauth/token', payload: payload)
-    self.token = JSON.parse(r.body)
+    self.token = r.body
   end
 
   def refresh
@@ -71,7 +81,7 @@ class RingCentral
     }
     self.token = nil
     r = self.post('/restapi/oauth/token', payload: payload)
-    self.token = JSON.parse(r.body)
+    self.token = r.body
   end
 
   def revoke
@@ -81,14 +91,18 @@ class RingCentral
     self.post('/restapi/oauth/revoke', payload: payload)
   end
 
-  def authorize_uri(redirect_uri, state = '')
+  def authorize_uri(redirect_uri, state = '', challenge = nil, challenge_method = 'S256')
     uri = Addressable::URI.parse(@server) + '/restapi/oauth/authorize'
     uri.query_values = {
       response_type: 'code',
       state: state,
       redirect_uri: redirect_uri,
-      client_id: @app_key
+      client_id: @client_id
     }
+    if challenge != nil
+      uri.query_values["code_challenge"] = challenge
+      uri.query_values["code_challenge_method"] = challenge_method
+    end
     uri.to_s
   end
 
@@ -150,7 +164,7 @@ class RingCentral
   private
 
     def basic_key
-      Base64.encode64("#{@app_key}:#{@app_secret}").gsub(/\s/, '')
+      Base64.encode64("#{@client_id}:#{@client_secret}").gsub(/\s/, '')
     end
 
     def autorization_header

data/lib/subscription.rb

@@ -2,6 +2,7 @@ require 'pubnub'
 require 'concurrent'
 require 'openssl'
 require 'base64'
+require 'securerandom'
 
 class PubNub
   attr_accessor :events
@@ -47,8 +48,8 @@ class PubNub
 
   def subscribe
     r = @rc.post('/restapi/v1.0/subscription', payload: request_body)
-    self.subscription = JSON.parse(r.body)
-    @pubnub = Pubnub.new(subscribe_key: @subscription['deliveryMode']['subscriberKey'])
+    self.subscription = r.body
+    @pubnub = Pubnub.new(subscribe_key: @subscription['deliveryMode']['subscriberKey'], uuid: SecureRandom.uuid)
     @pubnub.add_listener(name: 'default', callback: @callback)
     @pubnub.subscribe(channels: @subscription['deliveryMode']['address'])
   end
@@ -56,7 +57,7 @@ class PubNub
   def refresh
     return if @subscription == nil
     r = @rc.put("/restapi/v1.0/subscription/#{@subscription['id']}", payload: request_body)
-    self.subscription = JSON.parse(r.body)
+    self.subscription = r.body
   end
 
   def revoke

data/ringcentral-sdk.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name          = 'ringcentral-sdk'
-  gem.version       = '0.8.2'
+  gem.version       = '0.9.6'
   gem.authors       = ['Tyler Liu']
   gem.email         = ['tyler.liu@ringcentral.com']
   gem.description   = 'Ruby SDK for you to access RingCentral platform API.'
@@ -13,8 +13,9 @@ Gem::Specification.new do |gem|
   gem.files        += Dir['lib/**/*.rb']
   gem.test_files    = Dir['spec/**/*.rb']
 
-  gem.add_dependency('addressable', '~> 2.5', '>= 2.5.2')
-  gem.add_dependency('concurrent-ruby', '~> 1.0', '>= 1.0.2')
-  gem.add_dependency('pubnub', '~> 4.0', '>= 4.0.27')
-  gem.add_dependency('faraday', '~> 0.10', '>= 0.10.0')
+  gem.add_dependency('addressable', '~> 2.8', '>= 2.8.0')
+  gem.add_dependency('concurrent-ruby', '~> 1.1', '>= 1.1.9')
+  gem.add_dependency('pubnub', '~> 5.0', '>= 5.0.0')
+  gem.add_dependency('faraday', '~> 2.1', '>= 2.1.0')
+  gem.add_dependency('faraday_middleware', '~> 1.2.0', '>= 1.2.0')
 end

data/spec/fax_spec.rb

@@ -5,17 +5,17 @@ RSpec.describe 'Fax' do
   describe 'send fax' do
     it 'should send a fax' do
       Dotenv.load
-      rc = RingCentral.new(ENV['clientId'], ENV['clientSecret'], ENV['server'])
-      rc.authorize(username: ENV['username'], extension: ENV['extension'], password: ENV['password'])
+      rc = RingCentral.new(ENV['RINGCENTRAL_CLIENT_ID'], ENV['RINGCENTRAL_CLIENT_SECRET'], ENV['RINGCENTRAL_SERVER_URL'])
+      rc.authorize(username: ENV['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
       r = rc.post('/restapi/v1.0/account/~/extension/~/fax',
-        payload: { to: [{ phoneNumber: ENV['receiver'] }] },
+        payload: { to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }] },
         files: [
           ['spec/test.txt', 'text/plain'],
           ['spec/test.png', 'image/png']
         ]
       )
       expect(r).not_to be_nil
-      message = JSON.parse(r.body)
+      message = r.body
       expect('Fax').to eq(message['type'])
     end
   end

data/spec/mms_spec.rb

@@ -5,13 +5,13 @@ RSpec.describe 'MMS' do
   describe 'send MMS' do
     it 'should send an MMS' do
       Dotenv.load
-      rc = RingCentral.new(ENV['clientId'], ENV['clientSecret'], ENV['server'])
-      rc.authorize(username: ENV['username'], extension: ENV['extension'], password: ENV['password'])
+      rc = RingCentral.new(ENV['RINGCENTRAL_CLIENT_ID'], ENV['RINGCENTRAL_CLIENT_SECRET'], ENV['RINGCENTRAL_SERVER_URL'])
+      rc.authorize(username: ENV['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
 
       r = rc.post('/restapi/v1.0/account/~/extension/~/sms',
         payload: {
-          to: [{ phoneNumber: ENV['receiver'] }],
-          from: { phoneNumber: ENV['username'] },
+          to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }],
+          from: { phoneNumber: ENV['RINGCENTRAL_USERNAME'] },
           text: 'hello world'
         },
         files: [
@@ -19,7 +19,7 @@ RSpec.describe 'MMS' do
         ]
       )
       expect(r).not_to be_nil
-      message = JSON.parse(r.body)
+      message = r.body
       expect('SMS').to eq(message['type'])
     end
   end

data/spec/query_params_spec.rb

@@ -0,0 +1,22 @@
+require 'dotenv'
+require 'ringcentral'
+
+RSpec.describe 'query params' do
+  describe 'single' do
+    it 'contain single query param' do
+      Dotenv.load
+      rc = RingCentral.new(ENV['RINGCENTRAL_CLIENT_ID'], ENV['RINGCENTRAL_CLIENT_SECRET'], ENV['RINGCENTRAL_SERVER_URL'])
+      rc.authorize(username: ENV['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
+      r = rc.get('/restapi/v1.0/account/~/extension/~/address-book/contact', { phoneNumber: '666' })
+      expect(r).not_to be_nil
+      message = r.body
+      expect(message['uri']).to include('phoneNumber=666')
+
+      r = rc.get('/restapi/v1.0/account/~/extension/~/address-book/contact', { phoneNumber: ['666', '888'] })
+      expect(r).not_to be_nil
+      message = r.body
+      expect(message['uri']).to include('phoneNumber=666&phoneNumber=888')
+      rc.revoke()
+    end
+  end
+end

data/spec/ringcentral_spec.rb

@@ -8,25 +8,25 @@ RSpec.describe 'RingCentral' do
     end
 
     it 'test_initializer' do
-      rc = RingCentral.new('app_key', 'app_secret', RingCentral.SANDBOX_SERVER)
-      expect('app_key').to eq(rc.app_key)
-      expect('app_secret').to eq(rc.app_secret)
+      rc = RingCentral.new('client_id', 'client_secret', RingCentral.SANDBOX_SERVER)
+      expect('client_id').to eq(rc.client_id)
+      expect('client_secret').to eq(rc.client_secret)
       expect('https://platform.devtest.ringcentral.com').to eq(rc.server)
       expect(false).to eq(rc.auto_refresh)
     end
 
     it 'test_authorize_uri' do
-      rc = RingCentral.new('app_key', 'app_secret', RingCentral.SANDBOX_SERVER)
-      expect(RingCentral.SANDBOX_SERVER + '/restapi/oauth/authorize?client_id=app_key&redirect_uri=https%3A%2F%2Fexample.com&response_type=code&state=mystate').to eq(rc.authorize_uri('https://example.com', 'mystate'))
+      rc = RingCentral.new('client_id', 'client_secret', RingCentral.SANDBOX_SERVER)
+      expect(RingCentral.SANDBOX_SERVER + '/restapi/oauth/authorize?client_id=client_id&redirect_uri=https%3A%2F%2Fexample.com&response_type=code&state=mystate').to eq(rc.authorize_uri('https://example.com', 'mystate'))
     end
 
     it 'test_password_flow' do
       Dotenv.load
-      rc = RingCentral.new(ENV['clientId'], ENV['clientSecret'], ENV['server'])
+      rc = RingCentral.new(ENV['RINGCENTRAL_CLIENT_ID'], ENV['RINGCENTRAL_CLIENT_SECRET'], ENV['RINGCENTRAL_SERVER_URL'])
       expect(rc.token).to be_nil
 
       # create token
-      rc.authorize(username: ENV['username'], extension: ENV['extension'], password: ENV['password'])
+      rc.authorize(username: ENV['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
       expect(rc.token).not_to be_nil
 
       # refresh token
@@ -40,33 +40,33 @@ RSpec.describe 'RingCentral' do
 
     it 'test_http_methods' do
       Dotenv.load
-      rc = RingCentral.new(ENV['clientId'], ENV['clientSecret'], ENV['server'])
-      rc.authorize(username: ENV['username'], extension: ENV['extension'], password: ENV['password'])
+      rc = RingCentral.new(ENV['RINGCENTRAL_CLIENT_ID'], ENV['RINGCENTRAL_CLIENT_SECRET'], ENV['RINGCENTRAL_SERVER_URL'])
+      rc.authorize(username: ENV['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
 
       # get
       r = rc.get('/restapi/v1.0/account/~/extension/~')
       expect(r).not_to be_nil
-      expect('101').to eq(JSON.parse(r.body)['extensionNumber'])
+      expect('101').to eq(r.body['extensionNumber'])
 
       # post
       r = rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
-        to: [{phoneNumber: ENV['receiver']}],
-        from: {phoneNumber: ENV['username']},
+        to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
+        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
         text: 'Hello world'
       })
       expect(r).not_to be_nil
-      message = JSON.parse(r.body)
+      message = r.body
       expect('SMS').to eq(message['type'])
       messageUrl = "/restapi/v1.0/account/~/extension/~/message-store/#{message['id']}"
 
       # put
       r = rc.put(messageUrl, payload: { readStatus: 'Unread' })
       expect(r).not_to be_nil
-      message = JSON.parse(r.body)
+      message = r.body
       expect('Unread').to eq(message['readStatus'])
       r = rc.put(messageUrl, payload: { readStatus: 'Read' })
       expect(r).not_to be_nil
-      message = JSON.parse(r.body)
+      message = r.body
       expect('Read').to eq(message['readStatus'])
 
       # todo: test patch
@@ -76,7 +76,7 @@ RSpec.describe 'RingCentral' do
       expect(r).not_to be_nil
       r = rc.get(messageUrl)
       expect(r).not_to be_nil
-      message = JSON.parse(r.body)
+      message = r.body
       expect('Deleted').to eq(message['availability'])
     end
   end

data/spec/subscription_spec.rb

@@ -4,8 +4,8 @@ require 'dotenv'
 require 'rspec'
 
 Dotenv.load
-$rc = RingCentral.new(ENV['clientId'], ENV['clientSecret'], ENV['server'])
-$rc.authorize(username: ENV['username'], extension: ENV['extension'], password: ENV['password'])
+$rc = RingCentral.new(ENV['RINGCENTRAL_CLIENT_ID'], ENV['RINGCENTRAL_CLIENT_SECRET'], ENV['RINGCENTRAL_SERVER_URL'])
+$rc.authorize(username: ENV['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
 
 def createSubscription(callback)
   events = [
@@ -27,8 +27,8 @@ RSpec.describe 'Subscription' do
       })
 
       $rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
-        to: [{phoneNumber: ENV['receiver']}],
-        from: {phoneNumber: ENV['username']},
+        to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
+        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
         text: 'Hello world'
       })
       sleep(20)
@@ -45,8 +45,8 @@ RSpec.describe 'Subscription' do
       subscription.refresh()
 
       $rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
-        to: [{phoneNumber: ENV['receiver']}],
-        from: {phoneNumber: ENV['username']},
+        to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
+        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
         text: 'Hello world'
       })
       sleep(20)
@@ -63,8 +63,8 @@ RSpec.describe 'Subscription' do
       subscription.revoke()
 
       $rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
-        to: [{phoneNumber: ENV['receiver']}],
-        from: {phoneNumber: ENV['username']},
+        to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
+        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
         text: 'Hello world'
       })
       sleep(20)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ringcentral-sdk
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.6
 platform: ruby
 authors:
 - Tyler Liu
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-03-16 00:00:00.000000000 Z
+date: 2022-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -16,80 +16,100 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '2.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.5.2
+        version: 2.8.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '2.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.5.2
+        version: 2.8.0
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.1.9
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.1.9
 - !ruby/object:Gem::Dependency
   name: pubnub
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.27
+        version: 5.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '5.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.27
+        version: 5.0.0
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '2.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 2.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '2.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.10.0
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
 description: Ruby SDK for you to access RingCentral platform API.
 email:
 - tyler.liu@ringcentral.com
@@ -103,6 +123,7 @@ files:
 - ringcentral-sdk.gemspec
 - spec/fax_spec.rb
 - spec/mms_spec.rb
+- spec/query_params_spec.rb
 - spec/ringcentral_spec.rb
 - spec/spec_helper.rb
 - spec/subscription_spec.rb
@@ -110,7 +131,7 @@ homepage: https://github.com/ringcentral/ringcentral-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -125,14 +146,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: RingCentral Ruby SDK.
 test_files:
-- spec/spec_helper.rb
-- spec/ringcentral_spec.rb
-- spec/mms_spec.rb
 - spec/fax_spec.rb
+- spec/mms_spec.rb
+- spec/query_params_spec.rb
+- spec/ringcentral_spec.rb
+- spec/spec_helper.rb
 - spec/subscription_spec.rb