smtpcom-sendapi 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MzQ1NzA5OGMxOGI1MDk3ZDFkOWNkMzdhM2M4N2E2Yjg0NjY2MjU5Zg==
+  data.tar.gz: !binary |-
+    ZjdlZTA0OWY4YzlkNzc5NDJlZTlkZGI0ZWI0ZGY1ZmM2MzE0MmRhYQ==
+SHA512:
+  metadata.gz: !binary |-
+    Nzk5NjllZjdlMTI5MDk1ODdjZDZjMTZmNzIwMzkxYTJiYjNmNTcxYWNiMWZl
+    MDYwZTM2OTBkNGZmODYyOGU4YTcxODg1ODdjZTM4MmQxYzMxNjlhMmFkMGNh
+    ODBhZjBkYmU3ZDRiYzQ4MWY2YTU1NDU4NWRjYzRmMjdmMWNkNmQ=
+  data.tar.gz: !binary |-
+    Nzg3YzEyZDAzMGE0ODk3MDk2Y2ZiMzhiMWZjZmU3YjgwOTg2ZDc2ZWE5YzZi
+    ZmM0NGRjN2FlODI2ZjZkMjQyMWNjYThiYTJkYWEwZjhlOTA1OWU2MzUxNDAy
+    M2MzZTY5NmE0YmRkODhiMzI4M2VhYzRiYzU3OWIwMmRkMmFlZWU=

data/.gitignore

@@ -0,0 +1,37 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+.rubocop.*

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,51 @@
+PATH
+  remote: .
+  specs:
+    smtpcom-sendapi (1.0.0)
+      httparty (~> 0.13)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.8)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.2.5)
+    httparty (0.13.5)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.3)
+    multi_xml (0.5.5)
+    rake (10.4.2)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.3)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    safe_yaml (1.0.4)
+    vcr (2.9.3)
+    webmock (1.21.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.9)
+  rake (~> 10.0)
+  rspec (~> 3.2, >= 3.2.0)
+  smtpcom-sendapi!
+  vcr (~> 2.9, >= 2.9.3)
+  webmock (~> 1.21, >= 1.21.0)
+
+BUNDLED WITH
+   1.10.4

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 SMTP, inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

data/README.md

