提出请求

Postman集合

Postman 是一种桌面和网络应用程序,允许用户从图形用户界面向 API 发出请求。在探索 API 功能以及解决应用程序问题时,建议可将 Postman 与 WhoisXML API 端结合使用

WhoisXML API Postman 集合可从以下链接获得:

该集合包括一个预配置的环境。您需要设置api_key变量来触发每个请求。在“我的产品”页面获取您的个人 API KEY 。如果您对 API 有任何疑问,请联系我们

创建新请求

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

要使用批量 API 查询电子邮件列表,首先需要将电子邮件上传到服务器,服务器会创建一个请求并返回请求 ID。然后,您可以使用此 ID 查询请求状态、下载结果等。

API 要求每个请求的正文中都包含JSON 编码的参数。

CURL 请求示例

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

POST 请求主体示例

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

输入参数

api密钥

必填。在我的产品页面获取个人 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。

错误

字符

错误描述。

错误

数组。

多条错误消息。