Added free & disposable email APIs

Author: MailboxValidator

README.md

@@ -23,8 +23,8 @@ An api key is required for this module to function.
 
 Go to https://www.mailboxvalidator.com/plans#api to sign up for FREE API plan and you'll be given an API key.
 
-Usage
-=====
+Usage for validation email
+==========================
 
 ```javascript
 var mbv = require("mailboxvalidator-nodejs");
@@ -181,6 +181,123 @@ The error code if there is any error. See error table below.
 
 The error message if there is any error. See error table below.
 
+
+Usage for checking if the email is from a disposable email provider
+===================================================================
+
+```javascript
+var mbv = require("mailboxvalidator-nodejs");
+
+mbv.MailboxValidator_init("YOUR_API_KEY");
+
+mbv.MailboxValidator_disposable_email("[email protected]", mbv_read_disposable);
+
+function mbv_read_disposable(err, res, data) {
+	if (!err && res.statusCode == 200) {
+		console.log("email_address: " + data.email_address);
+		console.log("is_disposable: " + data.is_disposable);
+		console.log("credits_available: " + data.credits_available);
+		console.log("error_code: " + data.error_code);
+		console.log("error_message: " + data.error_message);
+	}
+}
+```
+
+Functions
+=========
+
+### MailboxValidator_init(api_key)
+
+Creates a new instance of the MailboxValidator object with the API key.
+
+### MailboxValidator_disposable_email(email_address, callback_function)
+
+Performs disposable email check on the supplied email address and a callback function.
+
+Result Fields
+=============
+
+### 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
+
+### credits_available
+
+The number of credits left to perform validations.
+
+### error_code
+
+The error code if there is any error. See error table below.
+
+### error_message
+
+The error message if there is any error. See error table below.
+
+
+Usage for checking if the email is from a free email provider
+=============================================================
+
+```javascript
+var mbv = require("mailboxvalidator-nodejs");
+
+mbv.MailboxValidator_init("YOUR_API_KEY");
+
+mbv.MailboxValidator_free_email("[email protected]", mbv_read_free);
+
+function mbv_read_free(err, res, data) {
+	if (!err && res.statusCode == 200) {
+		console.log("email_address: " + data.email_address);
+		console.log("is_free: " + data.is_free);
+		console.log("credits_available: " + data.credits_available);
+		console.log("error_code: " + data.error_code);
+		console.log("error_message: " + data.error_message);
+	}
+}
+```
+
+Functions
+=========
+
+### MailboxValidator_init(api_key)
+
+Creates a new instance of the MailboxValidator object with the API key.
+
+### MailboxValidator_free_email(email_address, callback_function)
+
+Performs free email check on the supplied email address and a callback function.
+
+Result Fields
+=============
+
+### 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
+
+### credits_available
+
+The number of credits left to perform validations.
+
+### error_code
+
+The error code if there is any error. See error table below.
+
+### error_message
+
+The error message if there is any error. See error table below.
+
+
 Errors
 ======
 

package.json

@@ -1,13 +1,13 @@
 {
 	"name": "mailboxvalidator-nodejs",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"description": "MailboxValidator API",
 	"keywords": ["mailboxvalidator api", "email validation"],
-	"homepage": "http://www.mailboxvalidator.com/nodejs",
+	"homepage": "https://www.mailboxvalidator.com/nodejs",
 	"author": {
 		"name": "MailboxValidator.com",
 		"email": "[email protected]",
-		"url": "http://www.mailboxvalidator.com/"
+		"url": "https://www.mailboxvalidator.com/"
 	},
 	"files": ["src/mailboxvalidator.js","src/test.js","./README.md"],
 	"main": "src/mailboxvalidator.js",

src/mailboxvalidator.js

@@ -1,8 +1,10 @@
 var https = require('https');
 
-var version = "1.0";
+var version = "1.1";
 var apikey = "";
 var singleurl = "https://api.mailboxvalidator.com/v1/validation/single";
+var disposableurl = "https://api.mailboxvalidator.com/v1/email/disposable";
+var freeurl = "https://api.mailboxvalidator.com/v1/email/free";
 
 exports.MailboxValidator_init = function MailboxValidator_init(licensekey) {
 	apikey = licensekey;
@@ -17,3 +19,23 @@ exports.MailboxValidator_single_query = function MailboxValidator_single_query(e
 		callback(e);
 	});
 }
+
+exports.MailboxValidator_disposable_email = function MailboxValidator_disposable_email(email, callback) {
+	https.get(disposableurl + '?key=' + encodeURIComponent(apikey) + '&email=' + encodeURIComponent(email), function(res) {
+		res.on('data', function(d) {
+			callback(null, res, JSON.parse(d));
+		});
+	}).on('error', function(e) {
+		callback(e);
+	});
+}
+
+exports.MailboxValidator_free_email = function MailboxValidator_free_email(email, callback) {
+	https.get(freeurl + '?key=' + encodeURIComponent(apikey) + '&email=' + encodeURIComponent(email), function(res) {
+		res.on('data', function(d) {
+			callback(null, res, JSON.parse(d));
+		});
+	}).on('error', function(e) {
+		callback(e);
+	});
+}

src/test.js

@@ -2,9 +2,13 @@ var mbv = require("mailboxvalidator-nodejs");
 
 mbv.MailboxValidator_init("YOUR_API_KEY");
 
-mbv.MailboxValidator_single_query("[email protected]", mbv_read_single);
+mbv.MailboxValidator_single_query("[email protected]", mbv_results);
 
-function mbv_read_single(err, res, data) {
+mbv.MailboxValidator_disposable_email("[email protected]", mbv_results);
+
+mbv.MailboxValidator_free_email("[email protected]", mbv_results);
+
+function mbv_results(err, res, data) {
 	if (!err && res.statusCode == 200) {
 		console.log(data);
 	}