clicksign-api 1.1.0.alpha5 → 1.1.2.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 838efe4044fec37ce55e6a4b18a9c2a2afb69eba26bef730f33ff7b7cd305671
-  data.tar.gz: '094afed7fb78afd56753d16235363668fee91330242d342a0d503a93346cf58f'
+  metadata.gz: a5a70bb08f88deb5af74e43399f3f3176262d66a008757d5a9685d2821c9cb7c
+  data.tar.gz: 4ebd3827259a3cf829168f61589f7f73960fb8b87efd3264750f93b84b5e5738
 SHA512:
-  metadata.gz: 25c60f502a51735dea50a60c9f41270a2af592a54fd2eab3f7a1df5974b69bd608dd569e19d32e560b39f1526e71e52bb1173c5b4f6a3e68cddce704b2d86f9a
-  data.tar.gz: c88cb03ad8887973c12b5255c5c878542cf04ca43499473aef6c1e86b9352510121295b47ba316d96a2b57a4dcf07f8b2d6e489889ce330eb40d57606c8402a7
+  metadata.gz: 6adeb414c6e3f9a9dbcb85e25c75c642e9e4e00e04be7e243332b60ae2ad71316b12a30da6e66a1e3a350feb1cfa4f25f3511cb4704fbb5b057a3352068c2a6f
+  data.tar.gz: 388b2eef8ff721f0f7a961c3136f9481478e3612076a7e800525fbe7afb0e83d855fa1f7d09145871ae715a83e7b3b8f3a6ba7811558b30553d4471f9fe369cc

data/CHANGELOG.md

@@ -13,13 +13,13 @@ Now all requests receive token parameter, that represents the key associated wit
 ## Examples:
 
 YML file
-```ruby
-=> key.production: ENV['CLICKSIGN_ACCESS_TOKEN_PRODUCTION']
-=> key.sandbox:    ENV['CLICKSIGN_ACCESS_TOKEN_SANDBOX']
+```yml
+key.production: 'CLICKSIGN_ACCESS_TOKEN_PRODUCTION'
+key.sandbox:    'CLICKSIGN_ACCESS_TOKEN_SANDBOX'
 ```
 
 Request:
 ```ruby
-=> file = File.open('/path/to/file/local/file.pdf', 'r')
-=> response = Clicksign::API::Document.create( params: { path: '/path/to/file/on/clicksign.pdf', file: file }, token: 'key.production')
+file = File.open('/path/to/file/local/file.pdf', 'r')
+response = Clicksign::API::Document.create( params: { path: '/path/to/file/on/clicksign.pdf', file: file }, token: 'key.production')
 ```

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    clicksign-api (1.1.0.alpha5)
+    clicksign-api (1.1.2.alpha)
       faraday
 
 GEM

data/README.md

@@ -54,101 +54,62 @@ To see all available parameters, please, check the [API docs](https://developers
 
 ```ruby
 file = File.open('/path/to/file/local/file.pdf', 'r')
-document = Clicksign::API::Document.create( params: { path: '/path/to/file/on/clicksign.pdf', file: file }, token: 'valid_token')
-=> #<Faraday::Response ...>
+document = Clicksign::API::Document.create( params: { path: '/path/to/file/on/clicksign.pdf', file: file }, token: "key.sandbox")
+# => {"document"=> {"key"=>"00000000-0000-0000-0000-000000000000"}
 