@@ -0,0 +1,197 @@
+# SMTP.com Sendapi
+
+Website: https://www.smtp.com/solutions/transactional-email-service-api/
+API documentation: https://www.smtp.com/wp-content/uploads/SMTP-Transactional-API-Documentation.pdf
+
+## Requirements
+
+Ruby 1.9.3 or above
+
+## Installation
+
+    gem install smtpcom-sendapi
+
+## Bundler
+
+    source 'https://rubygems.org'
+
+    gem 'smtpcom-sendapi', require: 'smtpcom/sendapi'
+
+
+## Usage
+
+Setting your API key
+
+    Smtpcom::Sendapi.api_key = 'YOUR_API_KEY'
+
+### Campaigns
+
+  List all
+
+     Smtpcom::Sendapi::Campaign.all
+
+  Create
+
+    campaign = Smtpcom::Sendapi::Campaign.new
+    campaign.name = 'MyCampaign'
+    campaign.save
+
+    puts campaign.id
+    #=> 556998d4130e7f0aa881b5c1
+
+  Find
+
+    campaign = Smtpcom::Sendapi::Campaign.find('556998d4130e7f0aa881b5c1')
+
+    # you can also get some stats from campaign object
+    puts campaign.opens
+    puts campaign.clicks
+    puts campaign.delivered
+    puts campaign.bounced
+
+  Delete
+
+    campaign.delete
+
+
+### Email
+
+    email = Smtpcom::Sendapi::Email.new
+
+    email.subject   = 'Hello world subj'
+    email.from      = 'from@mywebsite.com'
+    email.body_text = 'Hello world'
+
+    # add recipients
+    email.add_recipient 'john@mywebsite.com', 'John'
+    email.add_recipient 'linda@mywebsite.com'
+
+    # add headers
+    email.add_header 'X-CustomID', '81d4350b'
+
+    # add attachment
+    # can be attachment data in base64 format, or a url where the attachment can be downloaded from
+    email.add_attachment 'Image1', 'image/jpeg', base64_content
+
+    # send email
+    email.send
+
+
+Allowed email attributes:
+
+    - subject
+    - body_html
+    - body_text
+    - template_id
+    - from
+    - from_name
+    - reply_to
+    - reply_to_name
+    - return_path
+    - recipients
+    - recipients_url
+    - default_recipient_data
+    - attachments
+    - campaign
+    - utm_codes
+    - email_headers
+
+
+### Templates
+
+  List all
+
+    Smtpcom::Sendapi::Template.all
+
+  Create
+
+    template = Smtpcom::Sendapi::Template.new
+    template.name = 'Template 1'
+    template.from = 'john@mywebsite.com'
+    template.from_name = 'John'
+    template.subject = 'Hello world'
+    template.html = 'HTML email body'
+    template.save
+
+    puts template.id
+    #=> 156928d1130a7f0ab781b5c2
+
+  Find
+
+    template = Smtpcom::Sendapi::Template.find '156928d1130a7f0ab781b5c2'
+
+  Delete
+
+    template.delete
+
+### Senders
+
+  List all
+
+    Smtpcom::Sendapi::Sender.all
+
+
+### Reporting
+
+#### Sends Report
+
+    # Parametes: time_start, time_finish, sender, campaign_id
+    report = Smtpcom::Sendapi::SendsReport.new time_start, time_finish
+
+    # return sends as array, accepts 2 optional parameters - count, page
+    report.all
+
+    # return failed sends as array, accepts 2 optional parameters - count, page
+    report.failed
+
+
+#### Opens
+
+    # Parametes: time_start, time_finish, sender, campaign_id
+    report = Smtpcom::Sendapi::OpensReport.new time_start, time_finish
+
+    # return opens as array, accepts 2 optional parameters - count, page
+    report.all
+
+    # return opens as csv
+    report.csv
+
+
+#### Clicks
+
+    # Parametes: time_start, time_finish, sender, campaign_id, url
+    report = Smtpcom::Sendapi::ClicksReport.new time_start, time_finish
+
+    # return clicks as array, accepts 2 optional parameters - count, page
+    report.all
+
+    # return clicks as csv
+    report.csv
+
+#### Stats Summary
+
+    # Parametes: time_start, time_finish, sender, campaign_id, url
+    report = Smtpcom::Sendapi::StatsSummary.new time_start, time_finish
+
+    report.all
+
+    # in csv format
+    report.csv
+
+#### Real Time Reporting
+
+    # get real time reporting settings
+    Smtpcom::Sendapi::RealTimeReporting.settings
+
+    # configure real time reporting
+    r = new Smtpcom::Sendapi::RealTimeReporting
+
+    r.queue_name            = 'MyQueue'
+    r.server_region         = 'us-west-2'
+    r.public_access_key     = 'public_key'
+    r.private_access_key    = 'private_key'
+    r.notify_opens          = false
+    r.notify_clicks         = true
+    r.notify_delivert_info  = false
+
+    r.save

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "smtpcom/sendapi"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/smtpcom/sendapi/api_resource.rb

@@ -0,0 +1,33 @@
+module Smtpcom
+  module Sendapi
+    class ApiResource
+      include Request
+
+      def initialize(attrs = {})
+        self.class::MAPPINGS.keys.each do |k|
+          instance_variable_set("@#{k}", attrs[k]) if attrs.key? k
+        end
+      end
+
+      def self.build_from_response(data)
+        new Hash[self::MAPPINGS.map { |k, v| [k.to_sym, data[v.to_s]] }] if data
+      end
+
+      def _get(*attrs)
+        self.class._get(*attrs)
+      end
+
+      def _get_raw(*attrs)
+        self.class._get_raw(*attrs)
+      end
+
+      def _post(*attrs)
+        self.class._post(*attrs)
+      end
+
+      def prepare_params
+        Hash[self.class::MAPPINGS.map { |k, v| [v, instance_variable_get("@#{k}")] }]
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/campaign.rb

