neverbounce-api 1.0.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: cf9fa5763f319e8fc240af66e7be1809b427ac5e
-  data.tar.gz: d960426232862d34bdd040d444627059fa63217a
+SHA256:
+  metadata.gz: 2f9d774a33fd7d97b58da965a0aaa4479ecd2051121d94b103eb9b79dea2b840
+  data.tar.gz: 9a25032152f3cd29bf9f1a35e59a41f6a7c3f52e56829f2c5449953e925683e2
 SHA512:
-  metadata.gz: 7536bf00e5a1fd3fe82e139be0e361eb2adcc2e9729ec810b4fad6174fc40dac12ed56faa5e7b2a9ba2ebe52578a6269e1b134e83b8c81b497150293441cc019
-  data.tar.gz: 2a30f1057d9e26ea5785f992cc37edd17d560367998085a158ad204d79f4ac9a113f2c1eea17b763ccc0ae718b8e50eb0c30cb406e64933d09988e204f96c70f
+  metadata.gz: a6675271c6f4aec84f635a0b6c0f20207f217e4be96cfc64957feae519f1ad0c6fb5d6d15cd80f63d73a8de842917399bb0230afae444ff0ea4203dcf5396ce0
+  data.tar.gz: 73b51b37c0a7ed257c3b7548cd2b3b771483261a2a9cb61a818e91b3442a378f096c0b229d83f703b064b911e8b8f6a913c3fa4a3bcc436333a3e0e0be136bbc

data/.gitignore