-document.success?
-=> true # false
-
-response_document = JSON.parse(document.body)
-=> {:document=> {:key=> '...', :path=> '...', :status => '...', ... }
-=> # key: '123abcd' as example!
 ```
 
 #### View documents
 
 ```ruby
-find_document = Clicksign::API::Document.find(params: { key: response_document['document']['key'] }, token: 'valid_token')
-=> #<Faraday::Response ...>
-
-find_document.success?
-=> true # false
+find_document = Clicksign::API::Document.find(params: { key: response_document['document']['key'] }, token: "key.sandbox")
+# => {"document"=> {"key"=>"00000000-0000-0000-0000-000000000000"}
 
-JSON.parse(find_document.body)
-=> {:document=> {:key=> '...', :path=> '...', :status => '...', ... }
 ```
 
 #### Create Signers
 
 ```ruby
-signer = Clicksign::API::Signer.create(params: { email: 'mail@email.com', auths: ['email'], delivery: 'email' }, token: 'valid_token')
-=> #<Faraday::Response ...>
+signer = Clicksign::API::Signer.create(params: { email: 'mail@email.com', auths: ['email'], delivery: 'email' }, token: "key.sandbox")
+# => {"signer"=> {"key"=>"00000000-0000-0000-0000-000000000000"}
 
-signer.success?
-=> true # false
-
-response_signer = JSON.parse(signer.body)
-=> {:document=> {:key=> '...', :path=> '...', :status => '...', ... }
-=> # signer_key: '999poo' as example!
 ```
 #### Add Signers to Document
 
 ```ruby
+signer_document = Clicksign::API::DocumentsSigners.create(params: { document_key: response_document['document']['key'], signer_key: response_signer['key'], sign_as: 'sign_as' }, token: "key.sandbox")
+# => {"list"=>{"key"=>"00000000-0000-0000-0000-000000000000"}
 
-signer_document = Clicksign::API::DocumentsSigners.create(params: { document_key: response_document['document']['key'], signer_key: response_signer['key'], sign_as: 'sign_as' }, token: 'valid_token')
-=> #<Faraday::Response ...>
-
-signer_document.success?
-=> true # false
-
-response_signer_document = JSON.parse(signer_document.body)
-=> {:document=> {:key=> '...', :path=> '...', :status => '...', ... }
   ```
 
 ##### Creating Documents in Batches
 
 ```ruby
+batch = Clicksign::API::Batch.create(
+  params: {
+    document_keys: [response_document['document']['key'], 'other_document_key'],
+    signer_key: response_signer['key'],
+    summary: true
+  },
+  token: "key.sandbox"
+)
 
-batch = Clicksign::API::Batch.create(params: { document_keys: [response_document['document']['key'], 'other_document_key'], signer_key: response_signer['key'], summary: true}, token: 'valid_token')
-=> #<Faraday::Response ...>
-
-batch.success?
-=> true # false
-
-rseponse_batch = JSON.parse(batch.body)
-=> #{"batch"=> {"key"=>"3dd7fa89-15f7-48b6-81e8-7d14a273bbb8"
+# => {"batch"=>{"key"=>"00000000-0000-0000-0000-000000000000"}
 
 ```
 #### Notifying Signer by e-mail
 
 ```ruby
-request_signature_key = JSON.parse(response_document_above.body)['document']['signers'].first['request_signature_key']
-notify = Clicksign::API::Notifier.notify(params: { request_signature_key: request_signature_key }, token: 'valid_token')
-=> #<Faraday::Response ...>
-
-notify.success?
-=> true # false
-
-JSON.parse(notify.body)
-=> ##<struct Faraday::Env, method=:post request_body="{\"request_signature_key\":
+notify = Clicksign::API::Notifier.notify(params: { request_signature_key: 'request_signature_key' }, token: "key.sandbox")
+# => {:status=>202} 
 
 ```
 
 #### Notifying Signer by whatsapp
 
 ```ruby
-=> # To deliver this content, its necessary add `phone_number` on Signer
-
-request_signature_key = JSON.parse(response_document_above.body)['document']['signers'].first['request_signature_key']
-notify = Clicksign::API::Notifier.notify(params: { request_signature_key: request_signature_key }, token: 'valid_token')
-=> #<Faraday::Response ...>
-
-notify.success?
-=> true # false
-
-JSON.parse(notify.body)
-=> ##<struct Faraday::Env, method=:post request_body="{\"request_signature_key\":
-
+notify = Clicksign::API::Notifier.notify(params: { request_signature_key: 'request_signature_key' }, token: "key.sandbox")
+# => {:status=>202} 
 
 ## Development
 

data/lib/clicksign/api/document.rb

@@ -12,6 +12,7 @@ module Clicksign
         end
 
         def find(token:, params:)
+          params = params.transform_keys(&:to_sym)
           get(REQUEST_PATH + params[:key], token)
         end
 

data/lib/clicksign/api/documents_signers.rb

@@ -17,15 +17,13 @@ module Clicksign
           )
         end
 
-        def batch_create(token:, batch:)
-          batch.map do |params|
-            create(token: token, params: params)
+        def batch_create(token:, params:)
+          params[:batch].map do |single_params|
+            create(token: token, params: single_params)
           end
         end
 
         def body(params)
-          params = params.transform_keys(&:to_sym)
-
           list = ATTRIBUTES.each.with_object({}) do |key, hash|
             hash[key] = params[key] if params.has_key?(key)
           end

data/lib/clicksign/api/requests.rb

@@ -2,23 +2,37 @@ module Clicksign
   module API
     module Requests
       def post(request_path, body, token)
-        conn.post do |req|
+        response = conn.post do |req|
           req.url request_path, { access_token: Clicksign::API.credentials[token] }
           req.headers['Content-Type'] = 'application/json'
           req.body = body.to_json
         end
+        
+        parse(response)
       end
 
       def get(request_path, token)
-        conn.get do |req|
+        response = conn.get do |req|
           req.url request_path, { access_token: Clicksign::API.credentials[token] }
           req.headers['Content-Type'] = 'application/json'
         end
+        
+        parse(response)
       end
+      
+      private
 
       def conn
         @conn ||= Faraday.new(url: Clicksign::API.url)
       end
+      
+      def parse(response)
+        if !response.body.empty?
+          JSON.parse(response.body, symbolize_keys: true).merge(status: response.status)
+        else
+          { status: response.status }
+        end
+      end
     end
   end
-end
+end

data/lib/clicksign/api/signer.rb

@@ -25,7 +25,7 @@ module Clicksign
             hash[key] = params[key] if params.has_key?(key)
           end
 
-          body = { signer: signer }.to_json
+          body = { signer: signer }
         end
       end
     end

data/lib/clicksign/api/version.rb

@@ -1,5 +1,5 @@
 module Clicksign
   module API
-    VERSION = "1.1.0.alpha5"
+    VERSION = "1.1.2.alpha"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: clicksign-api
 version: !ruby/object:Gem::Version
-  version: 1.1.0.alpha5
+  version: 1.1.2.alpha
 platform: ruby
 authors:
 - Francisco Martins
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-11-03 00:00:00.000000000 Z
+date: 2021-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -198,7 +198,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: Clicksign API ruby interface