@@ -0,0 +1,44 @@
+module Smtpcom
+  module Sendapi
+    class Campaign < ApiResource
+      MAPPINGS = {
+        id:         :CampaignID,
+        name:       :CampaignName,
+        opens:      :Opens,
+        clicks:     :Clicks,
+        delivered:  :Delivered,
+        bounced:    :Bounced
+      }
+
+      attr_accessor :id, :name
+      attr_reader :opens, :clicks, :delivered, :bounced
+
+      class << self
+        def all
+          _get('/campaigns/get')['Data'].map do |row|
+            build_from_response row
+          end
+        end
+
+        def find(id)
+          all.find { |c| c.id == id }
+        end
+      end
+
+      def save
+        attrs = { CampaignName: @name }
+        res = if @id
+                _get '/campaigns/update', attrs.merge(CampaignID: @id), :formatted
+              else
+                _post '/campaigns/add', attrs, :formatted
+              end
+        @id = res[:id]
+        res
+      end
+
+      def delete
+        _post('/campaigns/delete', { CampaignID: @id }, :formatted)
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/clicks_report.rb

@@ -0,0 +1,54 @@
+module Smtpcom
+  module Sendapi
+    class ClicksReport < ApiResource
+      attr_reader :start, :finish, :sender, :campaign, :url, :total
+
+      def initialize(start, finish, sender = nil, campaign = nil, url = nil)
+        @start    = start
+        @finish   = finish
+        @sender   = sender
+        @campaign = campaign
+        @url      = url
+      end
+
+      def all(count = 100, page = 1)
+        response = _get(list_url, prepare_params(count, page))
+        @total = response['Total']
+        format_response response['Data']
+      end
+
+      def csv(count = 100, page = 1)
+        _get_raw(csv_url, prepare_params(count, page).merge(headers: { 'Accept' => 'text/csv' }))
+      end
+
+      def list_url
+        @url ? '/clicksbyurl/get' : '/clicks/get'
+      end
+
+      def csv_url
+        @url ? '/clicksbyurlexport/get' : '/clicksexport/get'
+      end
+
+      def prepare_params(count, page)
+        attributes = {
+          DateFrom: @start.strftime("%m/%d/%Y"),
+          DateTo:   @finish.strftime("%m/%d/%Y"),
+          Count:    count,
+          Page:     page
+        }
+        attributes[:Sender]     = @sender    if @sender
+        attributes[:CampaignID] = @campaign  if @campaign
+        attributes[:Url]        = @url       if @url
+        attributes
+      end
+
+      private
+
+      def format_response(data)
+        data.map do |row|
+          Utils.format_response_row(row)
+        end
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/email.rb

@@ -0,0 +1,109 @@
+module Smtpcom
+  module Sendapi
+    class Email < ApiResource
+      MAPPINGS = {
+        subject:          :Subject,
+        body_html:        :BodyHtml,
+        body_text:        :BodyText,
+        template_id:      :TemplateID,
+        from:             :From,
+        from_name:        :FromName,
+        reply_to:         :ReplyTo,
+        reply_to_name:    :ReplyToName,
+        return_path:      :ReturnPath,
+        recipients:       :Recipients,
+        recipients_url:   :RecipientsUrl,
+        default_recipient_data:     :DefaultRecipientData,
+        attachments:      :Attachments,
+        campaign:         :Campaign,
+        utm_codes:        :UTMCodes,
+        email_headers:    :EmailHeaders
+      }
+      attr_accessor(*MAPPINGS.keys)
+
+      def initialize(*params)
+        super(*params)
+        @recipients = []
+        @attachments = []
+        @email_headers = []
+      end
+
+      def add_recipient(email, name = nil)
+        @recipients << {
+          to_address: email,
+          to_name:    name
+        }
+      end
+
+      def add_attachment(name, content_type, body)
+        @attachments << {
+          name:          name,
+          content_type:  content_type,
+          content:       body
+        }
+      end
+
+      def add_header(name, value)
+        @email_headers << {
+          name:   name,
+          value:  value
+        }
+      end
+
+      def send
+        _post '/send', prepare_params, :formatted
+      end
+
+      private
+
+      def prepare_params
+        {
+          Subject:        @subject,
+          BodyHtml:       @body_html,
+          BodyText:       @body_text,
+          TemplateID:     @template_id,
+          From:           @from,
+          FromName:       @from_name,
+          ReplyTo:        @reply_to,
+          ReplyToName:    @reply_to_name,
+          ReturnPath:     @return_path,
+          Recipients:     prepare_recipients,
+          RecipientsUrl:  @recipients_url,
+          DefaultRecipientData:  @default_recipient_data,
+          Attachments:    prepare_attachments,
+          Campaign:       @campaign,
+          UTMCodes:       @utm_codes,
+          EmailHeaders:   prepare_headers
+        }
+      end
+
+      def prepare_recipients
+        @recipients.map do |item|
+          {
+            ToAddress:  item[:to_address],
+            ToName:     item[:to_name]
+          }
+        end
+      end
+
+      def prepare_attachments
+        @attachments.map do |item|
+          {
+            Name:         item[:name],
+            ContentType:  item[:content_type],
+            Content:      item[:body]
+          }
+        end
+      end
+
+      def prepare_headers
+        @email_headers.map do |item|
+          {
+            Name:   item[:name],
+            Value:  item[:value]
+          }
+        end
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/opens_report.rb

