email-verifier 1.0.0

python-email-verifier
===================

在Python中验证电子邮件地址的最简单方式。

元信息
----

- 作者：WHOIS API, Inc.
- 邮箱：support@whoisxmlapi.com
- 网站：https://emailverification.whoisxmlapi.com/


先决条件
-------------

要使用此库，您需要创建一个免费的电子邮件验证API账户
https://emailverification.whoisxmlapi.com/

如果您还没有这样做，请现在就做。


文档
-------------

文档可在 `此处 <https://emailverification.whoisxmlapi.com/docs>`_ 获取。

安装
------------

要使用 `pypi <https://pypi.ac.cn>`_ 安装 `email-verifier`，只需运行

.. code-block:: console

$ pip install email-verifier

在项目目录的根目录下。


使用方法
-----

一旦安装了 `email-verified`，您就可以用它轻松地验证任何
电子邮件地址。


.. code-block:: python

from emailverifier import Client
from emailverifier import exceptions

client = Client('您的API密钥')

try
data = client.get("support@whoisxmlapi.com")
except exceptions.HttpException
# 如果您到达这里，这意味着服务返回了HTTP错误代码
pass
except exceptions.GeneralException
# 如果您到达这里，这意味着您无法连接到服务
pass
except exceptions.UndefinedVariableException
# 如果您到达这里，这意味着您忘记了指定API密钥
pass
除了 exceptions.InvalidArgumentException 异常
如果你来到这里，这意味着你指定了无效的参数
（选项应该是一个字典）
pass
except
pass
# 发生了一些相关的事情。可能是你按下了 CTRL-C
# 当程序运行时，内核正在杀死你的进程，或者
# 完全其他的事情。

print(data)

## 使用 data.json_string 获取原始数据的 JSON 格式。
## 你可以通过将字段名从 "camelCase" 转换为 "snake_case" 来访问任何响应字段作为类属性
print("电子邮件地址: " + data.email_address)
print("格式: " + str(data.format_check))
print("DNS: " + str(data.dns_check))
print("SMTP: " + str(data.smtp_check))
print("全捕获: " + str(data.catch_all_check))
print("一次性: " + str(data.disposable_check))
print("免费: " + str(data.free_check))
print("最后审计日期: " + str(data.audit.audit_updated_date))
当执行电子邮件验证请求时，你可能得到的这种数据

request
.. code-block:: json

"emailAddress": "support@whoisxmlapi.com",

{
"formatCheck": "true",
"smtpCheck": "true",
"dnsCheck": "true",
"freeCheck": "false",
"disposableCheck": "false",
"catchAllCheck": "true",
"mxRecords": [
"ALT1.ASPMX.L.GOOGLE.com",
"ALT2.ASPMX.L.GOOGLE.com",
"ASPMX.L.GOOGLE.com",
"ASPMX2.GOOGLEMAIL.com",
"ASPMX3.GOOGLEMAIL.com",
"mx.yandex.net"
],
],
"audit": {
"auditCreatedDate": "2018-04-19 18:12:45.000 UTC",
"auditUpdatedDate": "2018-04-19 18:12:45.000 UTC"
}
}