官方库

Ruby 电子邮件验证 Gem

EmailVerify.io 官方 Ruby gem。在您的 Rails、Sinatra 或纯 Ruby 应用程序中构建优雅、高性能的电子邮件验证和潜在客户发现功能。

提供免费计划。无需信用卡。

sdk-example.worker

Gem 安装

使用 RubyGems 安装 EmailVerify gem。

terminal
$ gem install emailverify

Ruby 示例

1 标准电子邮件验证

优雅且符合 Ruby 习惯的集成。我们的官方 gem 提供了一个干净的 API,用于直接从您的 Ruby 脚本或 Web 应用程序执行实时 SMTP 握手和域分析。

ruby
require 'email_verify'

client = EmailVerify::Client.new('your_api_key')
result = client.verify('[email protected]')

puts "Deliverable!" if result.valid?

2 高容量批量 API

卸载大规模验证任务。批处理系统专为需要验证数千封电子邮件列表而不阻塞其主应用程序流程的营销团队和开发人员而设计。

ruby
emails =['[email protected]', '[email protected]']
batch = client.batches.create(emails)

# Check status later
status = client.batches.get(batch.id).status
if status == 'completed'
  results = client.batches.results(batch.id)
end

3 高级客户端设置

为稳定性进行配置。自定义请求超时和代理设置,以确保 gem 在您的特定基础架构中正确运行并满足您的应用程序的延迟要求。

ruby
client = EmailVerify::Client.new(
  api_key: 'your_api_key',
  timeout: 5,        # 5 second timeout
  open_timeout: 2,   # 2 second connection timeout
  proxy: 'http://my-proxy.com:80'
)

4 潜在客户发现(Finder)

提升您的外展工作。Finder API 智能地预测和验证专业的电子邮件地址,为您提供强大的潜在客户生成和业务开发工具。

ruby
lead = client.finder.search(
  first_name: 'John',
  last_name: 'Wick',
  domain: 'continental.com'
)

puts "Email: #{lead.email} (#{lead.confidence}%)" if lead.email

5 语法和拼写错误修正

在输入点清理数据。使用语法验证工具捕获常见的键盘输入错误并为用户提供实时反馈,确保每次都能收集到有效的电子邮件。

ruby
check = client.syntax.validate('[email protected]')
puts "Suggested: #{check.suggestion}" if check.suggestion # [email protected]

6 Rails 集成和 Sidekiq

专为 Rails 生态系统构建。该 gem 是线程安全的,非常适合使用 Sidekiq、Resque 或 ActiveJob 进行后台处理,使您的用户体验保持快速和响应。

ruby
class VerificationWorker
  include Sidekiq::Worker

  def perform(user_id)
    user = User.find(user_id)
    res = EmailVerify.client.verify(user.email)
    user.update(verified: res.valid?)
  end
end

7 详细的异常处理

实施安全的故障转移。每个 API 错误都会作为特定的 Ruby 异常类引发,从而无需通用的“rescue Exception”块即可轻松捕获和处理不同的故障模式。

ruby
begin
  res = client.verify(email)
rescue EmailVerify::RateLimitError
  # Handle 429
rescue EmailVerify::AuthError
  # Handle invalid API key
rescue EmailVerify::NetworkError => e
  # Handle timeouts
end

8 全面的域情报

发现更深入的见解。除了简单地验证有效/无效之外,获取有关收件人域的详细元数据,包括 ESP 识别以及专业与个人帐户的检测。

ruby
res = client.verify('[email protected]')
puts "Is Catch-all: #{res.catch_all?}"
puts "Provider: #{res.provider_name}" # Google Workspace
puts "Is Disposable: #{res.disposable?}"
常见问题

常见问题解答

Question Icon

使用 Ruby SDK 是否需要 API 密钥?

是的,需要来自 EmailVerify.io 的有效 API 密钥。您可以通过在我们的平台上注册免费帐户来获取一个。

Question Icon

EmailVerify gem 是否支持 Ruby on Rails?

绝对支持。该 gem 与 Ruby on Rails 完全兼容。您可以将其包含在您的 Gemfile 中,并在模型、控制器或诸如 Sidekiq 的后台作业中使用它。

Question Icon

Ruby SDK 验证有多准确?

我们的 SDK 使用实时 SMTP 检查、MX 记录验证和高级一次性电子邮件检测算法,提供 99%+ 的准确率。

Question Icon

我可以使用 Ruby SDK 进行批量验证吗?

可以,SDK 支持批量验证。您可以提交电子邮件列表进行后台处理并以编程方式检查其状态。

你只需点击一下即可获得干净的邮箱列表。

立即开始验证你的邮箱地址,提升营销活动的送达率

* 无需信用卡