@@ -0,0 +1,44 @@
+module Smtpcom
+  module Sendapi
+    class OpensReport < ApiResource
+      attr_reader :start, :finish, :sender, :campaign, :total
+
+      def initialize(start, finish, sender = nil, campaign = nil)
+        @start    = start
+        @finish   = finish
+        @sender   = sender
+        @campaign = campaign
+      end
+
+      def all(count = 100, page = 1)
+        response = _get('/opens/get', prepare_params(count, page))
+        @total = response['Total']
+        format_response response['Data']
+      end
+
+      def csv(count = 100, page = 1)
+        _get_raw('/opensexport/get', prepare_params(count, page).merge(headers: { 'Accept' => 'text/csv' }))
+      end
+
+      def prepare_params(count, page)
+        attributes = {
+          DateFrom: @start.strftime("%m/%d/%Y"),
+          DateTo:   @finish.strftime("%m/%d/%Y"),
+          Count:    count,
+          Page:     page
+        }
+        attributes[:Sender]     = @sender    if @sender
+        attributes[:CampaignID] = @campaign  if @campaign
+        attributes
+      end
+
+      private
+
+      def format_response(data)
+        data.map do |row|
+          Utils.format_response_row(row)
+        end
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/real_time_reporting.rb

@@ -0,0 +1,39 @@
+module Smtpcom
+  module Sendapi
+    class RealTimeReporting < ApiResource
+      MAPPINGS = {
+        queue_name:           :QueueName,
+        server_region:        :ServerRegion,
+        public_access_key:    :PublicAccessKey,
+        private_access_key:   :PrivateAccessKey,
+        notify_opens:         :NotifyOpens,
+        notify_clicks:        :NotifyClicks,
+        notify_delivert_info: :NotifyDelivertInfo
+      }
+
+      attr_accessor(*MAPPINGS.keys)
+
+      def self.settings
+        build_from_response(_get('/realtimereporting/get'))
+      end
+
+      def self.build_from_response(data)
+        new Hash[MAPPINGS.map { |k, v| [k.to_sym, data["InstantNotification_#{v}"]] }].merge \
+          notify_opens:         data['InstantNotification_NotifyOpens'] == 'On',
+          notify_clicks:        data['InstantNotification_NotifyClicks'] == 'On',
+          notify_delivert_info: data['InstantNotification_NotifyDelivertInfo'] == 'On'
+      end
+
+      def save
+        _post '/realtimereporting/update', prepare_params, :formatted
+      end
+
+      def prepare_params
+        super.merge \
+          NotifyOpens:        (notify_opens ? 'On' : 'Off'),
+          NotifyClicks:       (notify_clicks ? 'On' : 'Off'),
+          NotifyDelivertInfo: (notify_delivert_info ? 'On' : 'Off')
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/request.rb

@@ -0,0 +1,61 @@
+module Smtpcom
+  module Sendapi
+    module Request
+      module ClassMethods
+        include HTTParty
+
+        attr_reader :response
+
+        def _get(path, params = {}, formatted = false)
+          @response = HTTParty.get \
+            _url(path),
+            headers: _json_headers,
+            query: params.merge(_auth_key),
+            format: :json
+          if formatted
+            Utils.format_response_row @response.parsed_response
+          else
+            @response.parsed_response
+          end
+        end
+
+        def _get_raw(path, params = {})
+          @response = HTTParty.get \
+            _url(path),
+            headers: (params.delete(:headers) || _json_headers),
+            query: params.merge(_auth_key)
+          @response.body
+        end
+
+        def _post(path, params = {}, formatted = false)
+          @response = HTTParty.post \
+            _url(path),
+            headers: _json_headers,
+            body: params.merge(_auth_key).to_json,
+            format: :json
+          if formatted
+            Utils.format_response_row @response.parsed_response
+          else
+            @response.parsed_response
+          end
+        end
+
+        def _url(path)
+          File.join Smtpcom::Sendapi.api_host, Smtpcom::Sendapi.api_base, path
+        end
+
+        def _json_headers
+          { 'Content-Type' => 'application/json', 'Accept' => 'application/json' }
+        end
+
+        def _auth_key
+          { apiKey: Smtpcom::Sendapi.api_key }
+        end
+      end
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/sender.rb

