Updates for sandbox API mode

README.md

@@ -41,7 +41,13 @@ require "quickemailverification"
 
 client   = QuickEmailVerification::Client.new('Your_API_Key_Here')
 quickemailverification  = client.quickemailverification()
+
+# PRODUCTION MODE
 response = quickemailverification.verify("[email protected]")
+
+# SANDBOX MODE
+# response = quickemailverification.sandbox("[email protected]")
+
 puts response.body
 ```
 
@@ -92,6 +98,11 @@ QuickEmailVerification API also returns following HTTP status codes to indicate
 - `404` - Requested API can not be found on server.
 - `429` - Too many requests. Rate limit exceeded.
 
+## Sandbox Mode
+QuickEmailVerification single email verification API sandbox mode helps developers to test their integration against simulated results. Requesting against sandbox endpoint is totally free and no credits will be deducted from actual credit quota.
+
+Please refer our [knowledge base](http://docs.quickemailverification.com/email-verification-api/sandbox-mode) to learn more about sandbox mode.
+
 ## License
 MIT
 

lib/quickemailverification/api/quickemailverification.rb

@@ -22,6 +22,19 @@ def verify(email, options = {})
         @client.get("/verify?email=#{email}", body, options)
       end
 
+      # Return predefined response for predefined email address
+      #
+      # '/verify/sandbox?email=:email' GET
+      #
+      # email - send email address in query parameter
+      def sandbox(email, options = {})
+        body = options.fetch("query", {})
+
+        email = CGI::escape(email)
+
+        @client.get("/verify/sandbox?email=#{email}", body, options)
+      end
+
     end
 
   end

lib/quickemailverification/http_client.rb

@@ -22,7 +22,7 @@ def initialize(auth = {}, options = {})
         @options = {
           :base => "http://api.quickemailverification.com",
           :api_version => "v1",
-          :user_agent => "quickemailverification-ruby/1.0.1 (https://github.com/quickemailverification/quickemailverification-ruby)"
+          :user_agent => "quickemailverification-ruby/1.0.2 (https://github.com/quickemailverification/quickemailverification-ruby)"
         }
 
         @options.update(options)

lib/quickemailverification/http_client/error_handler.rb

@@ -20,26 +20,28 @@ def call(env)
           when 400...499
             body = QuickEmailVerification::HttpClient::ResponseHandler.get_body(env)
             message = ""
-
-            # If HTML, whole body is taken
-            if body.is_a?(String)
-              message = body
-            end
-
-            # If JSON, a particular field is taken and used
-            if type.include?("json") and body.is_a?(Hash)
-              if body.has_key?("message")
-                message = body["message"]
-              else
-                message = "Unable to select error message from json returned by request responsible for error"
-              end
+            arrErrCode = [400, 401, 402, 403, 404, 429]
+            if !arrErrCode.include?(code)
+                # If HTML, whole body is taken
+                if body.is_a?(String)
+                  message = body
+                end
+
+                # If JSON, a particular field is taken and used
+                if type.include?("json") and body.is_a?(Hash)
+                  if body.has_key?("message")
+                    message = body["message"]
+                  else
+                    message = "Unable to select error message from json returned by request responsible for error"
+                  end
+                end
+
+                if message == ""
+                  message = "Unable to understand the content type of response returned by request responsible for error"
+                end
+
+                raise QuickEmailVerification::Error::ClientError.new message, code
             end
-
-            if message == ""
-              message = "Unable to understand the content type of response returned by request responsible for error"
-            end
-
-            raise QuickEmailVerification::Error::ClientError.new message, code
           end
         end
       end

quickemailverification.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |gem|
   gem.name        = "quickemailverification"
-  gem.version     = "1.0.1"
+  gem.version     = "1.0.2"
   gem.description = "Official QuickEmailVerification API library client for ruby."
   gem.summary     = "Official QuickEmailVerification API library client for ruby"