Skip to content

Commit 05ed04a

Browse files
Update to support for v2 API.
1 parent 740d64a commit 05ed04a

File tree

3 files changed

+62
-62
lines changed

3 files changed

+62
-62
lines changed

MailboxValidator/email_validation.py

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,35 +8,35 @@ def __init__(self, apikey):
88
self.apikey = apikey
99

1010
def validate_email(self, email):
11-
p = { 'key': self.apikey, 'format': 'json', 'email': email }
11+
p = { 'key': self.apikey, 'format': 'json', 'source': 'sdk-python-mbv', 'email': email }
1212

1313
try:
1414
conn = http.client.HTTPConnection("api.mailboxvalidator.com")
15-
conn.request("GET", "/v1/validation/single?" + urllib.parse.urlencode(p))
15+
conn.request("GET", "/v2/validation/single?" + urllib.parse.urlencode(p))
1616
res = conn.getresponse()
1717
# print res.read()
1818
return json.loads(res.read())
1919
except:
2020
return None
2121

2222
def is_disposable_email(self, email):
23-
p = { 'key': self.apikey, 'format': 'json', 'email': email }
23+
p = { 'key': self.apikey, 'format': 'json', 'source': 'sdk-python-mbv', 'email': email }
2424

2525
try:
2626
conn = http.client.HTTPConnection("api.mailboxvalidator.com")
27-
conn.request("GET", "/v1/email/disposable?" + urllib.parse.urlencode(p))
27+
conn.request("GET", "/v2/email/disposable?" + urllib.parse.urlencode(p))
2828
res = conn.getresponse()
2929
# print res.read()
3030
return json.loads(res.read())
3131
except:
3232
return None
3333

3434
def is_free_email(self, email):
35-
p = { 'key': self.apikey, 'format': 'json', 'email': email }
35+
p = { 'key': self.apikey, 'format': 'json', 'source': 'sdk-python-mbv', 'email': email }
3636

3737
try:
3838
conn = http.client.HTTPConnection("api.mailboxvalidator.com")
39-
conn.request("GET", "/v1/email/free?" + urllib.parse.urlencode(p))
39+
conn.request("GET", "/v2/email/free?" + urllib.parse.urlencode(p))
4040
res = conn.getresponse()
4141
# print res.read()
4242
return json.loads(res.read())

README.md

Lines changed: 55 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -99,73 +99,73 @@ Sample Codes
9999

100100
```python
101101
import MailboxValidator
102-
103-
mbv = MailboxValidator.EmailValidation('PASTE_API_KEY_HERE')
104-
results = mbv.validate_email('example@example.com')
105-
106-
if results is None:
107-
print("Error connecting to API.\n")
108-
elif results['error_code'] == '':
109-
print('email_address = ' + results['email_address'] + "\n")
110-
print('domain = ' + results['domain'] + "\n")
111-
print('is_free = ' + results['is_free'] + "\n")
112-
print('is_syntax = ' + results['is_syntax'] + "\n")
113-
print('is_domain = ' + results['is_domain'] + "\n")
114-
print('is_smtp = ' + results['is_smtp'] + "\n")
115-
print('is_verified = ' + results['is_verified'] + "\n")
116-
print('is_server_down = ' + results['is_server_down'] + "\n")
117-
print('is_greylisted = ' + results['is_greylisted'] + "\n")
118-
print('is_disposable = ' + results['is_disposable'] + "\n")
119-
print('is_suppressed = ' + results['is_suppressed'] + "\n")
120-
print('is_role = ' + results['is_role'] + "\n")
121-
print('is_high_risk = ' + results['is_high_risk'] + "\n")
122-
print('is_catchall = ' + results['is_catchall'] + "\n")
123-
print('mailboxvalidator_score = ' + str(results['mailboxvalidator_score']) + "\n")
124-
print('time_taken = ' + str(results['time_taken']) + "\n")
125-
print('status = ' + results['status'] + "\n")
126-
print('credits_available = ' + str(results['credits_available']) + "\n")
127-
else:
128-
print('error_code = ' + results['error_code'] + "\n")
129-
print('error_message = ' + results['error_message'] + "\n")
102+
103+
mbv = MailboxValidator.EmailValidation('PASTE_API_KEY_HERE')
104+
results = mbv.validate_email('example@example.com')
105+
106+
if results is None:
107+
print("Error connecting to API.\n")
108+
elif 'error' not in results:
109+
print('email_address = ' + results['email_address'] + "\n")
110+
print('domain = ' + results['domain'] + "\n")
111+
print('is_free = ' + str(results['is_free']) + "\n")
112+
print('is_syntax = ' + str(results['is_syntax']) + "\n")
113+
print('is_domain = ' + str(results['is_domain']) + "\n")
114+
print('is_smtp = ' + str(results['is_smtp']) + "\n")
115+
print('is_verified = ' + str(results['is_verified']) + "\n")
116+
print('is_server_down = ' + str(results['is_server_down']) + "\n")
117+
print('is_greylisted = ' + str(results['is_greylisted']) + "\n")
118+
print('is_disposable = ' + str(results['is_disposable']) + "\n")
119+
print('is_suppressed = ' + str(results['is_suppressed']) + "\n")
120+
print('is_role = ' + str(results['is_role']) + "\n")
121+
print('is_high_risk = ' + str(results['is_high_risk']) + "\n")
122+
print('is_catchall = ' + str(results['is_catchall']) + "\n")
123+
print('mailboxvalidator_score = ' + str(results['mailboxvalidator_score']) + "\n")
124+
print('time_taken = ' + str(results['time_taken']) + "\n")
125+
print('status = ' + str(results['status']) + "\n")
126+
print('credits_available = ' + str(results['credits_available']) + "\n")
127+
else:
128+
print('error_code = ' + str(results['error']['error_code']) + "\n")
129+
print('error_message = ' + results['error']['error_message'] + "\n")
130130
```
131131

