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

The result field may contains four values: 'ok', 'unknown', 'smtp-failed', 'bad'. The 'ok' value means that the email successful passed through the SMTP check, DNS check, and this email address isn’t disposable. The 'bad' value means that some of this checks (except SMTP check) were failed. The 'smtp-failed' value means the email address does not exist on the target SMTP server or temporary couldn't receive messages. The 'unknown' value means that email hosting supports "catch all feature".

电子邮件地址
需要验证的电子邮件地址。
formatCheck
知晓电子邮件地址中是否存在语法错误。这是一项基本检查,用于发现任意简单的拼写错误或重大错误。如果没有错误,则此值为“真” ,否则为“假” 。在后台,API 服务会以多种方式为用户处理所有这些类型的验证检查。
smtp检查
检查电子邮件地址是否存在,是否可以使用 SMTP 连接和电子邮件发送模拟技术接收电子邮件。如果电子邮件地址存在并且可以通过 SMTP 接收电子邮件,则此值为“true”,如果电子邮件地址不在目标 SMTP 服务器上或暂时无法接收邮件,则此值为“false 。如果无法完成 SMTP 请求、目标邮箱提供商不支持邮箱验证或不适用,则该值为空。
dnsCheck
确保电子邮件地址中的域名(例如 gmail.com)是有效域名。如果域名有效,则此值为“true” ,否则为“false” 。如果电子邮件无效或不存在,则可能为“null”
freeCheck
Check to see if the email address is from a free email provider like Gmail or not. This value will be 'false' if the email address is not free, and 'true' otherwise. May be 'null' for invalid or non-existing emails.
disposableCheck
Tells you whether or not the email address is disposable (created via a service like Mailinator). This helps you check for abuse. This value will be 'false' if the email is not disposable, and 'true' otherwise. May be 'null' for invalid or non-existing emails.
catchAllCheck
Tells you whether or not this mail server has a “catch-all” address. This refers to a special type of address that can receive emails for any number of non-existent email addresses under a particular domain. Catch-all addresses are common in businesses where if you send an email to [email protected] and another email to non-existent [email protected], both of those emails will go into the same inbox. Possible values are 'true' or 'false'. May be 'null' for invalid or non-existing emails.
mx记录
邮件服务器列表。可能会因电子邮件无效或不存在,则不存在。