Updated to call MailboxValidator v2 APIs

Author: MailboxValidator

LICENSE.TXT

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 MailboxValidator.com
+Copyright (c) 2023 MailboxValidator.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -44,21 +44,21 @@ Performs email validation on the supplied email address.
 |-----------|------------|
 | email_address | The input email address. |
 | domain | The domain of the email address. |
-| is_free | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: True, False |
-| is_syntax | Whether the email address is syntactically correct. Return values: True, False |
-| is_domain | Whether the email address has a valid MX record in its DNS entries. Return values: True, False, -   (- means not applicable) |
-| is_smtp | Whether the mail servers specified in the MX records are responding to connections. Return values: True, False, -   (- means not applicable) |
-| is_verified | Whether the mail server confirms that the email address actually exist. Return values: True, False, -   (- means not applicable) |
-| is_server_down | Whether the mail server is currently down or unresponsive. Return values: True, False, -   (- means not applicable) |
-| is_greylisted | Whether the mail server employs greylisting where an email has to be sent a second time at a later time. Return values: True, False, -   (- means not applicable) |
-| is_disposable | Whether the email address is a temporary one from a disposable email provider. Return values: True, False, -   (- means not applicable) |
-| is_suppressed | Whether the email address is in our blacklist. Return values: True, False, -   (- means not applicable) |
-| is_role | Whether the email address is a role-based email address like [email protected] or [email protected]. Return values: True, False, -   (- means not applicable) |
-| is_high_risk | Whether the email address contains high risk keywords. Return values: True, False, -   (- means not applicable) |
-| is_catchall | Whether the email address is a catch-all address. Return values: True, False, Unknown, -   (- means not applicable) |
+| is_free | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: true, false |
+| is_syntax | Whether the email address is syntactically correct. Return values: true, false |
+| is_domain | Whether the email address has a valid MX record in its DNS entries. Return values: true, false, null   (null means not applicable) |
+| is_smtp | Whether the mail servers specified in the MX records are responding to connections. Return values: true, false, null   (null means not applicable) |
+| is_verified | Whether the mail server confirms that the email address actually exist. Return values: true, false, null   (null means not applicable) |
+| is_server_down | Whether the mail server is currently down or unresponsive. Return values: true, false, null   (null means not applicable) |
+| is_greylisted | Whether the mail server employs greylisting where an email has to be sent a second time at a later time. Return values: true, false, null   (null means not applicable) |
+| is_disposable | Whether the email address is a temporary one from a disposable email provider. Return values: true, false, null   (null means not applicable) |
+| is_suppressed | Whether the email address is in our blacklist. Return values: true, false, null   (null means not applicable) |
+| is_role | Whether the email address is a role-based email address like [email protected] or [email protected]. Return values: true, false, null   (null means not applicable) |
+| is_high_risk | Whether the email address contains high risk keywords. Return values: true, false, null   (null means not applicable) |
+| is_catchall | Whether the email address is a catch-all address. Return values: true, false, Unknown, null   (null means not applicable) |
 | mailboxvalidator_score | Email address reputation score. Score > 0.70 means good; score > 0.40 means fair; score <= 0.40 means poor. |
 | time_taken | The time taken to get the results in seconds. |
-| status | Whether our system think the email address is valid based on all the previous fields. Return values: True, False |
+| status | Whether our system think the email address is valid based on all the previous fields. Return values: true, false |
 | credits_available | The number of credits left to perform validations. |
 | error_code | The error code if there is any error. See error table in the below section. |
 | error_message | The error message if there is any error. See error table in the below section. |
@@ -72,7 +72,7 @@ Check if the supplied email address is from a disposable email provider.
 | Field Name | Description |
 |-----------|------------|
 | email_address | The input email address. |
-| is_disposable | Whether the email address is a temporary one from a disposable email provider. Return values: True, False |
+| is_disposable | Whether the email address is a temporary one from a disposable email provider. Return values: true, false |
 | credits_available | The number of credits left to perform validations. |
 | error_code | The error code if there is any error. See error table in the below section. |
 | error_message | The error message if there is any error. See error table in the below section. |
@@ -86,7 +86,7 @@ Check if the supplied email address is from a free email provider.
 | Field Name | Description |
 |-----------|------------|
 | email_address | The input email address. |
-| is_free | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: True, False |
+| is_free | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: true, false |
 | credits_available | The number of credits left to perform validations. |
 | error_code | The error code if there is any error. See error table in the below section. |
 | error_message | The error message if there is any error. See error table below. |
