获取结果(已处理的电子邮件)|文档 |电子邮件验证批量 API | WhoisXML API

获取结果(已处理的电子邮件)

POST https://emailverification.whoisxmlapi.com/api/bevService/request/completed

CURL 请求示例

curl https://emailverification.whoisxmlapi.com/api/bevService/request/completed -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "id": 622, "format": "json"}'

POST 请求正文示例

{
    "apiKey": "YOUR_API_KEY",
    "id": 596,
    "format": "csv"
}

输入参数

apiKey

必填。在我的产品页面获取个人 API KEY。

ID

必填。整数。

请求的 ID。

格式

选填。字符串。

用于指定响应格式。

允许的值:“xml”、“json”、“csv”。

默认值:“json”。

样本输出

{
    "response": [
        {
            "emailAddress": "alex@alex.edu",
            "formatCheck": "true",
            "smtpCheck": "null",
            "dnsCheck": "false",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "null",
            "result": "bad"
        },
        {
            "emailAddress": "bob@google.com",
            "formatCheck": "true",
            "smtpCheck": "true",
            "dnsCheck": "true",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "true",
            "mxRecords": [
                "alt2.aspmx.l.google.com",
                "alt3.aspmx.l.google.com",
                "alt4.aspmx.l.google.com",
                "aspmx.l.google.com",
                "alt1.aspmx.l.google.com"
            ],
            "result": "unknown"
        },
        {
            "emailAddress": "mila@yahoo.com",
            "formatCheck": "true",
            "smtpCheck": "true",
            "dnsCheck": "true",
            "freeCheck": "true",
            "disposableCheck": "false",
            "catchAllCheck": "true",
            "mxRecords": [
                "mta6.am0.yahoodns.net",
                "mta5.am0.yahoodns.net",
                "mta7.am0.yahoodns.net"
            ],
            "result": "unknown"
        }
    ]
}

Code: 200 OK.
{
    "response": {
        "error": "Wrong request id"
    }
}

Code: 422 Unprocessable Entity.
响应

响应对象。

包含原始请求中每个电子邮件地址的验证结果数组(请参阅下面的文档)。

这些搜索请求的结果可以直接保存到磁盘。

如果出现错误,则会在“错误”字段中包含其描述。如果存在多个错误,则它们的描述将在“errors”数组中返回。

结果

结果字段可能包含四个值: 'ok''unknown''smtp-failed''bad'“ok”值意味着电子邮件成功通过了 SMTP、DNS 检查,且该电子邮件地址不是一次性的。 “bad”值意味着某些检查(SMTP 检查除外)失败。 “smtp-failed”值表示目标 SMTP 服务器上不存在该电子邮件地址或暂时无法接收邮件。 “未知”值意味着电子邮件托管支持“捕获所有功能”。

emailAddress
待验证的电子邮件地址。
formatCheck
核查电子邮件地址中是否存在语法错误。这是一项基本检查,旨在发现任何简单的拼写错误或重大错误。如果没有错误,该值将为“true” ,否则为“false” 。在幕后,API 服务正在以多种有趣的方式为您处理所有这些类型的验证检查。
smtpCheck
通过使用 SMTP 连接和模拟发送电子邮件的技术来检查电子邮件地址是否存在并能接收邮件。如果电子邮件地址存在并能通过 SMTP 接收邮件,该值将为 'true';如果电子邮件地址在目标 SMTP 服务器上不存在或暂时无法接收邮件,该值将为 'false'。如果无法完成 SMTP 请求、目标邮箱提供商不支持邮箱验证或不适用,该值将为 null。
dnsCheck
确保电子邮件地址中的域名(例如:gmail.com)是有效的。如果域名良好,则该值将为“true” ,否则为“false” 。对于无效或不存在的电子邮件,可能为“空”
freeCheck
检查电子邮件地址是否来自 Gmail 等免费电子邮件提供商。如果不是免费的,则该值将为“false” ,否则为“true” 。对于无效或不存在的电子邮件,可能为“空”
disposableCheck
检查电子邮件地址是否是一次性的(通过 Mailinator 等服务创建),同时检查是否存在滥用行为。如果电子邮件不是一次性的,则该值将为“假” ,否则为“真” 。对于无效或不存在的电子邮件,可能为“空”
catchAllCheck
检查邮件服务器是否有“包罗万象”的地址。这是指一种特殊类型的地址,可以接收特定域下任意数量不存在的电子邮件地址的电子邮件。通用地址在企业中很常见,如果您向 test@hi.com 发送一封电子邮件,并向不存在的 test2@hi.com 发送另一封电子邮件,那么这两封电子邮件都会进入同一个收件箱。可能的值为'true''false' 。对于无效或不存在的电子邮件,可能为“空”
mxRecords
邮件服务器列表。可能因无效或不存在的电子邮件而空缺。