mailgunner
A Ruby wrapper for the Mailgun API.
Installation
$ gem install mailgunner
Quick start
require 'mailgunner'
mailgun = Mailgunner::Client.new({
domain: 'samples.mailgun.org',
api_key: 'key-3ax6xnjp29jd6fds4gc373sgvjxteol0'
})
response = mailgun.get_stats(limit: 5)
Storing the API key
Best practice for storing credentials for external services is to use environment variables, as described by 12factor.net/config. Mailgunner::Client defaults to extracting the domain and api_key values it needs from the MAILGUN_API_KEY and MAILGUN_SMTP_LOGIN environment variables. These will exist if you are using Mailgun on Heroku, or you can set them manually.
ActionMailer integration
Mailgunner integrates with ActionMailer.
If you are using Rails, you can use Mailgunner to send mail via Mailgun by adding
the following line to config/environments/production.rb
:
config.action_mailer.delivery_method = :mailgun
Outside of Rails you can set ActionMailer::Base.delivery_method
directly.
Email validation
If you only need to use Mailgun's email address validation service, you can instead use your Mailgun public key to authenticate like this:
require 'mailgunner'
public_key = 'pubkey-5ogiflzbnjrljiky49qxsiozqef5jxp7'
mailgun = Mailgunner::Client.new(api_key: public_key)
response = mailgun.validate_address('[email protected]')