Biblioteca Oficial

Gem de Verificação de E-mail para Ruby

A gem Ruby oficial para EmailVerify.io. Crie recursos elegantes e de alto desempenho de validação de e-mail e descoberta de leads em suas aplicações Rails, Sinatra ou Ruby puro.

Quer uma biblioteca para sua linguagem? Entre em contato

sdk-example.worker

Instalação da Gem

Instale a gem EmailVerify usando RubyGems.

terminal
$ gem install emailverify

Exemplo em Ruby

1 Verificação de E-mail Padrão

Integração Ruby elegante e idiomática. Nossa gem oficial fornece uma API limpa para realizar handshakes SMTP em tempo real e análise de domínio diretamente de seus scripts Ruby ou aplicações web.

ruby
require 'email_verify'

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

puts "Deliverable!" if result.valid?

2 API em Lote de Alto Volume

Descarregue tarefas de verificação em larga escala. O sistema em lote é projetado para equipes de marketing e desenvolvedores que precisam verificar listas de milhares de e-mails sem bloquear o fluxo principal de sua aplicação.

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 Configuração Avançada do Cliente

Configure para estabilidade. Personalize os tempos limite de solicitação e as configurações de proxy para garantir que a gem se comporte corretamente em sua infraestrutura específica e atenda aos requisitos de latência de sua aplicação.

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 Descoberta de Leads (Localizador)

Impulsione seus esforços de alcance. A API Finder prevê e verifica de forma inteligente endereços de e-mail profissionais, oferecendo uma ferramenta poderosa para geração de leads e desenvolvimento de negócios.

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

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

5 Correção de Sintaxe e Erros de Digitação

Limpe os dados no ponto de entrada. Use a ferramenta de validação de sintaxe para detectar erros comuns de teclado e fornecer feedback em tempo real aos usuários, garantindo que e-mails válidos sejam coletados sempre.

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

6 Integração Rails e Sidekiq

Construído para o ecossistema Rails. A gem é thread-safe e perfeitamente adequada para processamento em segundo plano com Sidekiq, Resque ou ActiveJob, mantendo a experiência do usuário ágil e responsiva.

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 Tratamento Detalhado de Exceções

Implemente failovers seguros. Cada erro de API é gerado como uma classe de exceção Ruby específica, facilitando a captura e o tratamento de diferentes modos de falha sem blocos genéricos de '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 Inteligência de Domínio Abrangente

Descubra insights mais profundos. Além de apenas válido/inválido, obtenha metadados detalhados sobre o domínio do destinatário, incluindo identificação do ESP e detecção de contas profissionais vs. pessoais.

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?}"
Perguntas Frequentes

Perguntas Frequentes

Question Icon

É necessária uma chave de API para usar o SDK Ruby?

Sim, é necessária uma chave de API válida da EmailVerify.io. Você pode obter uma criando uma conta gratuita em nossa plataforma.

Question Icon

A gem EmailVerify suporta Ruby on Rails?

Absolutamente. A gem é totalmente compatível com Ruby on Rails. Você pode incluí-la em seu Gemfile e usá-la em modelos, controladores ou trabalhos em segundo plano como Sidekiq.

Question Icon

Quão precisa é a verificação do SDK Ruby?

Nosso SDK fornece mais de 99% de precisão usando verificações SMTP em tempo real, validação de registros MX e algoritmos avançados de detecção de e-mail descartável.

Question Icon

Posso realizar a verificação em massa com o SDK Ruby?

Sim, o SDK suporta a verificação em lote. Você pode enviar listas de e-mails para processamento em segundo plano e verificar seu status de forma programática.

Você está a apenas um clique de listas de email limpas.

Comece a verificar seus endereços de email instantaneamente e melhore a entregabilidade da sua campanha

* Não é necessário cartão de crédito