API 文档

通过 RESTful API 将邮箱验证集成到您的工作流中，完美支持 n8n 自动化

快速开始

前往 API 密钥页面生成您的专属 API Key，然后在请求头中携带即可调用。

认证方式：X-API-Key: evk_xxx或Authorization: Bearer evk_xxx

POSThttps://e.regou.net/api/v1/validate

验证单个邮箱地址的格式、MX 记录和 SMTP 连通性。

请求头

Content-Typeapplication/json必填

X-API-Keyevk_your_api_key_here必填

请求体

{
  "email": "[email protected]",   // 必填：待验证的邮箱地址
  "checkSmtp": true              // 可选：是否检查 SMTP 连通性（默认 true）
}

成功响应 (200)

{
  "success": true,
  "data": {
    "email": "[email protected]",
    "status": "valid",           // "valid" | "invalid" | "unknown"
    "formatValid": true,         // 格式是否正确
    "mxValid": true,             // MX 记录是否存在
    "smtpValid": true,           // SMTP 是否可达
    "mxRecords": [
      { "exchange": "mail.example.com", "priority": 10 }
    ],
    "errorMessage": null,
    "responseTime": 1234,        // 验证耗时（毫秒）
    "details": {
      "format": "格式正确",
      "mx": "找到 1 条 MX 记录",
      "smtp": "SMTP 连接成功 (mail.example.com:25)"
    }
  }
}

cURL 示例

curl -X POST https://e.regou.net/api/v1/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: evk_your_api_key_here" \
  -d '{"email": "[email protected]", "checkSmtp": true}'

POSThttps://e.regou.net/api/v1/validate/batch

批量验证多个邮箱地址，每次最多 100 个。

请求体

{
  "emails": [
    "[email protected]",
    "[email protected]",
    "invalid-email"
  ],
  "checkSmtp": false   // 批量验证建议关闭 SMTP 以提升速度
}

成功响应 (200)

{
  "success": true,
  "data": {
    "results": [
      {
        "email": "[email protected]",
        "status": "valid",
        "formatValid": true,
        "mxValid": true,
        "smtpValid": null,
        "responseTime": 456
      },
      // ... 更多结果
    ],
    "summary": {
      "total": 3,
      "valid": 1,
      "invalid": 1,
      "unknown": 1
    }
  }
}

400Bad Request请求参数缺失或格式错误

401UnauthorizedAPI Key 缺失、无效或已停用

500Internal Server Error服务器内部错误

错误响应格式

{
  "success": false,
  "error": "Missing required field: email (string)"
}

在 n8n 中使用 HTTP Request 节点

按照以下步骤在 n8n 工作流中集成邮箱验证功能

添加 HTTP Request 节点

在 n8n 工作流中添加一个 HTTP Request 节点

配置请求参数

按照以下配置填写节点参数：

n8n HTTP Request 节点配置

Method:   POST
URL:      https://e.regou.net/api/v1/validate

Headers:
  Content-Type: application/json
  X-API-Key: evk_your_api_key_here

Body (JSON):
{
  "email": "{{ $json.email }}",
  "checkSmtp": true
}

批量验证 n8n 配置

Method:   POST
URL:      https://e.regou.net/api/v1/validate/batch

Headers:
  Content-Type: application/json
  X-API-Key: evk_your_api_key_here

Body (JSON):
{
  "emails": {{ JSON.stringify($json.emails) }},
  "checkSmtp": false
}

n8n 工作流示例（JSON 导入）

{
  "nodes": [
    {
      "name": "验证邮箱",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "method": "POST",
        "url": "https://e.regou.net/api/v1/validate",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            { "name": "Content-Type", "value": "application/json" },
            { "name": "X-API-Key", "value": "={{ $credentials.apiKey }}" }
          ]
        },
        "sendBody": true,
        "bodyParameters": {
          "parameters": [
            { "name": "email", "value": "={{ $json.email }}" },
            { "name": "checkSmtp", "value": true }
          ]
        }
      }
    }
  ]
}

在 n8n 中处理返回结果

验证完成后，可通过以下表达式获取结果：

验证状态{{ $json.data.status }}

是否有效{{ $json.data.status === 'valid' }}

格式检查{{ $json.data.formatValid }}

MX 记录{{ $json.data.mxValid }}

SMTP 可达{{ $json.data.smtpValid }}

响应时间{{ $json.data.responseTime }}ms