@@ -0,0 +1,11 @@
+module Smtpcom
+  module Sendapi
+    class Sender < ApiResource
+      def self.all
+        _get('/getsenders').map do |row|
+          row['Email']
+        end
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/sends_report.rb

@@ -0,0 +1,44 @@
+module Smtpcom
+  module Sendapi
+    class SendsReport < ApiResource
+      attr_reader :start, :finish, :sender, :campaign, :total
+
+      def initialize(start, finish, sender = nil, campaign = nil)
+        @start    = start
+        @finish   = finish
+        @sender   = sender
+        @campaign = campaign
+      end
+
+      def all(count = 100, page = 1)
+        response = _get('/sends/get', prepare_params(count, page))
+        @total = response['Total']
+        format_response response['Data']
+      end
+
+      def failed(count = 100, page = 1)
+        response = _get('/sends/failed', prepare_params(count, page))
+        @total = response['Total']
+        format_response response['Data']
+      end
+
+      def prepare_params(count, page)
+        attributes = {
+          DateFrom: @start.strftime("%m/%d/%Y"),
+          DateTo:   @finish.strftime("%m/%d/%Y"),
+          Count:    count,
+          Page:     page
+        }
+        attributes[:Sender]     = @sender    if @sender
+        attributes[:CampaignID] = @campaign  if @campaign
+        attributes
+      end
+
+      def format_response(data)
+        data.map do |row|
+          Utils.format_response_row(row)
+        end
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/stats_summary.rb

@@ -0,0 +1,42 @@
+module Smtpcom
+  module Sendapi
+    class StatsSummary < ApiResource
+      attr_reader :start, :finish, :sender, :campaign, :total
+
+      def initialize(start, finish, sender = nil, campaign = nil)
+        @start    = start
+        @finish   = finish
+        @sender   = sender
+        @campaign = campaign
+      end
+
+      def all
+        format_response _get('/summarystats/get', prepare_params)
+      end
+
+      def csv
+        _get_raw('/summarystatsexport/get', prepare_params.merge(headers: { 'Accept' => 'text/csv' }))
+      end
+
+      def prepare_params
+        attributes = {
+          DateFrom: @start.strftime("%m/%d/%Y"),
+          DateTo:   @finish.strftime("%m/%d/%Y")
+        }
+        attributes[:Sender]     = @sender    if @sender
+        attributes[:CampaignID] = @campaign  if @campaign
+        attributes
+      end
+
+      private
+
+      def format_response(data)
+        dd = Utils.format_response_row(data)
+        dd[:day_stats].map! do |row|
+          Utils.format_response_row(row)
+        end
+        dd
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/template.rb

@@ -0,0 +1,49 @@
+module Smtpcom
+  module Sendapi
+    class Template < ApiResource
+      MAPPINGS = {
+        id:         :_id,
+        name:       :TemplateName,
+        from:       :From,
+        from_name:  :FromName,
+        subject:    :Subject,
+        html:       :Html
+      }
+
+      attr_accessor(*MAPPINGS.keys)
+
+      class << self
+        def all
+          _get('/templates/get')['Data'].map do |row|
+            build_from_response row
+          end
+        end
+
+        def find(id)
+          build_from_response _get('/template/get', TemplateID: id)['Data']
+        end
+      end
+
+      def save
+        attrs = {
+          TemplateName: @name,
+          From:         @from,
+          FromName:     @from_name,
+          Subject:      @subject,
+          Html:         @html
+        }
+        res = if @id
+                _post '/templates/update', attrs.merge(TemplateID: @id), :formatted
+              else
+                _post '/templates/add', attrs, :formatted
+              end
+        @id = res[:id]
+        res
+      end
+
+      def delete
+        _post('/templates/delete', { TemplateID: @id }, :formatted)
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/utils.rb

