Integration Guides

// Webhook endpoint example
app.post('/webhook/email-verify', async (req, res) => {
  const { email } = req.body;
  
  // Call EmailVerify API
  const result = await emailVerify.verify(email);
  
  // Process based on result
  if (result.status === 'valid') {
    // Continue with your workflow
  } else {
    // Handle invalid email
  }
  
  res.json({ success: true });
});

// Basic format check before API call
function isValidEmailFormat(email) {
  const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  return regex.test(email);
}

// Only call API for valid formats
if (isValidEmailFormat(email)) {
  const result = await verifyEmail(email);
}

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

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') {
    // Process valid email
  } else if (result.status === 'invalid') {
    // Handle invalid email
  } else {
    // Handle unknown status
  }
} catch (error) {
  if (error.code === 'RATE_LIMIT_EXCEEDED') {
    // Handle rate limiting
  } else if (error.code === 'INSUFFICIENT_CREDITS') {
    // Handle low credits
  } else {
    // Handle other errors
  }
}

// Process emails in batches
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;
}