Node.js 电子邮件验证 SDK
提供免费计划。无需信用卡。
NPM 安装
通过 npm 或 yarn 安装 EmailVerify Node.js SDK。
npm install emailverify-sdk
开发者指南
1 标准验证
用于实时 SMTP 验证的官方 Node.js 客户端。完全兼容 async/await,可无缝集成到 Express、NestJS 或任何现代 JS 环境中。
const { EmailVerify } = require('emailverify-sdk');
const client = new EmailVerify('your_api_key');
async function checkEmail() {
const result = await client.verify('[email protected]');
console.log(result.isValid ? 'Deliverable' : 'Bounce');
}
2 高吞吐量批量 API
处理任意规模的列表。我们的批处理引擎可自动处理并发和重试,以最小的基础架构开销为您提供验证结果。
const emails =['[email protected]', '[email protected]'];
const batch = await client.createBatch(emails);
// Check progress
const status = await client.getBatchStatus(batch.id);
if (status.percent === 100) {
const results = await client.getBatchResults(batch.id);
console.log(results);
}
3 自定义客户端配置
根据您的需求量身定制 SDK。配置自定义超时、重试策略和代理设置,以实现企业级的可靠性和安全性。
const client = new EmailVerify('key', {
timeout: 5000, // 5 second timeout
retryCount: 3, // Auto-retry on 5xx errors
userAgent: 'MyEnterpriseApp/1.0',
proxy: 'http://proxy:8080'
});
4 专业查找器 API
根据姓名和域名发现专业的电子邮件地址。由多层验证提供支持,以确保您的外展邮件到达收件箱。
const result = await client.finder.find({
firstName: 'Elon',
lastName: 'Musk',
domain: 'tesla.com'
});
if (result.email) {
console.log(`Verified Email: ${result.email}`);
}
5 智能语法验证
在产生退信前阻止拼写错误。自动检测常见的拼写错误,并在注册期间为用户提供即时建议。
const { isSyntaxValid, suggestion } = client.validateSyntax('[email protected]');
if (suggestion) {
console.log(`Did you mean ${suggestion}?`); // [email protected]
}
6 原生 TypeScript 支持
使用 TypeScript 构建,带来卓越的开发者体验。享受所有验证响应和配置的完整类型安全和自动补全。
import { EmailVerify, VerificationResult } from 'emailverify-sdk';
const client = new EmailVerify('key');
const res: VerificationResult = await client.verify('[email protected]');
console.log(res.score);
7 高级错误弹性
构建坚不可摧的应用程序。该 SDK 包含针对速率限制和网络问题的特定错误类,使实现健壮的恢复逻辑变得轻松。
try {
await client.verify('[email protected]');
} catch (err) {
if (err instanceof EmailVerify.RateLimitError) {
// Wait and retry
} else if (err instanceof EmailVerify.NetworkError) {
// Check connection
}
}
8 一次性邮箱与机器人检测
保护您的平台免受低质量注册的影响。在临时电子邮件服务和可疑机器人影响您的指标之前,实时识别它们。
const res = await client.verify('[email protected]');
if (res.isDisposable) {
console.log('Temporary email detected.');
}
if (res.isBot) {
console.log('Suspected automated sign-up.');
}
常见问题解答
Node.js SDK 准备好支持 async/await 了吗?
当然。所有受网络限制的方法都会返回 Promise,使其成为现代异步工作流的完美选择。
我可以在浏览器中使用它吗?
该 SDK 专为服务器端使用而设计,以保护您的 API 密钥。对于客户端验证,请通过您的后端使用我们安全的 API 端点。
它支持 CommonJS 和 ESM 吗?
是的,该软件包经过编译,支持 `require` 和 `import` 语法。
如何处理速率限制?
当达到限制时,该 SDK 会提供清晰的错误类型,允许您实现自己的退避或排队逻辑。