132132

133133
## Check if an email is from a disposable email provider
134134

135135
```python
136136
import MailboxValidator
137-
138-
mbv = MailboxValidator.EmailValidation('PASTE_API_KEY_HERE')
139-
results = mbv.is_disposable_email('example@example.com')
140-
141-
if results is None:
142-
print("Error connecting to API.\n")
143-
elif results['error_code'] == '':
144-
print('email_address = ' + results['email_address'] + "\n")
145-
print('is_disposable = ' + results['is_disposable'] + "\n")
146-
print('credits_available = ' + str(results['credits_available']) + "\n")
147-
else:
148-
print('error_code = ' + results['error_code'] + "\n")
149-
print('error_message = ' + results['error_message'] + "\n")
137+
138+
mbv = MailboxValidator.EmailValidation('PASTE_API_KEY_HERE')
139+
results = mbv.is_disposable_email('example@example.com')
140+
141+
if results is None:
142+
print("Error connecting to API.\n")
143+
elif 'error' not in results:
144+
print('email_address = ' + results['email_address'] + "\n")
145+
print('is_disposable = ' + str(results['is_disposable']) + "\n")
146+
print('credits_available = ' + str(results['credits_available']) + "\n")
147+
else:
148+
print('error_code = ' + results['error']['error_code'] + "\n")
149+
print('error_message = ' + results['error']['error_message'] + "\n")
150150
```
151151

152152
## Check if an email is from a free email provider
153153

154154
```python
155155
import MailboxValidator
156-
157-
mbv = MailboxValidator.EmailValidation('PASTE_API_KEY_HERE')
158-
results = mbv.is_free_email('example@example.com')
159-
160-
if results is None:
161-
print("Error connecting to API.\n")
162-
elif results['error_code'] == '':
163-
print('email_address = ' + results['email_address'] + "\n")
164-
print('is_free = ' + results['is_free'] + "\n")
165-
print('credits_available = ' + str(results['credits_available']) + "\n")
166-
else:
167-
print('error_code = ' + results['error_code'] + "\n")
168-
print('error_message = ' + results['error_message'] + "\n")
156+
157+
mbv = MailboxValidator.EmailValidation('PASTE_API_KEY_HERE')
158+
results = mbv.is_free_email('example@example.com')
159+
160+
if results is None:
161+
print("Error connecting to API.\n")
162+
elif 'error' not in results:
163+
print('email_address = ' + results['email_address'] + "\n")
164+
print('is_free = ' + str(results['is_free']) + "\n")
165+
print('credits_available = ' + str(results['credits_available']) + "\n")
166+
else:
167+
print('error_code = ' + results['error']['error_code'] + "\n")
168+
print('error_message = ' + results['error']['error_message'] + "\n")
169169
```
170170

171171
Errors
@@ -183,4 +183,4 @@ Errors
183183
Copyright
184184
=========
185185

186-
Copyright (C) 2018-2021 by MailboxValidator.com, support@mailboxvalidator.com
186+
Copyright (C) 2018-2023 by MailboxValidator.com, support@mailboxvalidator.com

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
setuptools.setup(
77
name="MailboxValidator",
8-
version="1.2.0",
8+
version="1.3.0",
99
author="MailboxValidator.com",
1010
author_email="support@mailboxvalidator.com",
1111
description="Email verification module for Python using MailboxValidator API. It validates if the email is valid, from a free provider, contains high-risk keywords, whether it\'s a catch-all address and so much more.",

0 commit comments

Comments
 (0)