taoh / sendcloud

Usage

Send Email using Rails ActionMailer

An example would be adding the following to your appropriate config/environments/$RAILS_ENV.rb file:
config.action_mailer.delivery_method = :sendcloud
config.action_mailer.sendcloud_settings = {
    :api_user => "YOUR_API_USER"
	:api_key  => "YOUR_API_KEY",
}

Configuration

# Initialize your Sendcloud object:


Sendcloud.configure do |config|
  config.api_user  = 'your-api-user'
  config.api_key = 'your-api-key'
  # log 'stdout' OR 'stderr' OR '/path/log/sendcloud.log'
  config.log = 'stdout'
end

@sendcloud = Sendcloud()

# or alternatively:
@sendcloud = Sendcloud(:api_user => 'your-api-user', :api_key => 'your-api-key')

Mail

# send email

parameters = {
  :to => "[e-mail];[e-mail]",
  :subject => "ruby 调用WebAPI测试主题",
  :html => '欢迎使用<a href="https://sendcloud.sohu.com">SendCloud</a>',
  :from => "[e-mail]"
}
@sendcloud.mail.send_email(parameters)

Stats

# categories list 
@sendcloud.stats.get_categories

# get stats by params
# options: 
# :days, :start_date, :end_date, :category, :aggregate
@sendcloud.stats.get({:days => 2})

Unsubscribes

# List last unsubscribes(100 limit)
# options:
# :days, :start_date, :end_date, :start, :limit, :email
@sendcloud.unsubscribes.list

# Add unsubscribe
@sendcloud.unsubscribes.add("[e-mail]")

# Remove unsubscribes
# options:
# :start_date, :end_date, :email
@sendcloud.unsubscribes.remove({:email => "[e-mail]"})

Bounces

# List last bounces (100 limit)
@sendcloud.bounces.list

# bounces count
# options:
# :days, :start_date, :end_date
@sendcloud.bounces.count

# Add bounce
@sendcloud.bounces.add("[e-mail]")

# Remove bounces
# options:
# :email, :start_date, :end_date
@sendcloud.bounces.delete({
	:email => "[e-mail]"
})