ringcentral-sdk 0.9.8 → 0.9.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c148f211fd760e709cb7ecc99c2b5eec62d79095c2a9bde9e48338009709cf1a
-  data.tar.gz: 47605bac114f39ac6b89dd9bf400fc0b7ca3c86c9712dcf25fa92349adab0f60
+  metadata.gz: 0c82aa5b359e0d18f0096e856d81cebb7c00990208cc210a217d49d470ee19eb
+  data.tar.gz: 5a4f3973076393c86fa95ea47aa7b467c0b01abd3c46fcd819a5c976ab625717
 SHA512:
-  metadata.gz: 524b9224e4e4ebcf599fb4718eeca1bdc440842d91905edc3d306257503f06169ead91ef1f2dec0d51188a6f88053cc686546c14c152daed85baaea8c23ec19b
-  data.tar.gz: 8a2e4a803706cf366009f8ad7aa83914cccd9bf0b79b779d5b92213b26c9cf2413a0a96285086dfdf9f2e1412a7634d9880573f59223a8a4c57dd81c3a47e4d6
+  metadata.gz: 1cd78622b101fbf1ef52b717af4ea587fdf98517613d9de858f432c3954e89c4c8393a16f67a43bfa29fe938d2711970200133ad9fc7362307b214d0a807f094
+  data.tar.gz: 9a98212a1550ee2cd269d8b935fb25115f31f9ece0609498e6a5fa2efd701107da6e3ed58a48fb266e118934e85b8ded88860529f93c13142ea2d87cb315e94b

data/README.md

@@ -41,7 +41,7 @@ https://developer.ringcentral.com/api-docs/latest/index.html
 require 'ringcentral'
 
 rc = RingCentral.new('clientID', 'clientSecret', 'serverURL')
-rc.authorize(username: 'username', extension: 'extension', password: 'password')
+rc.authorize(jwt: 'jwt-token')
 
 # get
 r = rc.get('/restapi/v1.0/account/~/extension/~')
@@ -98,7 +98,7 @@ rc.token = { access_token: 'the token string' }
 ```ruby
 r = rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
     to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
-    from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
+    from: {phoneNumber: ENV['RINGCENTRAL_SENDER']},
     text: 'Hello world'
 })
 ```
@@ -123,7 +123,7 @@ payload: { to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }] },
 r = rc.post('/restapi/v1.0/account/~/extension/~/sms',
     payload: {
         to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }],
