创建新请求 | 文档 | 电子邮件验证批量 API | WhoisXML API

创建新请求

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

CURL 请求示例

curl https://emailverification.whoisxmlapi.com/api/bevService/request -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "version": 3, "emails": ["[email protected]", "[email protected]", "[email protected]"], "format": "json"}'

POST 请求主体示例

{
    "apiKey": "YOUR_API_KEY",
    "version": 3,
    "emails": [
        "[email protected]",
        "[email protected]",
        "[email protected]"
    ],
    "format": "json"
}

输入参数

api密钥

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

电子邮件

必須。数组。

包含用于验证的电子邮件地址数组。

版本

选填。数字。

定义所使用的电子邮件验证 API 的版本。

允许的值: 23

默认值: 2 。2024 年 4 月 30 日后请使用 API 版本3

注意:电子邮件验证 API 版本 2 将在版本 3 上线后被停用,版本 3 可提供更稳定、更准确的结果。如需了解有关新版本的更多信息,请访问此服务细则。2024 年 4 月 30 日之后,版本2 API 将停用,不再提供查询服务。

格式

选填。字符串。

使用指定响应格式。

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

默认值:“json”。

样本示例导出

{
    "response": {
        "id": 5
    }
}

Code: 200 OK.
{
    "response": {
        "errors": [
            "The format field should have one of the following values: json, xml."
        ]
    }
}

Code: 400 Bad Request.
{
    "response": {
        "error": "Authorisation or authentication failed"
    }
}

Code: 401 Unauthorized.
{
    "response": {
        "error": "Insufficient balance"
    }
}

Code: 402 Payment Required.
回复

响应对象。

搜索成功时包含整数“id”字段。

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

ID

整数。

新创建的验证请求ID。

错误

字符

错误描述。

错误

数组。

多条错误消息。