获取结果(已处理的电子邮件)| 文档 | 电子邮件验证批量 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"
}

输入参数

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”数组中。

结果

result 字段可能包含四个值: 'ok''unknown''smtp-failed''bad' 。'ok '表示邮件成功通过了 SMTP 检查和 DNS 检查,并且该邮箱地址不是一次性的。'bad '表示部分检查(除 SMTP 检查外)失败。'smtp -failed'表示该邮箱地址在目标 SMTP 服务器上不存在或暂时无法接收邮件。'unknown '表示邮箱主机支持“获取所有性能”。

电子邮件地址
需要验证的电子邮件地址。
formatCheck
知晓电子邮件地址中是否存在语法错误。这是一项基本检查,用于发现任意简单的拼写错误或重大错误。如果没有错误,则此值为“真” ,否则为“假” 。在后台,API 服务会以多种方式为用户处理所有这些类型的验证检查。
smtp检查
检查电子邮件地址是否存在,是否可以使用 SMTP 连接和电子邮件发送模拟技术接收电子邮件。如果电子邮件地址存在并且可以通过 SMTP 接收电子邮件,则此值为“true”,如果电子邮件地址不在目标 SMTP 服务器上或暂时无法接收邮件,则此值为“false 。如果无法完成 SMTP 请求、目标邮箱提供商不支持邮箱验证或不适用,则该值为空。
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记录
邮件服务器列表。可能会因电子邮件无效或不存在,则不存在。