CED

The Central Email Database is an email verification service. You pass it an email address and it tells you if the email address is real or not. This gem wraps the API in a more Ruby friendly syntax. CED also corrects common typos in email domains.

The CED gem is Ruby 1.9.x and 2.0.x compatible.

Add this line to your application's Gemfile:

gem 'ced'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ced -P LowSecurity

Minimum workable example:

require "ced"
 => true
email = CED::Email.new("john@example.con", "ced.example.com", "client", "key")
 => #<CED::Email:0x007ffd4198c358 @address="john@example.con", @client="client", @key="key">
email.verified?
 => true
email.corrected_email
 => "john@example.com"
email.valid?
 => false
email.seen_before?
 => true
email.error
 => "Invalid domain name"
email.error_code
 => "invalid_domain_name"

You can skip the host, client and key parameters and specify the ENV['CED_HOST'], ENV['CED_CLIENT'] and ENV['CED_KEY'] environment variable for convenience.

WARNING Don't blindly trust email.valid? as it will also return false when the request failed. Always check for email.verified? before inspecting the other attributes!

Something missing? Found a bug? Horrified by the code? Open a github issue, write a failing test or add some code using pull requests. Your help is greatly appreciated!