验证电子邮件地址的API

核实邮件列表

要发送邮件列表以供审查，请将POST请求发送到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/send-list-to-verify/

请求参数:

参数 类型 描述
id int 要验证的邮件列表ID 要求

请求示例:

{"id":89165888}

请注意，您不能同时在同一个邮件列表上运行多个验证。您必须等到第一次验证结束。您可以使用“获取邮件列表验证结果”的方法。

如果要发送邮件列表进行重新审查，则必须将新地址添加到其中。您只能验证未在活动中使用过的邮件列表。还要注意当前计划的到期日期和可用的验证次数。

如果请求成功，您将收到回复:

{"result": true}

若要查看验证结果，请使用“获取邮件列表验证结果”的方法。

获取邮件列表验证进度

要查看当前正在验证的邮件列表的进度，请发送GET请求到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/get-progress/?id = {id}

请求参数:

参数 类型 描述
id int 正在验证的邮件列表ID 要求

如果请求成功，您将收到回复:

{“结果”:真的,“数据”:{“加工”:“总”:22日20}}

获取邮件列表验证结果

要从邮件列表中获取电子邮件地址列表及其验证结果，请将get请求发送到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/check/?id = {id}

请求参数:

参数 类型 描述
id int 邮件列表ID您已验证 要求

请注意，这些方法应成对使用:首先，您需要使用“核实邮件列表方法，然后“获取邮件列表验证结果”。否则，你将收到一个假错误。

如果请求成功，您将收到回复:

{"id": 89163337， "address_book_name": "邮件列表1"，"all_emails_quantity": 5， "status": 1， "check_date": "2020-11-19 13:42:11"， "data":{"0": 0， //未验证地址个数(灰色)"1": 5， //有效地址数(绿色)"2": 1， //未确认地址的数量(黄色)"3": 0， //无效地址数(红色)}，"is_updated": 0， // 1-检查后向邮件列表中添加了新地址，0-未对邮件列表进行验证"status_text": "Green"， "email_addresses": [{"id": 10417371353， "email_address": "example1@mail.ru"， "check_date": "2020-11-19 13:41:20"， "status": 1， "status_text": "有效地址"}，{"id": 10417371352， "email_address": "example2@ukr.net"， "check_date": "2020-11-19 13:41:23"， "status": 1， "status_text": "status_text": ""有效地址"}，{"id": 10417371349， "email_address": "example3@gmail.com"， "check_date": "2020-11-19 13:41:20"， "status": 1， "status_text": "有效地址"}，{"id": 10417371347， "email_address": "example4@gmail.com"， "check_date": "2020-11-19 13:41:21"， "status": 1， "status_text": "有效地址"}，{"id": 10417371345， "email_address": "example5@rambler.ru"， "check_date": "2020-11-19 13:41:20"， "status": 1， "status_text": "有效地址"}]，"email_addresses_total": 5}

可能的地址状态:

代码 描述
0 未验证地址(验证后添加的地址)
1 有效的地址
2 未经证实的地址
3. 无效的地址

获取一份已验证邮件列表

要获得已验证邮件列表的列表，请向URL发送get请求:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/check-list

请求参数:

参数 类型 描述
开始 int 从哪个记录显示结果;默认是0 可选
数 int 记录数量;默认是10 可选

如果请求成功，您将收到回复:

{"total": 2， //已验证邮件列表数量"list": [{"id": 89114118， "address_book_name": "邮件列表1"，"all_emails_quantity": 0， "status": 1， // "check_date": "2020-11-23 14:28:14"， "data":{"0": 0， //未验证地址数量(灰色)"1": 21， //有效地址数(绿色)"2": 1， //未确认地址的数量(黄色)"3": 0 //无效地址数(红色)}，"is_updated": 0， // 1-检查后添加了新的地址到邮件列表中，0-未验证的邮件列表"status_text": "Green"， "is_garbage_in_book": false // true邮件列表中包含以前验证过的地址，false邮件列表没有检查}，{"id": 89163340， "address_book_name": "邮件列表2"，"all_emails_quantity": 0， "status": 1， "check_date": "2020-11-19 13:43:11"， "data": {"0":0， //未验证地址个数(灰色)"1": 2， //有效地址数(绿色)"2": 1， //未确认地址的数量(黄色)"3": 0 //无效地址数(红色)}，"is_updated": 1， // 1 -验证后将新地址添加到邮件列表，0 -未验证的邮件列表"status_text": "绿色，已更新"，"is_garbage_in_book": true // true邮件列表包含先前验证的地址，false没有检查邮件列表}]}

可能的邮件列表状态:

代码 的名字 描述
1 绿色 邮件列表可能包含一小部分无效和未经确认的地址。通常，这样的列表被认为是“好的”，因为它不会导致很多交付错误。
2 黄色的 邮件列表包含一小部分无效地址和大量未经确认的地址。
3. 红色的 邮件列表中无效地址的比例很高

验证单个电子邮件地址

要验证一个电子邮件地址，发送一个POST请求到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/send-single-to-verify/

请求参数:

参数 类型 描述
电子邮件 字符串 您需要验证的电子邮件地址 要求

请求示例:

{"email":"user@example.com"}

如果请求成功，您将收到回复:

{"result": true}

若要查看验证结果，请使用“获取邮箱地址验证结果”的方法。

获取电子邮件地址验证结果

为了获得验证的结果，发送一个get请求到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/get-single-result/?电子邮件= {email}

请求参数:

参数 类型 描述
电子邮件 字符串 您已验证的邮箱地址 要求

请注意，这些方法应成对使用:首先，您需要使用“验证单个电子邮件地址方法，然后“获取电子邮件地址验证结果”。否则，你将收到一个假错误。

如果请求成功，您将收到回复:

{"result": true， "data": {"email": "example1@gmail.com"， "checks": {"status": 1， "valid_format": 1， //1如果地址格式正确，即包含正确顺序的有效字符"disposable": 0， //1如果地址是由一次性邮件服务提供的"webmail": 0， //1如果地址是由邮件服务提供的"gibberish": 0， //1如果地址是自动生成的"status_text": "valid address"}}

创建邮件列表验证报告

要为给定的邮件列表创建带有验证结果的报告，请将POST请求发送到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/make-report

请求参数:

参数 类型 描述
id int 邮件列表ID您已验证 要求
格式 int 报表格式，可取值:2csv,3.——xls,4——xlsx;默认是2 可选
状态 数组 JSON_encoded数组，地址将在报告中有以下状态:0未经证实的,1——有效,2未经证实的,3.——无效;默认是[1] 可选
朗 字符串 报告语言 可选

请求示例:

{" id ": 89165888,“格式”:2,“状态”:“(1、2、3)”,“朗”:“俄罗斯”}

如果请求成功，您将收到回复:

{"result": true}

查看邮件列表验证报告

要查看带有邮件列表验证结果的报告，请将GET请求发送到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/check-report?id = {id}

请求参数:

参数 类型 描述
id int 您为其创建报表的邮件列表ID 要求
格式 int 报表格式，可取值:2csv,3.——xls,4——xlsx;默认是2 可选

请注意，这些方法应按顺序使用:首先需要使用“创建邮件列表验证报告方法，然后“查看邮件列表验证报告”及“下载邮件列表验证报告否则，你会收到一个假错误。

如果请求成功，您将收到回复:

{"id": 89165888， "address_book_name": "邮件列表1"，"all_emails_quantity": 10， "status": 3， "check_date": "2020-11-23 18:02:36"， "data": {"0": 0， "1": 3， "2": 0， "3": 1}， "is_updated": 0， // 1-验证后的邮件列表中添加了新的地址，0-未验证的邮件列表"status_text": "Red"， "email_addresses": [{"id": 10422192143， "email_address": "user@example.com"， "check_date": "2020-11-23 18:01:35"， "status": 3， "status_text": "无效地址"}，{"id":10422192131， "email_address": "user2@example.com"， "check_date": "2020-11-23 18:01:35"， "status": 1， "status_text": "有效地址"}，{"id": 10422192128， "email_address": "user3@example.com"， "check_date": "2020-11-23 18:01:34"， "status": 1， "status_text": "有效地址"}，{"id": 10422192125， "email_address": "user4@example.com"， "check_date": "2020-11-23 18:01:35"， "status": 1， "status_text": "有效地址"}]，"email_addresses_total": 4}

下载邮件列表验证报告

要下载带有邮件列表验证结果的报告，请将GET请求发送到:

https://api.开云体育手机网页版登录入口官网www.alanlshields.com/verifier-service/get-report?id = {id}

请求参数:

参数 类型 描述
id int 您为其创建报告的邮件列表 要求
格式 int 报表格式，可取值:2csv,3.——xls,4——xlsx;默认是2 可选

如果请求成功，您将收到所选格式的地址列表和每个地址的验证状态。

请注意，下载报告后，它将从数据库中删除。如果您尝试再次获取报告，您将收到一个假响应。

Baidu
map