-        from: { phoneNumber: ENV['RINGCENTRAL_USERNAME'] },
+        from: { phoneNumber: ENV['RINGCENTRAL_SENDER'] },
         text: 'hello world'
     },
     files: [
@@ -162,17 +162,9 @@ For more sample codes, please refer to the [test cases](/spec).
 bundle install --path vendor/bundle
 ```
 
-Create `.env` file with the following content:
+Rename `.env.sample` to `.env`.
 
-```
-RINGCENTRAL_SERVER_URL=https://platform.devtest.ringcentral.com
-RINGCENTRAL_CLIENT_ID=
-RINGCENTRAL_CLIENT_SECRET=
-RINGCENTRAL_USERNAME=
-RINGCENTRAL_EXTENSION=
-RINGCENTRAL_PASSWORD=
-RINGCENTRAL_RECEIVER=
-```
+Edit `.env` file to specify credentials.
 
 `RINGCENTRAL_RECEIVER` is a phone number to receive SMS, Fax..etc.
 

data/lib/ringcentral.rb

@@ -16,13 +16,14 @@ class RingCentral
   end
 
   attr_reader :client_id, :client_secret, :server, :token
-  attr_accessor :auto_refresh
+  attr_accessor :auto_refresh, :debug_mode
 
-  def initialize(client_id, client_secret, server)
+  def initialize(client_id, client_secret, server, debug_mode = false)
     @client_id = client_id
     @client_secret = client_secret
     @server = server
     @auto_refresh = false
+    @debug_mode = debug_mode
     @token = nil
     @timer = nil
     @faraday = Faraday.new(url: server, request: { params_encoder: Faraday::FlatParamsEncoder }) do |faraday|
@@ -91,31 +92,36 @@ class RingCentral
     self.post('/restapi/oauth/revoke', payload: payload)
   end
 
-  def authorize_uri(redirect_uri, state = '', challenge = nil, challenge_method = 'S256')
+  def authorize_uri(redirect_uri, hash = {})
+    hash[:response_type] = 'code'
+    hash[:redirect_uri] = redirect_uri
+    hash[:client_id] = @client_id
     uri = Addressable::URI.parse(@server) + '/restapi/oauth/authorize'
-    uri.query_values = {
-      response_type: 'code',
-      state: state,
-      redirect_uri: redirect_uri,
-      client_id: @client_id
-    }
-    if challenge != nil
-      uri.query_values["code_challenge"] = challenge
-      uri.query_values["code_challenge_method"] = challenge_method
-    end
+    uri.query_values = hash
     uri.to_s
   end
 
   def get(endpoint, params = {})
-    @faraday.get do |req|
+    r = @faraday.get do |req|
       req.url endpoint
       req.params = params
       req.headers = headers
     end
+    if @debug_mode
+      puts r.status, r.body
+    end
+    if r.status >= 400
+      raise "HTTP status #{r.status}: 
+
+headers: #{r.headers}
+
+body: #{r.body}"
+    end
+    return r
   end
 
   def post(endpoint, payload: nil, params: {}, files: nil)
-    @faraday.post do |req|
+    r = @faraday.post do |req|
       req.url endpoint
       req.params = params
       if files != nil && files.size > 0 # send fax or MMS
@@ -133,32 +139,76 @@ class RingCentral
         req.body = payload
       end
     end
+    if @debug_mode
+      puts r.status, r.body
+    end
+    if r.status >= 400
+      raise "HTTP status #{r.status}: 
+
+headers: #{r.headers}
+
+body: #{r.body}"
+    end
+    return r
   end
 
   def put(endpoint, payload: nil, params: {}, files: nil)
-    @faraday.put do |req|
+    r = @faraday.put do |req|
       req.url endpoint
       req.params = params
       req.headers = headers.merge({ 'Content-Type': 'application/json' })
       req.body = payload.to_json
     end
+    if @debug_mode
+      puts r.status, r.body
+    end
+    if r.status >= 400
+      raise "HTTP status #{r.status}: 
+
+headers: #{r.headers}
+
+body: #{r.body}"
+    end
+    return r
   end
 
   def patch(endpoint, payload: nil, params: {}, files: nil)
-    @faraday.patch do |req|
+    r = @faraday.patch do |req|
       req.url endpoint
       req.params = params
       req.headers = headers.merge({ 'Content-Type': 'application/json' })
       req.body = payload.to_json
     end
+    if @debug_mode
+      puts r.status, r.body
+    end
+    if r.status >= 400
+      raise "HTTP status #{r.status}: 
+
+headers: #{r.headers}
+
+body: #{r.body}"
+    end
+    return r
   end
 
   def delete(endpoint, params = {})
-    @faraday.delete do |req|
+    r = @faraday.delete do |req|
       req.url endpoint
       req.params = params
       req.headers = headers
     end
+    if @debug_mode
+      puts r.status, r.body
+    end
+    if r.status >= 400
+      raise "HTTP status #{r.status}: 
+
+headers: #{r.headers}
+
+body: #{r.body}"
+    end
+    return r
   end
 
   private

data/ringcentral-sdk.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name          = 'ringcentral-sdk'
-  gem.version       = '0.9.8'
+  gem.version       = '0.9.9'
   gem.authors       = ['Tyler Liu']
   gem.email         = ['tyler.liu@ringcentral.com']
   gem.description   = 'Ruby SDK for you to access RingCentral platform API.'

data/spec/fax_spec.rb

@@ -6,7 +6,7 @@ RSpec.describe 'Fax' do
     it 'should send a fax' 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'])
+      rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
       r = rc.post('/restapi/v1.0/account/~/extension/~/fax',
         payload: { to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }] },
         files: [

data/spec/mms_spec.rb

@@ -6,12 +6,12 @@ RSpec.describe 'MMS' do
     it 'should send an MMS' 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'])
+      rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
 
       r = rc.post('/restapi/v1.0/account/~/extension/~/sms',
         payload: {
           to: [{ phoneNumber: ENV['RINGCENTRAL_RECEIVER'] }],
-          from: { phoneNumber: ENV['RINGCENTRAL_USERNAME'] },
+          from: { phoneNumber: ENV['RINGCENTRAL_SENDER'] },
           text: 'hello world'
         },
         files: [

data/spec/query_params_spec.rb

@@ -6,7 +6,7 @@ RSpec.describe 'query params' 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'])
+      rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
       r = rc.get('/restapi/v1.0/account/~/extension/~/address-book/contact', { phoneNumber: '666' })
       expect(r).not_to be_nil
       message = r.body

data/spec/ringcentral_spec.rb

@@ -17,16 +17,16 @@ RSpec.describe 'RingCentral' do
 
     it 'test_authorize_uri' do
       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'))
+      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', {state: 'mystate'}))
     end
 
-    it 'test_password_flow' do
+    it 'test_jwt_flow' do
       Dotenv.load
       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['RINGCENTRAL_USERNAME'], extension: ENV['RINGCENTRAL_EXTENSION'], password: ENV['RINGCENTRAL_PASSWORD'])
+      rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
       expect(rc.token).not_to be_nil
 
       # refresh token
@@ -41,7 +41,7 @@ RSpec.describe 'RingCentral' do
     it 'test_http_methods' 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'])
+      rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
 
       # get
       r = rc.get('/restapi/v1.0/account/~/extension/~')
@@ -51,7 +51,7 @@ RSpec.describe 'RingCentral' do
       # post
       r = rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
         to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
-        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
+        from: {phoneNumber: ENV['RINGCENTRAL_SENDER']},
         text: 'Hello world'
       })
       expect(r).not_to be_nil

data/spec/subscription_spec.rb

@@ -5,7 +5,7 @@ require 'rspec'
 
 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'])
+
 
 def createSubscription(callback)
   events = [
@@ -21,6 +21,7 @@ end
 RSpec.describe 'Subscription' do
   describe 'subscription' do
     it 'receives message notification' do
+      $rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
       count = 0
       createSubscription(lambda { |message|
         count += 1
@@ -28,15 +29,17 @@ RSpec.describe 'Subscription' do
 
       $rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
         to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
-        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
+        from: {phoneNumber: ENV['RINGCENTRAL_SENDER']},
         text: 'Hello world'
       })
       sleep(20)
 
       expect(count).to be > 0
+      $rc.revoke()
     end
 
     it 'refresh' do
+      $rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
       count = 0
       subscription = createSubscription(lambda { |message|
         count += 1
@@ -46,15 +49,17 @@ RSpec.describe 'Subscription' do
 
       $rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
         to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
-        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
+        from: {phoneNumber: ENV['RINGCENTRAL_SENDER']},
         text: 'Hello world'
       })
       sleep(20)
 
       expect(count).to be > 0
+      $rc.revoke()
     end
 
     it 'revoke' do
+      $rc.authorize(jwt: ENV['RINGCENTRAL_JWT_TOKEN'])
       count = 0
       subscription = createSubscription(lambda { |message|
         count += 1
@@ -64,12 +69,13 @@ RSpec.describe 'Subscription' do
 
       $rc.post('/restapi/v1.0/account/~/extension/~/sms', payload: {
         to: [{phoneNumber: ENV['RINGCENTRAL_RECEIVER']}],
-        from: {phoneNumber: ENV['RINGCENTRAL_USERNAME']},
+        from: {phoneNumber: ENV['RINGCENTRAL_SENDER']},
         text: 'Hello world'
       })
       sleep(20)
 
       expect(count).to eq(0)
+      $rc.revoke()
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ringcentral-sdk
 version: !ruby/object:Gem::Version
-  version: 0.9.8
+  version: 0.9.9
 platform: ruby
 authors:
 - Tyler Liu
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-05-03 00:00:00.000000000 Z
+date: 2023-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -145,7 +145,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: RingCentral Ruby SDK.