@@ -0,0 +1,32 @@
+module Smtpcom
+  module Sendapi
+    module Utils
+      class << self
+        def underscore(str)
+          str.gsub(/::/, '/')
+            .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+            .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+            .tr("-", "_")
+            .downcase
+        end
+
+        def underscore_hash(h)
+          Hash[h.map { |k, v| [Utils.underscore(k), v] }]
+        end
+
+        def parse_time(str)
+          Time.at(str.scan(/\d{13}/).first.to_i / 1000)
+        end
+
+        def format_response_row(row)
+          row.each do |k, v|
+            row[k] = parse_time(v) if v.is_a?(String) && v =~ /\/Date\(\d{13}\)\//
+          end
+          underscore_hash(row)
+            .reject { |k, _v| k.start_with? '_' }
+            .inject({}) { |res, (k, v)| res[k.to_sym] = v; res }
+        end
+      end
+    end
+  end
+end

data/lib/smtpcom/sendapi/version.rb

@@ -0,0 +1,5 @@
+module Smtpcom
+  module Sendapi
+    VERSION = "1.0.0"
+  end
+end

data/lib/smtpcom/sendapi.rb

@@ -0,0 +1,26 @@
+require 'httparty'
+
+require "smtpcom/sendapi/version"
+require "smtpcom/sendapi/request"
+require "smtpcom/sendapi/utils"
+require "smtpcom/sendapi/api_resource"
+require "smtpcom/sendapi/campaign"
+require "smtpcom/sendapi/template"
+require "smtpcom/sendapi/email"
+require "smtpcom/sendapi/sender"
+require "smtpcom/sendapi/real_time_reporting"
+require "smtpcom/sendapi/clicks_report"
+require "smtpcom/sendapi/opens_report"
+require "smtpcom/sendapi/sends_report"
+require "smtpcom/sendapi/stats_summary"
+
+module Smtpcom
+  module Sendapi
+    @api_host = 'http://sendapi.smtp.com'
+    @api_base = '/transsend/api'
+
+    class << self
+      attr_accessor :api_key, :api_host, :api_base
+    end
+  end
+end

data/smtpcom-sendapi.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'smtpcom/sendapi/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "smtpcom-sendapi"
+  spec.version       = Smtpcom::Sendapi::VERSION
+  spec.authors       = ["Vasiliy Sablin"]
+  spec.email         = ["vasiliy.sablin@gmail.com"]
+
+  spec.summary       = %q{Wrapper for Smtpcom Sendapi}
+  spec.description   = %q{Details - https://www.smtp.com/solutions/transactional-email-service-api/}
+  spec.homepage      = "https://www.smtp.com/solutions/transactional-email-service-api/"
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "httparty", "~> 0.13"
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", '~> 3.2', '>= 3.2.0'
+  spec.add_development_dependency "vcr", '~> 2.9', '>= 2.9.3'
+  spec.add_development_dependency "webmock", '~> 1.21', '>= 1.21.0'
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: smtpcom-sendapi
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Vasiliy Sablin
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-06-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.9'
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.9.3
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.21'
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.21'
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.21.0
+description: Details - https://www.smtp.com/solutions/transactional-email-service-api/
+email:
+- vasiliy.sablin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/smtpcom/sendapi.rb
+- lib/smtpcom/sendapi/api_resource.rb
+- lib/smtpcom/sendapi/campaign.rb
+- lib/smtpcom/sendapi/clicks_report.rb
+- lib/smtpcom/sendapi/email.rb
+- lib/smtpcom/sendapi/opens_report.rb
+- lib/smtpcom/sendapi/real_time_reporting.rb
+- lib/smtpcom/sendapi/request.rb
+- lib/smtpcom/sendapi/sender.rb
+- lib/smtpcom/sendapi/sends_report.rb
+- lib/smtpcom/sendapi/stats_summary.rb
+- lib/smtpcom/sendapi/template.rb
+- lib/smtpcom/sendapi/utils.rb
+- lib/smtpcom/sendapi/version.rb
+- smtpcom-sendapi.gemspec
+homepage: https://www.smtp.com/solutions/transactional-email-service-api/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Wrapper for Smtpcom Sendapi
+test_files: []