Switch to authorization header (#33)

Co-authored-by: Laurynas Butkus <[email protected]>

Author: laurynas-convertapi

.github/workflows/main.yml

@@ -24,5 +24,4 @@ jobs:
       - run: bundle install
       - env:
           CONVERT_API_SECRET: ${{ secrets.CONVERTAPI_SECRET }}
-          CONVERT_API_TOKEN: ${{ secrets.CONVERTAPI_TOKEN }}
         run: bundle exec rake spec

README.md

@@ -23,20 +23,11 @@ gem 'convert_api'
 
 ### Configuration
 
-You can get your secret at https://www.convertapi.com/a/auth
+You can get your credentials at https://www.convertapi.com/a/auth
 
 ```ruby
 ConvertApi.configure do |config|
-  config.api_secret = 'your-api-secret'
-end
-```
-
-Or
-
-You can get your token at https://www.convertapi.com/a/access-tokens
-```ruby
-ConvertApi.configure do |config|
-  config.token = 'your-token'
+  config.api_credentials = 'your-api-secret-or-token'
 end
 ```
 
@@ -136,10 +127,6 @@ Find more advanced examples in the [examples/](https://github.com/ConvertAPI/con
 
 Run `CONVERT_API_SECRET=your_secret rake spec` to run the tests.
 
-Or
-
-Run `CONVERT_API_TOKEN=your_token rake spec` to run the tests.
-
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing

examples/conversions_chaining.rb

@@ -2,9 +2,7 @@
 require 'tmpdir'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
 
 # Short example of conversions chaining, the PDF pages extracted and saved as separated JPGs and then ZIP'ed

examples/convert_stream.rb

@@ -2,9 +2,7 @@
 require 'tmpdir'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
 
 # Example of converting text to PDF

examples/convert_url_to_pdf.rb

@@ -2,10 +2,9 @@
 require 'tmpdir'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
+
 # Example of converting Web Page URL to PDF file
 # https://www.convertapi.com/web-to-pdf
 

examples/convert_word_to_pdf_and_png.rb

@@ -2,9 +2,7 @@
 require 'tmpdir'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
 
 # Example of saving Word docx to PDF and to PNG

examples/create_pdf_thumbnail.rb

@@ -2,9 +2,7 @@
 require 'tmpdir'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
 
 # Example of extracting first page from PDF and then chaining conversion PDF page to JPG.

examples/retrieve_user_information.rb

@@ -1,9 +1,7 @@
 require 'convert_api'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
 
 # Retrieve user information

examples/split_and_merge_pdf.rb

@@ -2,9 +2,7 @@
 require 'tmpdir'
 
 ConvertApi.configure do |config|
-  config.api_secret = ENV['CONVERT_API_SECRET'] # your api secret
-  # or
-  config.token = ENV['CONVERT_API_TOKEN'] # your token
+  config.api_credentials = ENV['CONVERT_API_SECRET'] # your api secret or token
 end
 
 # Example of extracting first and last pages from PDF and then merging them back to new PDF.

lib/convert_api/client.rb

@@ -30,15 +30,15 @@ class Client
 
     def get(path, params = {}, options = {})
       handle_response do
-        request = Net::HTTP::Get.new(request_uri(path, params), DEFAULT_HEADERS)
+        request = Net::HTTP::Get.new(request_uri(path, params), headers_with_auth)
 
         http(options).request(request)
       end
     end
 
     def post(path, params, options = {})
       handle_response do
-        request = Net::HTTP::Post.new(request_uri(path), DEFAULT_HEADERS)
+        request = Net::HTTP::Post.new(request_uri(path), headers_with_auth)
         request.form_data = build_form_data(params)
 
         http(options).request(request)
@@ -101,12 +101,7 @@ def http(options = {})
     end
 
     def request_uri(path, params = {})
-      raise(AuthenticationError, 'API secret or Token not configured') if authentication.nil?
-
-      params_with_authentication = params.merge(authentication)
-      query = URI.encode_www_form(params_with_authentication)
-
-      base_uri.path + path + '?' + query
+      base_uri.path + path + '?' + URI.encode_www_form(params)
     end
 
     def build_form_data(params)
@@ -123,11 +118,16 @@ def build_form_data(params)
       data
     end
 
-    def authentication
-      return { Secret: config.api_secret } unless config.api_secret.nil?
-      return { Token: config.token } unless config.token.nil?
+    def headers_with_auth
+      DEFAULT_HEADERS.merge(auth_headers)
+    end
+
+    def auth_headers
+      { 'Authorization' => "Bearer #{api_credentials}" }
+    end
 
-      nil
+    def api_credentials
+      config.api_credentials || raise(AuthenticationError, 'API credentials not configured')
     end
 
     def base_uri