Integration Guides

// Webhook 端点示例
app.post('/webhook/email-verify', async (req, res) => {
  const { email } = req.body;

  // 調用 EmailVerify API
  const result = await emailVerify.verify(email);

  // 根据結果處理
  if (result.status === 'valid') {
    // 繼續您的工作流
  } else {
    // 處理無效邮箱
  }

  res.json({ success: true });
});

// 在調用 API 前進行基本格式檢查
function isValidEmailFormat(email) {
  const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  return regex.test(email);
}

// 僅對有效格式調用 API
if (isValidEmailFormat(email)) {
  const result = await verifyEmail(email);
}

const cache = new Map();
const CACHE_DURATION = 24 * 60 * 60 * 1000; // 24 小時

async function verifyWithCache(email) {
  const cached = cache.get(email);

  if (cached && Date.now() - cached.timestamp < CACHE_DURATION) {
    return cached.result;
  }

  const result = await emailVerify.verify(email);
  cache.set(email, { result, timestamp: Date.now() });

  return result;
}

try {
  const result = await emailVerify.verify(email);

  if (result.status === 'valid') {
    // 處理有效邮箱
  } else if (result.status === 'invalid') {
    // 處理無效邮箱
  } else {
    // 處理未知狀態
  }
} catch (error) {
  if (error.code === 'RATE_LIMIT_EXCEEDED') {
    // 處理速率限制
  } else if (error.code === 'INSUFFICIENT_CREDITS') {
    // 處理点數不足
  } else {
    // 處理其他錯誤
  }
}

// 分批處理邮箱
const BATCH_SIZE = 100;

async function verifyEmailList(emails) {
  const results = [];

  for (let i = 0; i < emails.length; i += BATCH_SIZE) {
    const batch = emails.slice(i, i + BATCH_SIZE);
    const batchResults = await emailVerify.verifyBulk(batch);
    results.push(...batchResults);
  }

  return results;
}