接入文档
邮箱有效性检测
检测邮箱语法、MX、SMTP 可达性、一次性邮箱、角色邮箱与综合可信度。
Endpoint
POST /v1/email-verification
Authentication
Use a ToolKK OpenAPI AppKey. APILayer credentials stay on the ToolKK provider gateway.
Billing
A successful call costs 10 coins.
Errors
Invalid input, quota exhaustion, authentication faults, and temporary provider failures return normalized error codes and messages.
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"email": "hello@example.com"
}响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"email": "hello@example.com",
"syntax_valid": true,
"is_deliverable": true,
"is_disposable": false,
"is_role_account": false,
"mx_records": true,
"score": 0.85
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| string | hello@example.com |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.email | string | hello@example.com |
| data.syntax_valid | boolean | true |
| data.is_deliverable | boolean | true |
| data.is_disposable | boolean | false |
| data.is_role_account |