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

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
}

输入参数

api密钥

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

ID

必填。整数。

请求ID。

格式

选填。字符串。

使用指定响应格式。

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

默认值:“json”。

样本示例导出

{
    "response": [
        {
            "emailAddress": "[email protected]",
            "formatCheck": "true",
            "smtpCheck": "null",
            "dnsCheck": "false",
            "freeCheck": "false",
            "disposableCheck": "false",
            "catchAllCheck": "null",
            "result": "bad"
        },
        {
            "emailAddress": "[email protected]",
            "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": "[email protected]",
            "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.
回复

响应对象。

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

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

如果发生错误,其描述将包含在“error”字段中。如果有多个错误,则其描述将返回到“errors”数组中。

结果

结果字段可能包含四个值: 'ok''unknown''smtp-failed''bad''ok'值表示电子邮件已成功通过 SMTP 检查和 DNS 检查,并且此电子邮件地址并非一次性地址。'bad '值表示除 SMTP 检查外,其他检查均失败。'smtp -failed'值表示目标 SMTP 服务器上不存在该电子邮件地址,或者暂时无法接收邮件。'unknown '值表示电子邮件托管服务支持“全部接收”功能。

电子邮件地址
需要验证的电子邮件地址。
formatCheck
知晓电子邮件地址中是否存在语法错误。这是一项基本检查,用于发现任意简单的拼写错误或重大错误。如果没有错误,则此值为“真” ,否则为“假” 。在后台,API 服务会以多种方式为用户处理所有这些类型的验证检查。
smtp检查
检查电子邮件地址是否存在,以及是否能够通过 SMTP 连接和电子邮件发送模拟技术接收邮件。如果电子邮件地址存在且能够通过 SMTP 接收邮件,则此值为“true”;如果目标 SMTP 服务器上不存在该电子邮件地址,或者暂时无法接收邮件,则此值为“false” 。如果 SMTP 请求无法完成、目标邮箱提供商不支持邮箱验证,或者此方法不适用,则此值为“null”
dnsCheck
确保电子邮件地址中的域名(例如 gmail.com)是有效域名。如果域名有效,则此值为“true” ,否则为“false” 。如果电子邮件无效或不存在,则可能为“null”
freeCheck
查验电子邮件地址是否来自 Gmail 等免费电子邮件提供商。如果电子邮件地址不是免费的,则此值为“false” ,否则为“true” 。如果电子邮件地址无效或不存在,则可能为“null”
disposableCheck
告知您电子邮件地址是否为一次性的(通过 Mailinator 等服务创建)。此项服务有助于查验是否存在滥用情况。如果电子邮件地址不是一次性的,则此值为“false” ,否则为“true” 。如果电子邮件地址无效或不存在,则可能为“null”
catchAllCheck
告知您此邮件服务器是否具有“catch-all”地址。这是一种特殊类型的地址,可以接收特定域名下任意数量不存在的电子邮件地址的邮件。catch-all 地址在企业中很常见,如果您向[email protected]发送一封邮件,同时向不存在的[email protected]发送另一封邮件,则这两封邮件都会进入同一个收件箱。可能的值为'true''false' 。如果电子邮件地址无效或不存在,则可能为'null'
mx记录
邮件服务器列表。可能会因电子邮件无效或不存在,则不存在。