@@ -8,6 +8,7 @@
 /tmp/*
 /vendor/bundle/
 /.yardoc/
+*.gem
 
 # Project-specific.
 /lib/lib_local.rb
@@ -18,4 +19,4 @@
 *.old*
 *.orig
 /*.patch
-*.ref*
+*.ref*

data/.travis.yml

@@ -5,7 +5,11 @@ env:
   global:
     - CC_TEST_REPORTER_ID=9300cb7898e254e78099399acbb2796471fde0e5c1873899273a583d56c9d740
 
+before_install:
+  - gem install bundler
+
 install:
+  - bundle update --bundler
   - bundle install --path ~/bundle
 
 before_script:
@@ -20,8 +24,7 @@ after_script:
   - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT
 
 rvm:
-  - 2.0
-  - 2.1
-  - 2.2
-  - 2.3
   - 2.4
+  - 2.5
+  - 2.6
+  - 2.7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    neverbounce-api (1.0.1)
+    neverbounce-api (1.1.0)
       httparty (~> 0.15)
 
 GEM
@@ -9,30 +9,30 @@ GEM
   specs:
     diff-lcs (1.3)
     docile (1.1.5)
-    httparty (0.15.6)
+    httparty (0.16.2)
       multi_xml (>= 0.5.2)
     json (2.1.0)
     multi_xml (0.6.0)
     redcarpet (3.4.0)
-    rspec (3.6.0)
-      rspec-core (~> 3.6.0)
-      rspec-expectations (~> 3.6.0)
-      rspec-mocks (~> 3.6.0)
-    rspec-core (3.6.0)
-      rspec-support (~> 3.6.0)
-    rspec-expectations (3.6.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.0)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.6.0)
-    rspec-mocks (3.6.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.6.0)
-    rspec-support (3.6.0)
-    simplecov (0.15.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.0)
+    simplecov (0.15.1)
       docile (~> 1.1.0)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
-    yard (0.9.9)
+    yard (0.9.12)
 
 PLATFORMS
   ruby

data/README.md

@@ -48,7 +48,7 @@ To talk to the API, create a `Client` object and call one of its request methods
 For example, let's get account info:
 
 ```ruby
-client = NeverBounce::API::Client.new(api_key: "key123abc")   # Insert YOUR key here.
+client = NeverBounce::API::Client.new(api_key: "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")   # Insert YOUR key here.
 resp = client.account_info
 
 if resp.ok?
@@ -60,6 +60,8 @@ else
 end
 ```
 
+>**The API username and secret key used to authenticate V3 API requests will not work to authenticate V4 API requests.** If you are attempting to authenticate your request with the 8 character username or 12-16 character secret key the request will return an `auth_failure` error. The API key used for the V4 API will look like the following: `secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`. To create new V4 API credentials please go [here](https://app.neverbounce.com/apps/custom-integration/new).
+
 Now, let's check a single e-mail:
 
 ```ruby

data/lib/never_bounce/api/client.rb

@@ -37,7 +37,7 @@ module NeverBounce; module API
     Feature::BasicInitialize.load(self)
     Feature::RequireAttr.load(self)
 
-    attr_writer :api_key
+    attr_writer :api_key, :api_version
 
     # API key.
     # @return [String]
@@ -45,6 +45,12 @@ module NeverBounce; module API
       @api_key or raise AttributeError, "Attribute must be set: api_key"
     end
 
+    # API version.
+    # @return [String]
+    def api_version
+      @api_version
+    end
+
     #--------------------------------------- Misc
 
     # Wrap request in a session, return response.
@@ -67,6 +73,7 @@ module NeverBounce; module API
     def account_info
       response_to(Request::AccountInfo.new({
         api_key: api_key,
+        api_version: api_version,
       }))
     end
 
@@ -83,7 +90,7 @@ module NeverBounce; module API
     # @raise [StandardError]
     # @see Request::JobsCreate
     # @see https://developers.neverbounce.com/v4.0/reference#jobs-create
-    def jobs_create(auto_parse: nil, auto_start: nil, filename: nil, remote_input: nil, run_sample: nil, supplied_input: nil)
+    def jobs_create(auto_parse: false, auto_start: false, filename: nil, remote_input: nil, run_sample: false, supplied_input: nil, historical: nil)
       raise ArgumentError, "`remote_input` and `supplied_input` can't both be given" if remote_input && supplied_input
 
       input_location = if (v = remote_input)
@@ -102,12 +109,14 @@ module NeverBounce; module API
 
       response_to(API::Request::JobsCreate.new({
         api_key: api_key,
+        api_version: api_version,
         auto_parse: auto_parse,
         auto_start: auto_start,
         filename: filename,
         input: input,
         input_location: input_location,
         run_sample: run_sample,
+        historical: historical,
       }))
     end
 
@@ -122,6 +131,7 @@ module NeverBounce; module API
     def jobs_delete(job_id: nil)
       response_to(Request::JobsDelete.new({
         api_key: api_key,
+        api_version: api_version,
         job_id: job_id,
       }))
     end
@@ -137,6 +147,7 @@ module NeverBounce; module API
     def jobs_download(job_id: nil)
       response_to(Request::JobsDownload.new({
         api_key: api_key,
+        api_version: api_version,
         job_id: job_id,
       }))
     end
@@ -153,6 +164,7 @@ module NeverBounce; module API
     def jobs_parse(auto_start: nil, job_id: nil)
       response_to(Request::JobsParse.new({
         api_key: api_key,
+        api_version: api_version,
         auto_start: auto_start,
         job_id: job_id,
       }))
@@ -171,6 +183,7 @@ module NeverBounce; module API
     def jobs_results(job_id: nil, page: 1, per_page: nil)
       response_to(Request::JobsResults.new({
         api_key: api_key,
+        api_version: api_version,
         job_id: job_id,
         page: page,
         per_page: per_page,
@@ -190,6 +203,7 @@ module NeverBounce; module API
     def jobs_search(job_id: nil, page: 1, per_page: nil)
       response_to(Request::JobsSearch.new({
         api_key: api_key,
+        api_version: api_version,
         job_id: job_id,
         page: page,
         per_page: per_page,
@@ -208,6 +222,7 @@ module NeverBounce; module API
     def jobs_start(job_id: nil, run_sample: nil)
       response_to(Request::JobsStart.new({
         api_key: api_key,
+        api_version: api_version,
         job_id: job_id,
         run_sample: run_sample,
       }))
@@ -224,6 +239,7 @@ module NeverBounce; module API
     def jobs_status(job_id: nil)
       response_to(Request::JobsStatus.new({
         api_key: api_key,
+        api_version: api_version,
         job_id: job_id,
       }))
     end
@@ -239,13 +255,15 @@ module NeverBounce; module API
     # @raise [StandardError]
     # @see Request::SingleCheck
     # @see https://developers.neverbounce.com/v4.0/reference#single-check
-    def single_check(address_info: nil, credits_info: nil, email: nil, timeout: nil)
+    def single_check(address_info: nil, credits_info: nil, email: nil, timeout: nil, historical: nil)
       response_to(Request::SingleCheck.new({
         address_info: address_info,
         api_key: api_key,
+        api_version: api_version,
         credits_info: credits_info,
         email: email,
         timeout: timeout,
+        historical: historical,
       }))
     end
 
@@ -263,6 +281,7 @@ module NeverBounce; module API
     def poe_confirm(email: nil, transaction_id: nil, confirmation_token: nil, result: nil)
       response_to(Request::POEConfirm.new({
         api_key: api_key,
+        api_version: api_version,
         email: email,
         transaction_id: transaction_id,
         confirmation_token: confirmation_token,

data/lib/never_bounce/api/request/base.rb

@@ -12,12 +12,18 @@ module NeverBounce; module API; module Request
     # User's API key.
     # @return [String]
     attr_accessor :api_key
-    attr_writer :api_url, :headers, :user_agent
+    attr_writer :api_url, :headers, :user_agent, :api_version
 
-    # Custom API URL. Default is <tt>https://api.neverbounce.com/v4</tt>.
+    # Custom API URL. Default is <tt>https://api.neverbounce.com</tt>.
     # @return [String]
     def api_url
-      @api_url ||= "https://api.neverbounce.com/v4"
+      @api_url ||= "https://api.neverbounce.com"
+    end
+
+    # Custom API URL. Default is <tt>https://api.neverbounce.com</tt>.
+    # @return [String]
+    def api_version
+      @api_version ||= "v4.2"
     end
 
     # @!attribute headers
@@ -57,7 +63,7 @@ module NeverBounce; module API; module Request
       @curl ||= begin
         ar = [
           "--request", self.class.http_method.to_s.upcase,
-          "--url", "#{api_url}/#{self.class.path}",
+          "--url", "#{api_url}/#{api_version}/#{self.class.path}",
         ]
 
         ar += headers.reject { |k,| k == "User-Agent" }.flat_map do |k, v|
@@ -82,7 +88,7 @@ module NeverBounce; module API; module Request
     def to_httparty
       [
         self.class.http_method,   # E.g. `:get`.
-        "#{api_url}/#{self.class.path}",
+        "#{api_url}/#{api_version}/#{self.class.path}",
         {
           body: to_h.to_json,
           headers: headers,

data/lib/never_bounce/api/request/jobs_create.rb

@@ -23,6 +23,22 @@ module NeverBounce; module API; module Request
     # @return [Boolean]
     attr_accessor :run_sample
 
+    # @return [Boolean]
+    attr_accessor :historical
+
+    # @return [Boolean]
+    attr_accessor :allow_manual_review
+
+    # @return [String]
+    attr_accessor :callback_url
+
+    # @return [Hash]
+    attr_accessor :callback_headers
+
+    def leverage_historical
+      defined?(@historical) ? @historical : true
+    end
+
     # @return [Symbol]
     def self.http_method
       :post
@@ -53,6 +69,22 @@ module NeverBounce; module API; module Request
         unless (v = run_sample).nil?
           _[:run_sample] = v
         end
+
+        unless (v = allow_manual_review).nil?
+          _[:allow_manual_review] = v
+        end
+
+        unless (v = callback_url).nil?
+          _[:callback_url] = v
+        end
+
+        unless (v = callback_headers).nil?
+          _[:callback_headers] = v
+        end
+
+        unless historical.nil?
+          _[:request_meta_data] = {leverage_historical_data: leverage_historical}
+        end
       end
     end
 

data/lib/never_bounce/api/request/jobs_start.rb

@@ -11,6 +11,9 @@ module NeverBounce; module API; module Request
     # @return [Boolean]
     attr_accessor :run_sample
 
+    # @return [Boolean]
+    attr_accessor :allow_manual_review
+
     # @return [Symbol]
     def self.http_method
       :post
@@ -33,6 +36,10 @@ module NeverBounce; module API; module Request
         unless (v = run_sample).nil?
           _[:run_sample] = v
         end
+
+        unless (v = allow_manual_review).nil?
+          _[:allow_manual_review] = v
+        end
       end
     end
 

data/lib/never_bounce/api/request/single_check.rb

@@ -17,6 +17,13 @@ module NeverBounce; module API; module Request
     # @return [Integer]
     attr_accessor :timeout
 
+    # @return [Boolean]
+    attr_accessor :historical
+
+    def leverage_historical
+      defined?(@historical) ? @historical : true
+    end
+
     # @return [Symbol]
     def self.http_method
       :get
@@ -47,6 +54,10 @@ module NeverBounce; module API; module Request
         unless (v = timeout).nil?
           _[:timeout] = v
         end
+
+        unless historical.nil?
+          _[:request_meta_data] = {leverage_historical_data: leverage_historical}
+        end
       end
     end
 

data/lib/never_bounce/api/response/feature/job_status_fields.rb

@@ -23,13 +23,14 @@ module NeverBounce; module API; module Response; module Feature
 
         oattr :bounce_estimate, :scalar, type: :float
         oattr :filename, :scalar
-        oattr :percent_complete, :scalar, type: :integer
+        oattr :percent_complete, :scalar, type: :float
 
         oattr :total, :writer
 
         oattr :created_at, :scalar
         oattr :finished_at, :scalar
         oattr :started_at, :scalar
+        oattr :failure_reason, :scalar
       end
     end
 

data/lib/never_bounce/api/version.rb

@@ -1,4 +1,4 @@
 
 module NeverBounce; module API
-  VERSION = "1.0.1"
+  VERSION = "1.2.0"
 end; end

data/spec/lib/never_bounce/api/client_spec.rb

@@ -14,6 +14,16 @@ module NeverBounce; module API
           expect(r.api_key).to eq "api_key"
         end
       end
+
+      describe "#api_version" do
+        it "generally works" do
+          r = newo
+          r.api_key = "api_key"
+          expect(r.api_version).to eq nil
+          r.api_version = "api_version"
+          expect(r.api_version).to eq "api_version"
+        end
+      end
     end # describe "attributes"
 
     describe "requests" do

data/spec/lib/never_bounce/api/request/account_info_spec.rb

@@ -19,7 +19,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/account/info"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/account/info"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"key\":\"api_key\"}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/jobs_create_spec.rb

@@ -9,12 +9,20 @@ module NeverBounce; module API; module Request
       it "generally works" do
         r = newo()
         expect(r.mode_h).to eq({})
-        r = newo(auto_start: nil, auto_parse: nil, run_sample: nil)
+        r = newo(auto_start: nil, auto_parse: nil, run_sample: nil, allow_manual_review: nil)
         expect(r.mode_h).to eq({})
         r = newo(auto_start: false, auto_parse: false, run_sample: false)
         expect(r.mode_h).to eq({auto_start: false, auto_parse: false, run_sample: false})
         r = newo(auto_start: true, auto_parse: true, run_sample: true)
         expect(r.mode_h).to eq({auto_start: true, auto_parse: true, run_sample: true})
+        r = newo(historical: true)
+        expect(r.mode_h).to eq({request_meta_data: {leverage_historical_data: true}})
+        r = newo(historical: false)
+        expect(r.mode_h).to eq({request_meta_data: {leverage_historical_data: false}})
+        r = newo(allow_manual_review: true, callback_url: "http://test.com", callback_headers: {:Authorization => "Basic test"})
+        expect(r.mode_h).to eq({allow_manual_review: true, callback_url: "http://test.com", callback_headers: {:Authorization => "Basic test"}})
+        r = newo(allow_manual_review: false, callback_url: nil, callback_headers: nil)
+        expect(r.mode_h).to eq({allow_manual_review: false})
       end
     end
 
@@ -79,11 +87,82 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :post
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/create"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/create"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"input\":\"input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"api_key\"}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")
       end
+
+      it "allows historical to be disabled" do
+        r = newo
+        r.input = "input"
+        r.input_location = "remote_url"
+        r.filename = "filename"
+        r.api_key = "api_key"
+        r.historical = false
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"input\":\"input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"api_key\",\"request_meta_data\":{\"leverage_historical_data\":false}}"
+      end
+
+      it "allows historical to be explicitly enabled" do
+        r = newo
+        r.input = "input"
+        r.input_location = "remote_url"
+        r.filename = "filename"
+        r.api_key = "api_key"
+        r.historical = true
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"input\":\"input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"api_key\",\"request_meta_data\":{\"leverage_historical_data\":true}}"
+      end
+
+      it "allows allow manual review parameter to be enabled" do
+        r = newo
+        r.input = "input"
+        r.input_location = "remote_url"
+        r.filename = "filename"
+        r.api_key = "api_key"
+        r.allow_manual_review = true
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"input\":\"input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"api_key\",\"allow_manual_review\":true}"
+      end
+
+      it "allows allow manual review parameter to be disabled" do
+        r = newo
+        r.input = "input"
+        r.input_location = "remote_url"
+        r.filename = "filename"
+        r.api_key = "api_key"
+        r.allow_manual_review = false
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"input\":\"input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"api_key\",\"allow_manual_review\":false}"
+      end
+
+      it "allows callback url and headers" do
+        r = newo
+        r.input = "input"
+        r.input_location = "remote_url"
+        r.filename = "filename"
+        r.api_key = "api_key"
+        r.callback_url = "http://test.com"
+        r.callback_headers = {:Authorization => "Basic test"}
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"input\":\"input\",\"input_location\":\"remote_url\",\"filename\":\"filename\",\"key\":\"api_key\",\"callback_url\":\"http://test.com\",\"callback_headers\":{\"Authorization\":\"Basic test\"}}"
+      end
     end
   end
 end; end; end

data/spec/lib/never_bounce/api/request/jobs_delete_spec.rb

@@ -21,7 +21,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :post
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/delete"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/delete"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq("{\"job_id\":\"123\",\"key\":\"api_key\"}")
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/jobs_download_spec.rb

@@ -21,7 +21,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/download"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/download"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq("{\"job_id\":\"123\",\"key\":\"api_key\"}")
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/jobs_parse_spec.rb

@@ -34,7 +34,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :post
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/parse"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/parse"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq("{\"job_id\":\"123\",\"key\":\"api_key\"}")
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/jobs_results_spec.rb

@@ -32,7 +32,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/results"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/results"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"job_id\":\"123\",\"key\":\"api_key\"}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/jobs_search_spec.rb

@@ -30,7 +30,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/search"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/search"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"key\":\"api_key\",\"job_id\":\"abc\",\"page\":12,\"items_per_page\":34}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/jobs_start_spec.rb

@@ -9,12 +9,12 @@ module NeverBounce; module API; module Request
       it "generally works" do
         r = newo()
         expect(r.mode_h).to eq({})
-        r = newo(run_sample: nil)
+        r = newo(run_sample: nil, allow_manual_review: nil)
         expect(r.mode_h).to eq({})
-        r = newo(run_sample: false)
-        expect(r.mode_h).to eq({run_sample: false})
-        r = newo(run_sample: true)
-        expect(r.mode_h).to eq({run_sample: true})
+        r = newo(run_sample: false, allow_manual_review: false)
+        expect(r.mode_h).to eq({run_sample: false, allow_manual_review: false})
+        r = newo(run_sample: true, allow_manual_review: true)
+        expect(r.mode_h).to eq({run_sample: true, allow_manual_review: true})
       end
     end
 
@@ -34,11 +34,35 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :post
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/start"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/start"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq("{\"job_id\":\"123\",\"key\":\"api_key\"}")
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")
       end
+
+      it "allows allow manual review parameter to be enabled" do
+        r = newo
+        r.job_id = "123"
+        r.api_key = "api_key"
+        r.allow_manual_review = true
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"job_id\":\"123\",\"key\":\"api_key\",\"allow_manual_review\":true}"
+      end
+
+      it "allows allow manual review parameter to be disabled" do
+        r = newo
+        r.job_id = "123"
+        r.api_key = "api_key"
+        r.allow_manual_review = false
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"job_id\":\"123\",\"key\":\"api_key\",\"allow_manual_review\":false}"
+      end
     end
   end
 end; end; end

data/spec/lib/never_bounce/api/request/jobs_status_spec.rb

@@ -21,7 +21,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/jobs/status"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/jobs/status"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"job_id\":\"123\",\"key\":\"api_key\"}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/poe_confirm_spec.rb

@@ -27,7 +27,7 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/poe/confirm"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/poe/confirm"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"email\":\"email\",\"transaction_id\":\"NBTRNS-abcdefg\",\"confirmation_token\":\"abcdefg123456\",\"result\":\"valid\",\"key\":\"api_key\"}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")

data/spec/lib/never_bounce/api/request/single_check_spec.rb

@@ -15,6 +15,10 @@ module NeverBounce; module API; module Request
         expect(r.mode_h).to eq({address_info: false, credits_info: false})
         r = newo(address_info: true, credits_info: true, timeout: 12)
         expect(r.mode_h).to eq({address_info: true, credits_info: true, timeout: 12})
+        r = newo(historical: true)
+        expect(r.mode_h).to eq({request_meta_data: {leverage_historical_data: true}})
+        r = newo(historical: false)
+        expect(r.mode_h).to eq({request_meta_data: {leverage_historical_data: false}})
       end
     end
 
@@ -34,11 +38,33 @@ module NeverBounce; module API; module Request
         expect(res).to be_a Array
         method, url, data = res
         expect(method).to eq :get
-        expect(url).to eq "https://api.neverbounce.com/v4/single/check"
+        expect(url).to eq "https://api.neverbounce.com/v4.2/single/check"
         expect(data).to include(:body, :headers)
         expect(data.fetch(:body)).to eq "{\"email\":\"email\",\"key\":\"api_key\",\"address_info\":true,\"credits_info\":true,\"timeout\":12}"
         expect(data.fetch(:headers)).to include("Content-Type", "User-Agent")
       end
+
+      it "allows historical to be disabled" do
+        r = newo(address_info: true, credits_info: true, timeout: 12, historical: false)
+        r.email = "email"
+        r.api_key = "api_key"
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"email\":\"email\",\"key\":\"api_key\",\"address_info\":true,\"credits_info\":true,\"timeout\":12,\"request_meta_data\":{\"leverage_historical_data\":false}}"
+      end
+
+      it "allows historical to be explicitly enabled" do
+        r = newo(address_info: true, credits_info: true, timeout: 12, historical: true)
+        r.email = "email"
+        r.api_key = "api_key"
+
+        res = r.to_httparty
+        expect(res).to be_a Array
+        method, url, data = res
+        expect(data.fetch(:body)).to eq "{\"email\":\"email\",\"key\":\"api_key\",\"address_info\":true,\"credits_info\":true,\"timeout\":12,\"request_meta_data\":{\"leverage_historical_data\":true}}"
+      end
     end
   end
 end; end; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: neverbounce-api
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.2.0
 platform: ruby
 authors:
 - NeverBounce
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-11 00:00:00.000000000 Z
+date: 2020-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -137,7 +137,6 @@ files:
 - spec/lib/never_bounce/api/response/single_check_spec.rb
 - spec/lib/never_bounce/api/response/spec_helper.rb
 - spec/lib/never_bounce/api/session_spec.rb
-- spec/lib/never_bounce/api_spec.rb
 - spec/spec_helper.rb
 - spec/spec_support/include_dir_context.rb
 - spec/spec_support/simplecov.rb
@@ -160,8 +159,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.10
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: The official NeverBounce API library for Ruby
@@ -210,7 +208,6 @@ test_files:
 - spec/lib/never_bounce/api/response/single_check_spec.rb
 - spec/lib/never_bounce/api/response/spec_helper.rb
 - spec/lib/never_bounce/api/session_spec.rb
-- spec/lib/never_bounce/api_spec.rb
 - spec/spec_helper.rb
 - spec/spec_support/include_dir_context.rb
 - spec/spec_support/simplecov.rb

data/spec/lib/never_bounce/api_spec.rb

@@ -1,8 +0,0 @@
-
-require "never_bounce/api/version"
-
-describe NeverBounce::API do
-  describe "VERSION" do
-    it { expect(described_class::VERSION).to eq "1.0.1" }
-  end
-end