@@ -113,7 +113,7 @@ public class Main
 			MBVResult rec = mbv.ValidateEmail("[email protected]");
 			// System.out.println(rec); // for dumping out all result fields
 
-			if (rec.getErrorMessage().equals("")) {
+			if (rec.getErrorMessage() == null) {
 				System.out.println("email_address: " + rec.getEmailAddress());
 				System.out.println("domain: " + rec.getDomain());
 				System.out.println("is_free: " + rec.getIsFree());
@@ -166,7 +166,7 @@ public class Main
 			MBVResult rec = mbv.DisposableEmail("[email protected]");
 			// System.out.println(rec); // for dumping out all result fields
 
-			if (rec.getErrorMessage().equals("")) {
+			if (rec.getErrorMessage() == null) {
 				System.out.println("email_address: " + rec.getEmailAddress());
 				System.out.println("is_disposable: " + rec.getIsDisposable());
 				System.out.println("credits_available: " + rec.getCreditsAvailable());
@@ -204,7 +204,7 @@ public class Main
 			MBVResult rec = mbv.FreeEmail("[email protected]");
 			// System.out.println(rec); // for dumping out all result fields
 
-			if (rec.getErrorMessage().equals("")) {
+			if (rec.getErrorMessage() == null) {
 				System.out.println("email_address: " + rec.getEmailAddress());
 				System.out.println("is_free: " + rec.getIsFree());
 				System.out.println("credits_available: " + rec.getCreditsAvailable());
@@ -229,14 +229,15 @@ Errors
 
 | error_code | error_message |
 | ---------- | ------------- |
-| 100 | Missing parameter. |
-| 101 | API key not found. |
-| 102 | API key disabled. |
-| 103 | API key expired. |
-| 104 | Insufficient credits. |
-| 105 | Unknown error. |
+| 10000 | Missing parameter. |
+| 10001 | API key not found. |
+| 10002 | API key disabled. |
+| 10003 | API key expired. |
+| 10004 | Insufficient credits. |
+| 10005 | Unknown error. |
+| 10006 | Invalid email syntax. |
 
 Copyright
 =========
 
-Copyright (C) 2018-2020 by MailboxValidator.com, [email protected]
+Copyright (C) 2023 by MailboxValidator.com, [email protected]

src/com/mailboxvalidator/MBVResult.java

@@ -25,7 +25,7 @@ public class MBVResult {
 	int credits_available;
 	String error_code;
 	String error_message;
-	String version = "1.1.0";
+	String version = "2.0.0";
 	MBVResult(String email) {
 		email_address = email;
 	}
@@ -41,67 +41,67 @@ public class MBVResult {
 	public String getDomain() { return domain; }
 /**
  * This method to get whether the email address is from a free email provider.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsFree() { return is_free; }
 /**
  * This method to get whether the email address is syntactically correct.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsSyntax() { return is_syntax; }
 /**
  * This method to get whether the email domain has a valid MX record in the DNS entries.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsDomain() { return is_domain; }
 /**
  * This method to get whether the mail server is responding to connection.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsSMTP() { return is_smtp; }
 /**
  * This method to get whether the mail server confirms that the email address actually exists.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsVerified() { return is_verified; }
 /**
  * This method to get whether the mail server is currently down or unresponsive.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsServerDown() { return is_server_down; }
 /**
  * This method to get whether the mail server employs greylisting.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsGreylisted() { return is_greylisted; }
 /**
  * This method to get whether the email address is from a disposable email provider.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsDisposable() { return is_disposable; }
 /**
  * This method to get whether the email address is in our blacklist.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsSuppressed() { return is_suppressed; }
 /**
  * This method to get whether the email address is a role-based email address.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsRole() { return is_role; }
 /**
  * This method to get whether the email address contains high risk keywords.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsHighRisk() { return is_high_risk; }
 /**
  * This method to get whether the email address is a catch-all address.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getIsCatchall() { return is_catchall; }
 /**
  * This method to get the email reputation score.
- * @return the email reputation score; score > 0.70 means good; score > 0.40 means fair; score ≤ 0.40 means poor.
+ * @return the email reputation score; score greater than 0.70 means good; score greater than 0.40 means fair; score less than or equal to 0.40 means poor.
  */
 	public float getMailboxValidatorScore() { return mailboxvalidator_score; }
 /**
@@ -111,7 +111,7 @@ public class MBVResult {
 	public float getTimeTaken() { return time_taken; }
 /**
  * This method to get whether our system think the email address is valid based on the various result fields.
- * @return "True", "False" or "-" if not applicable.
+ * @return "true", "false" or "null" if not applicable.
  */
 	public String getStatus() { return status; }
 /**