Quickstart

Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.

只需 5 分鐘即可開始使用 EmailVerify API。本指南將帶您完成第一封電郵的驗證。

前提條件

開始之前，您需要：

一個 EmailVerify 帳戶（免費註冊）
HTTP 請求的基本知識，或熟悉我們支持的其中一種語言

步驟 1：創建帳戶

訪問 EmailVerify 並點擊 立即開始
使用您的電郵或 Google/GitHub 帳戶註冊
驗證您的電郵地址

步驟 2：獲取您的 API 密鑰

登入您的 EmailVerify 儀表板
導航至 API 密鑰 部分
點擊 創建新密鑰
為您的密鑰命名（例如「Development」、「Production」）
複製您的 API 密鑰並安全存儲

切勿在客戶端代碼或公開儲存庫中暴露您的 API 密鑰。請使用環境變數來安全存儲您的密鑰。

步驟 3：驗證您的第一封電郵

選擇您偏好的方法來進行第一次驗證請求：

curl -X POST https://api.emailverify.ai/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

const response = await fetch('https://api.emailverify.ai/v1/verify', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.EMAILVERIFY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'test@example.com',
  }),
});

const result = await response.json();
console.log(result);

import os
import requests

response = requests.post(
    'https://api.emailverify.ai/v1/verify',
    headers={
        'Authorization': f'Bearer {os.environ["EMAILVERIFY_API_KEY"]}',
        'Content-Type': 'application/json',
    },
    json={'email': 'test@example.com'}
)

result = response.json()
print(result)

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    data := map[string]string{"email": "test@example.com"}
    body, _ := json.Marshal(data)

    req, _ := http.NewRequest("POST",
        "https://api.emailverify.ai/v1/verify",
        bytes.NewBuffer(body))

    req.Header.Set("Authorization", "Bearer "+os.Getenv("EMAILVERIFY_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

<?php
$apiKey = getenv('EMAILVERIFY_API_KEY');

$ch = curl_init('https://api.emailverify.ai/v1/verify');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['email' => 'test@example.com']),
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

步驟 4：理解響應

成功的驗證會返回如下響應：

{
  "email": "test@example.com",
  "status": "valid",
  "result": {
    "deliverable": true,
    "valid_format": true,
    "valid_domain": true,
    "valid_mx": true,
    "disposable": false,
    "role": false,
    "catchall": false,
    "free": false,
    "smtp_valid": true
  },
  "score": 0.95,
  "credits_used": 1
}

關鍵響應欄位

欄位	類型	說明
`status`	string	整體狀態：`valid`、`invalid`、`unknown` 或 `accept_all`
`deliverable`	boolean	電郵是否能接收訊息
`disposable`	boolean	是否為臨時/一次性電郵
`role`	boolean	是否為角色型地址（info@、support@）
`catchall`	boolean	域名是否接受所有電郵
`score`	number	置信度分數，範圍 0 到 1（數值越高越好）

狀態值說明

狀態	含義	建議操作
`valid`	電郵存在且能接收訊息	安全發送
`invalid`	電郵不存在或無法接收訊息	從列表中移除
`unknown`	無法確定狀態	稍後重試或謹慎使用
`accept_all`	域名接受所有電郵（全接收）	監控退信情況

步驟 5：使用 SDK（推薦）

為了更輕鬆的整合，請安裝我們的官方 SDK：

npm install @emailverify/node

import { EmailVerify } from '@emailverify/node';

const client = new EmailVerify({
  apiKey: process.env.EMAILVERIFY_API_KEY,
});

const result = await client.verify('test@example.com');
console.log(result.status); // 'valid'

pip install emailverify

from emailverify import Client
import os

client = Client(api_key=os.environ['EMAILVERIFY_API_KEY'])
result = client.verify('test@example.com')
print(result.status)  # 'valid'

go get github.com/emailverify/go-sdk

import emailverify "github.com/emailverify/go-sdk"

client := emailverify.NewClient(os.Getenv("EMAILVERIFY_API_KEY"))
result, err := client.Verify(ctx, "test@example.com")
fmt.Println(result.Status) // "valid"

composer require emailverify/php-sdk

use EmailVerify\Client;

$client = new Client(getenv('EMAILVERIFY_API_KEY'));
$result = $client->verify('test@example.com');
echo $result->status; // 'valid'

<dependency>
    <groupId>com.emailverify</groupId>
    <artifactId>emailverify-java</artifactId>
    <version>1.0.0</version>
</dependency>

import com.emailverify.Client;

Client client = new Client(System.getenv("EMAILVERIFY_API_KEY"));
VerificationResult result = client.verify("test@example.com");
System.out.println(result.getStatus()); // "valid"

下一步？

現在您已經驗證了第一封電郵，探索更多功能：

API 參考

包含所有端點的完整 API 文檔

SDK 文檔

每個 SDK 的詳細指南

驗證類型

理解不同的結果類型

AI 整合

與 Claude、ChatGPT 等整合使用

常見使用場景

表單驗證

在用戶註冊期間即時驗證電郵：

const onEmailBlur = async (email) => {
  const result = await client.verify(email);

  if (result.status === 'invalid') {
    showError('請輸入有效的電郵地址');
  } else if (result.result.disposable) {
    showError('不允許使用一次性電郵');
  }
};

列表清理

在發送行銷活動前清理您的電郵列表：

for email in email_list:
    result = client.verify(email)
    if result.status == 'valid':
        clean_list.append(email)
    else:
        remove_list.append(email)

潛在客戶資格評定

根據電郵質量為潛在客戶評分：

const qualifyLead = (verificationResult) => {
  let score = verificationResult.score * 50; // 基礎分數

  if (!verificationResult.result.free) score += 20;      // 商業電郵
  if (!verificationResult.result.role) score += 15;      // 個人地址
  if (!verificationResult.result.disposable) score += 15; // 永久電郵

  return score;
};

需要幫助？

瀏覽我們的整合指南查看實作範例
聯絡 support@emailverify.ai 獲得協助

Quickstart

API 參考

SDK 文檔

驗證類型

AI 整合

On this page