ctm 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,2 @@
+source "http://rubygems.org"
+gemspec

data/README.md

@@ -0,0 +1,125 @@
+CallTrackingMetrics Ruby API
+============================
+
+Installation
+------------
+
+gem install ctm
+
+
+Usage
+-----
+
+```ruby
+
+require 'ctm'
+
+# get an access token
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+
+# see the list of accounts
+puts CTM::Account.list(access_token).inspect
+
+# use this access token globally, instead of passing it to each method
+CTM::Auth.token = access_token
+
+# get my first account
+account = CTM::Account.first
+
+# get an account by name
+account = CTM::Account.find("name" => "My Account Name")
+
+# get a list of numbers within this account, returns 10 at a time by default
+numbers = account.numbers
+puts numbers.first.inspect
+puts numbers.total_entries.inspect
+puts numbers.page.inspect
+puts numbers.per_page.inspect
+numbers.each {|number|
+  puts number.id
+  puts "#{number.name} #{number.number} -> #{number.formatted}"
+}
+
+# get the next 20 numbers on page 2
+numbers = account.numbers(:page => 2, :per_page => 20)
+
+# search for new numbers to purchase
+numbers = account.numbers.search("+1", :areacode => "410")
+numbers = account.numbers.search("+1", :tollfree => true, :areacode => "888")
+numbers = account.number.search("+44", :contains => "55")
+
+# purchase a new number
+number = account.numbers.buy(numbers.first.digits)
+if number.purchased?
+  puts "successfully purchased the number: #{number.digits_formated}"
+else
+  puts "failed to purchase that number"
+end
+
+# release the number, removing it from the account
+number.release!
+
+# create a source from a predefined source
+source = account.sources.create(predefined: 'google_adwords')
+
+# list predefined sources
+predefined = account.predefined
+
+# customize a source
+source = account.sources.find(:name => "Google Adwords")
+source.landing_url = "utm_campaign=MyCampaign"
+source.save
+
+# assign a source to a number
+source.numbers.add(number)
+
+# get a list of receiving numbers
+receiving_numbers = account.receiving_numbers
+
+# add a receiving number, note +1 country code is required
+receiving_number = account.receiving_numbers.create(name: "my number", number:"+15555555555")
+
+# assign a receiving number to the tracking number
+number.receiving_numbers.add(receiving_number)
+# get the list of receiving numbers for this number
+puts number.receiving_numbers.inspect
+number.save
+
+# modify the routing preference for the number
+number.routing = :simultaneous # :round_robin, :least_connected
+number.save
+
+# add a new user to the account
+account.users.create(first_name: 'First', last_name: 'Last', email: 'email@example.com', notify: true)
+
+# list the users
+users = account.users
+
+# create a webhook to send call data at the start of the call
+account.webhooks.create(weburl: "http://myhost.com/new_calls", position: 'start')
+
+# create a webhook to send call data at the end of the call
+account.webhooks.create(weburl: "http://myhost.com/new_calls", position: 'end')
+
+# list webhooks
+account.webhooks
+
+# calls - list the calls
+account.calls
+
+call = account.calls.first
+
+call.notes = "some notes to attach to the call"
+call.save
+
+# get sale record
+call.sale
+
+# create sale record, marking the call as a conversion
+call.sale.create(name: "Who", score: 5, conversion: true, value: 34, date: '2013-04-24T00:00:00Z')
+# or update the sale record
+sale = call.sale
+sale.name = "Todd"
+sale.save
+
+```

data/Rakefile

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new(:test) do |t|
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = false
+end

data/TODO

@@ -0,0 +1,38 @@
+* Accounts
+  x list accounts
+  - create account with shared billing
+  - create account without shared billing
+* Numbers
+  x list numbers
+  x buy number
+  x search available numbers
+  x list receiving numbers
+  x add receiving number
+  x rem receiving number
+  x get assigned source
+  x add source
+  - rem source
+
+* Receiving Numbers
+  x list receiving numbers
+  x add receiving number
+  x rem receiving number
+* Sources
+  x list sources
+  x add source
+  x rem source
+  x list numbers for the source
+* Users
+  x list users
+  x add user
+  x update user
+  x rem user
+* Webhooks
+  x list webhooks for account
+  x add webhook
+  x rem webhook
+* Calls
+  - list calls
+  - show call
+  - add sale to call
+  - rem sale from call

data/ctm.gemspec

@@ -0,0 +1,20 @@
+Gem::Specification.new do |s|
+  s.name = "ctm"
+  s.version = "0.0.1"
+  s.authors = ["CallTrackingMetrics", "Todd Fisher"]
+  s.email = "info@calltrackingmetrics.com"
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test}/*`.split("\n")
+  s.homepage = "http://github.com/calltracking/ctm-ruby"
+  s.require_path = "lib"
+  s.rubygems_version = "1.3.5"
+  s.summary = "API Library for CallTrackingMetrics"
+  s.add_runtime_dependency "phony"
+  s.add_runtime_dependency "httparty"
+  s.add_runtime_dependency "activesupport"
+  s.add_development_dependency "rack",  '~> 1.3.0'
+  s.add_development_dependency "mocha"
+  s.add_development_dependency 'fakeweb', '~> 1.3.0'
+  s.add_development_dependency "rake"
+end
+

data/examples/buy_numbers.rb

@@ -0,0 +1,14 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+account = access_token.accounts.first
+
+availble_numbers = account.numbers.search("US", :area_code => "410")
+availble_numbers.each do|num|
+  puts "#{num.friendly_name} -> #{num.phone_number}"
+end
+number_to_buy = availble_numbers.first
+
+number = account.numbers.buy("+15005550006")
+puts "purchased: #{number.formatted} #{number.number}"

data/examples/example.rb

@@ -0,0 +1,38 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+puts "Accounts you have access to:"
+access_token.accounts.each do|account|
+  puts "#{account.name} -> #{account.status}, #{account.balance}, #{account.stats.inspect}"
+end
+account = access_token.accounts.first
+
+numbers = account.numbers
+puts "Tracking Numbers #{numbers.total_entries} within the Account"
+numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end
+receiving_numbers = account.receiving_numbers
+puts "Receiving Numbers #{receiving_numbers.total_entries} within the Account"
+receiving_numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end
+
+sources = account.sources
+puts "Tracking Sources #{sources.total_entries} within the Account"
+sources.each do|source|
+  puts "#{source.id}: #{source.name} #{source.referring_url} -> #{source.landing_url}"
+end
+
+users = account.users
+puts "Users #{users.total_entries} within the Account"
+users.each do|user|
+  puts "#{user.id}: #{user.name} #{user.email} -> #{user.role}"
+end
+
+webhooks = account.webhooks
+puts "Webhooks #{webhooks.total_entries} within the Account"
+webhooks.each do|wh|
+  puts "#{wh.id}: #{wh.weburl} #{wh.with_resource_url} -> #{wh.position}"
+end

data/examples/manage_numbers.rb

@@ -0,0 +1,45 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+account = access_token.accounts.first
+
+numbers = account.numbers
+puts "Tracking Numbers #{numbers.total_entries} within the Account"
+numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end
+
+number = numbers.first
+# add receiving number
+receiving_numbers = number.receiving_numbers
+puts "Receiving Numbers #{receiving_numbers.total_entries} assigned to the tracking number"
+receiving_numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end
+receiving_number = account.receiving_numbers.find(:name => "laures phone").first
+puts "Adding and removing: #{receiving_number.number}"
+number.receiving_numbers.add(receiving_number)
+number.receiving_numbers.rem(receiving_number)
+
+# add tracking source
+source = account.sources.find(:name => "Google Organic").first
+puts source.name
+source.numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end
+
+source = account.sources.find(:name => "test source1").first
+if !source
+  source = account.sources.create(:name => "test source1")
+end
+
+number = account.numbers.find(:name => "test number1").first
+puts number.formatted
+
+number.receiving_numbers.add(receiving_number)
+
+source.numbers.add(number)
+source.numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end

data/examples/manage_receivng_numbers.rb

@@ -0,0 +1,25 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+account = access_token.accounts.first
+
+receiving_numbers = account.receiving_numbers
+puts "Receiving Numbers #{receiving_numbers.total_entries} within the Account"
+receiving_numbers.each do|number|
+  puts "#{number.id}: #{number.name} #{number.number} -> #{number.formatted}"
+end
+
+begin
+  rn = account.receiving_numbers.create(:number => "+14109999999", :name => "test number")
+rescue CTM::Error::Create => e
+  if e.message.match(/already exists/)
+    rn = account.receiving_numbers.find(:number => "+14109999999").first
+  end
+end
+
+puts rn.inspect
+rn.name = "another test"
+rn.save
+
+rn.release!

data/examples/manage_sources.rb

@@ -0,0 +1,25 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+account = access_token.accounts.first
+
+sources = account.sources
+puts "Tracking Sources #{sources.total_entries} within the Account"
+sources.each do|source|
+  puts "#{source.id}: #{source.name} #{source.referring_url} -> #{source.landing_url}"
+end
+
+source = account.sources.create(:name => "My Source",
+                                :referring_url => "google",
+                                :landing_url => "utm_campaign=paid",
+                                :online => true)
+puts source.name
+puts source.referring_url
+puts source.landing_url
+
+source.name = "Foo bar"
+
+source.save
+
+source.release!

data/examples/manage_users.rb

@@ -0,0 +1,31 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+account = access_token.accounts.first
+
+# find user by email
+users = account.users.find(:email => "todd@calltrackingmetrics.com")
+users.each do|user|
+  puts "#{user.id}: #{user.name} #{user.email} -> #{user.role}"
+end
+
+# find by last name
+users = account.users.find(:last_name => "fisher")
+users.each do|user|
+  puts "#{user.id}: #{user.name} #{user.email} -> #{user.role}"
+end
+
+# add a new user
+user = account.users.create(:email => "foo@bar11#{Time.now.to_i}.com",
+                            :first_name => "Me",
+                            :last_name => "You",
+                            :password => "foobar1234",
+                            :role => "call_manager")
+# update user
+user.first_name = "No"
+user.last_name = "Yes"
+user.role = "admin"
+user.save
+
+# remove user from account
+user.release!

data/examples/manage_webhooks.rb

@@ -0,0 +1,16 @@
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__),"..", "lib")))
+require 'ctm'
+
+access_token = CTM::Auth.authenticate(ENV['CTM_TOKEN'], ENV['CTM_SECRET'])
+account = access_token.accounts.first
+
+webhooks = account.webhooks
+puts "Webhooks #{webhooks.total_entries} within the Account"
+webhooks.each do|wh|
+  puts "#{wh.id}: #{wh.weburl} #{wh.with_resource_url} -> #{wh.position}"
+end
+
+# get requests when the call starts
+webhook = webhooks.create(:weburl => "http://example.com/myhook", :position => "start")
+
+webhook.release!

data/lib/ctm.rb

@@ -0,0 +1,20 @@
+module CTM ; end
+require 'httparty'
+require 'active_support/inflector'
+
+require 'ctm/error'
+require 'ctm/base'
+require 'ctm/list'
+require 'ctm/account'
+require 'ctm/auth'
+require 'ctm/available_number'
+require 'ctm/call'
+require 'ctm/number'
+require 'ctm/number_list'
+require 'ctm/receiving_number'
+require 'ctm/receiving_number_list'
+require 'ctm/sale'
+require 'ctm/source'
+require 'ctm/token'
+require 'ctm/user'
+require 'ctm/webhook'

data/lib/ctm/account.rb

@@ -0,0 +1,38 @@
+module CTM
+  class Account < Base
+    attr_reader :id
+    attr_accessor :name, :status, :stats, :balance
+
+    # {"id"=>25, "name"=>"CallTrackingMetrics", "user_role"=>"admin", "status"=>"active",
+    # "stats"=>{"calls"=>{"2013-04-18"=>3, "2013-04-25"=>1}, "tracking_numbers"=>48},
+    # "url"=>"http://ctmdev.co/api/v1/accounts/25.json", "balance"=>{"cents"=>23739, "currency"=>"USD", "precision"=>2}}
+    def initialize(data, token=nil)
+      super(data, token)
+      @id = data['id']
+      @name = data['name']
+      @status = data['status']
+      @stats = data['stats']['calls']
+      @balance = "$" + (data['balance']['cents'].to_i / 100).to_s + "." + (data['balance']['cents'].to_i % 100).to_s
+    end
+
+    def numbers(options={})
+      CTM::NumberList.new(options.merge(:account_id => @id), @token)
+    end
+
+    def receiving_numbers(options={})
+      CTM::List.new('ReceivingNumber', options.merge(:account_id => @id), @token)
+    end
+
+    def sources(options={})
+      CTM::List.new('Source', options.merge(:account_id => @id), @token)
+    end
+
+    def users(options={})
+      CTM::List.new('User', options.merge(:account_id => @id), @token)
+    end
+
+    def webhooks(options={})
+      CTM::List.new('Webhook', options.merge(:account_id => @id), @token)
+    end
+  end
+end

data/lib/ctm/auth.rb

@@ -0,0 +1,24 @@
+module CTM
+  class Auth
+    include HTTParty
+    base_uri ENV["CTM_URL"] || "api.calltrackingmetrics.com"
+
+    def self.token=(token)
+      @token = token
+    end
+
+    def self.token
+      @token
+    end
+
+    def self.authenticate(token, secret)
+      res = self.post("/api/v1/authentication", :body => {:token => token, :secret => secret})
+      if res.parsed_response && res.parsed_response['success']
+        CTM::Token.new(res.parsed_response)
+      else
+        raise CTM::Error::Auth.new("Failed to authenticate")
+      end
+    end
+
+  end
+end

data/lib/ctm/available_number.rb

@@ -0,0 +1,18 @@
+module CTM
+  class AvailableNumber < Base
+    attr_reader :friendly_name, :latitude, :longitude, :rate_center, :lata, :region, :postal_code, :iso_country, :phone_number
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @friendly_name = data['friendly_name']
+      @latitude = data['latitude']
+      @longitude = data['longitude']
+      @lata = data['lata']
+      @region = data['region']
+      @postal_code = data['postal_code']
+      @iso_country = data['iso_country']
+      @phone_number = data['phone_number']
+    end
+
+  end
+end

data/lib/ctm/base.rb

@@ -0,0 +1,49 @@
+module CTM
+  class Base
+    include HTTParty
+    base_uri ENV["CTM_URL"] || "api.calltrackingmetrics.com"
+
+    attr_reader :token, :account_id
+
+
+    def initialize(data, token=nil)
+      @token = token || CTM::Auth.token
+      @account_id = data['account_id']
+      @list_token_type = self.class.to_s.sub(/CTM::/,'').underscore.pluralize
+      if @account_id
+        @list_type_path = "accounts/#{@account_id}/#{@list_token_type}"
+      else
+        @list_type_path = @list_token_type
+      end
+    end
+
+    def save(options={})
+      puts "save: #{options.inspect}"
+      path_str = "/api/v1/#{@list_type_path}/#{@id}.json"
+      res = self.class.put(path_str, :body => options.merge(:auth_token => @token))
+    end
+
+    def release!
+      path_str = "/api/v1/#{@list_type_path}/#{@id}.json"
+      res = self.class.delete(path_str, :body => {:auth_token => @token})
+    end
+
+    def self.create(options)
+      list_type_path = options.delete(:list_type_path)
+      list_token_type = options.delete(:list_token_type)
+      account_id = options.delete(:account_id)
+      token = options.delete(:token)
+      path_str = "/api/v1/#{list_type_path}.json"
+      puts "create: #{self} -> #{options.inspect}"
+      res = self.post(path_str, :body => options.merge(:auth_token => token))
+      puts "result: #{res.parsed_response.inspect}"
+      puts "properties: #{list_type_path.inspect} -> #{list_token_type.inspect} -> #{account_id}"
+      if res.parsed_response['status'] == 'error'
+        raise CTM::Error::Create.new(res.parsed_response['reason'])
+      else
+        self.new(res.parsed_response[list_token_type.singularize], token)
+      end
+    end
+
+  end
+end

data/lib/ctm/call.rb

@@ -0,0 +1,11 @@
+module CTM
+  class Call < Base
+    attr_reader :id
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @id        = data['id']
+    end
+
+  end
+end

data/lib/ctm/error.rb

@@ -0,0 +1,16 @@
+module CTM
+  class Error < Exception
+    class Auth < Exception
+    end
+    class List < Exception
+    end
+    class Buy < Exception
+    end
+    class Create < Exception
+    end
+    class Add < Exception
+    end
+    class Rem < Exception
+    end
+  end
+end

data/lib/ctm/list.rb

@@ -0,0 +1,80 @@
+# Generic List Object to handle paginated lists of objects
+module CTM
+  class List
+    include Enumerable
+
+    include HTTParty
+    base_uri ENV["CTM_URL"] || "api.calltrackingmetrics.com"
+
+    attr_reader :list_type, :token, :per_page, :page, :total_entries, :objects
+
+    # e.g. Account, token
+    def initialize(list_type, options={}, token=nil, fetched_objects=nil)
+      @list_type = list_type
+      @list_token_type = list_type.underscore.pluralize
+      @object_klass = CTM.module_eval(list_type)
+      @token = token || CTM::Auth.token
+      @account_id = options[:account_id]
+      if @account_id
+        @list_type_path = "accounts/#{@account_id}/#{@list_token_type}"
+      else
+        @list_type_path = @list_token_type
+      end
+      if fetched_objects
+        map_data(fetched_objects)
+      else
+        fetch_page(options)
+      end
+    end
+
+    def each &block
+      @objects.each do |obj|
+        if block_given?
+          block.call obj
+        else
+          yield obj
+        end
+      end
+    end
+
+    def create(options)
+      @object_klass.create(options.merge(:list_type_path => @list_type_path,
+                                         :list_token_type => @list_token_type,
+                                         :account_id => @account_id,
+                                         :token => @token))
+    end
+
+    def find(options)
+      first_name = options.delete(:first_name)
+      last_name  = options.delete(:last_name)
+      options[:filter] = options.delete(:filter) || "#{first_name} #{last_name}".strip if first_name || last_name
+
+      fetch_page(options)
+      self
+    end
+
+  protected
+
+    def fetch_page(options={})
+      options = {:per_page => 10, :page => 1}.merge(options)
+      path_str = "/api/v1/#{@list_type_path}.json"
+      res = self.class.get(path_str, :query => options.merge(:auth_token => @token))
+      data = res.parsed_response
+      if data["status"] && data["status"] == "error"
+        puts data.inspect
+        raise CTM::Error::List.new(data["message"] || data["reason"])
+      end
+      map_data(data)
+    end
+
+    def map_data(data)
+      @page = data['page']
+      @per_page = data['per_page']
+      @total_entries = data['total_entries']
+      @objects = data[@list_token_type].map {|obj|
+        @object_klass.new(obj, @token) 
+      }
+    end
+
+  end
+end

data/lib/ctm/number.rb

@@ -0,0 +1,25 @@
+module CTM
+  class Number < Base
+    attr_reader :id, :account_id
+    attr_accessor :name, :number, :formatted, :split, :routing
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @id         = data['id']
+      @account_id = data['account_id']
+      @name       = data['name']
+      @number     = data['number']
+      @formatted  = data['formatted']
+      @split      = data['split']
+      @routing    = data['routing']
+    end
+
+    def receiving_numbers(options={})
+      CTM::ReceivingNumberList.new(options.merge(:account_id => @account_id, :number_id => @id), @token)
+    end
+
+    def source
+    end
+
+  end
+end

data/lib/ctm/number_list.rb

@@ -0,0 +1,63 @@
+module CTM
+  class NumberList < List
+    def initialize(options={}, token=nil)
+      super('Number', options, token)
+      @source_id = options[:source_id]
+      if @source_id && @account_id
+        @list_type_path = "accounts/#{@account_id}/sources/#{@source_id}/#{@list_token_type}"
+      elsif @account_id
+        @list_type_path = "accounts/#{@account_id}/#{@list_token_type}"
+      else
+        @list_type_path = @list_token_type
+      end
+    end
+
+    # find a number within the given country/region and options like area_code or containing with contains
+    def search(country_code, options={})
+      options = {:country_code => country_code}.merge(options)
+      path_str = "/api/v1/#{@list_type_path}/search.json"
+      res = self.class.get(path_str, :query => options.merge(:auth_token => @token))
+      data = res.parsed_response
+      if data["status"] == "success"
+        list_data = {'available_numbers' => data['results'].map {|res| res.merge('account_id' => @account_id) },
+                     'page' => 1,
+                     'per_page' => data['results'].size,
+                     'total_entries' => data['results'].size}
+        CTM::List.new('AvailableNumber', {:account_id => @account_id}, @token, list_data)
+      end
+    end
+
+    # buy number with the digits
+    def buy(digits)
+      path_str = "/api/v1/#{@list_type_path}.json"
+      res = self.class.post(path_str, :body => {:phone_number => digits}.merge(:auth_token => @token))
+      if res && res['status'] == 'success'
+        CTM::Number.new(res['number'], @token)
+      else
+        puts res.inspect
+        raise CTM::Error::Buy.new(res["reason"])
+      end
+    end
+
+    # add trackng number to tracking source
+    def add(number)
+      path_str = "/api/v1/#{@list_type_path}/#{number.id}/add.json"
+      puts "Add to #{@account_id}:#{@source_id} -> #{number.id} -> #{path_str}"
+      #         accounts/25          /sources/5012     /numbers
+      # /api/v1/accounts/:account_id/sources/:source_id/numbers/:id/add
+      res = self.class.post(path_str, :body => {}.merge(:auth_token => @token))
+      if res && res['status'] == 'success'
+        CTM::Source.new(res['source'], @token)
+      else
+        puts res.inspect
+        raise CTM::Error::Add.new(res["reason"])
+      end
+    end
+
+    def rem
+      puts "Rem to #{@account_id}:#{@source_id} -> #{number.id} -> #{@list_type_path}"
+      # /api/v1/accounts/:account_id/sources/:source_id/numbers/:id/rem
+    end
+
+  end
+end

data/lib/ctm/receiving_number.rb

@@ -0,0 +1,25 @@
+module CTM
+  class ReceivingNumber < Base
+    attr_reader :id, :account_id
+    attr_accessor :name, :number, :formatted, :split
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @id         = data['id']
+      @account_id = data['account_id']
+      @name       = data['name']
+      @number     = data['number']
+      @formatted  = data['formatted']
+      @split      = data['split']
+    end
+
+    def save
+      options = {
+        :name => @name,
+        :number => @number
+      }
+      super(options)
+    end
+
+  end
+end

data/lib/ctm/receiving_number_list.rb

@@ -0,0 +1,39 @@
+module CTM
+  class ReceivingNumberList < List
+    def initialize(options={}, token=nil)
+      super('ReceivingNumber', options, token)
+      @account_id = options[:account_id]
+      @number_id  = options[:number_id]
+      if @number_id && @account_id
+        @list_type_path = "accounts/#{@account_id}/numbers/#{@number_id}/#{@list_token_type}"
+      elsif @account_id
+        @list_type_path = "accounts/#{@account_id}/#{@list_token_type}"
+      else
+        @list_type_path = @list_token_type
+      end
+    end
+
+    def add(receiving_number)
+      path_str = "/api/v1/#{@list_type_path}/#{receiving_number.id}/add.json"
+      res = self.class.post(path_str, :body => {}.merge(:auth_token => @token))
+      if res && res['status'] == 'success'
+        CTM::Number.new(res['receiving_number'], @token)
+      else
+        puts res.inspect
+        raise CTM::Error::Add.new(res["reason"])
+      end
+    end
+
+    def rem(receiving_number)
+      path_str = "/api/v1/#{@list_type_path}/#{receiving_number.id}/rem.json"
+      res = self.class.delete(path_str, :body => {}.merge(:auth_token => @token))
+      if res && res['status'] == 'success'
+        CTM::Number.new(res['receiving_number'], @token)
+      else
+        puts res.inspect
+        raise CTM::Error::Add.new(res["reason"])
+      end
+    end
+
+  end
+end

data/lib/ctm/sale.rb

@@ -0,0 +1,8 @@
+module CTM
+  class Sale
+
+    def initialize
+    end
+
+  end
+end

data/lib/ctm/source.rb

@@ -0,0 +1,33 @@
+module CTM
+  class Source < Base
+    attr_reader :id, :account_id
+    attr_accessor :name, :referring_url, :landing_url, :position, :online
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @id            = data['id']
+      @account_id    = data['account_id']
+      @name          = data['name']
+      @referring_url = data['referring_url']
+      @landing_url   = data['landing_url']
+      @position      = data['position']
+      @online        = data['online']
+    end
+
+    def save
+      options = {
+        :name => @name,
+        :position => @position,
+        :online => @online,
+        :referring_url => @referring_url,
+        :landing_url => @landing_url
+      }
+      super(options)
+    end
+
+    def numbers(options={})
+      CTM::NumberList.new(options.merge(:account_id => @account_id, :source_id => @id), @token)
+    end
+
+  end
+end

data/lib/ctm/token.rb

@@ -0,0 +1,15 @@
+module CTM
+  class Token
+    attr_reader :token, :expires
+
+    def initialize(data)
+      @token = data['token']
+      @expires = data['expires']
+    end
+
+    def accounts(options={})
+      CTM::List.new('Account', options, @token)
+    end
+
+  end
+end

data/lib/ctm/user.rb

@@ -0,0 +1,30 @@
+module CTM
+  class User < Base
+    attr_reader :id
+    attr_accessor :first_name, :last_name, :email, :role
+
+    def name
+      "#{first_name} #{last_name}"
+    end
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @id         = data['id']
+      @first_name = data['first_name']
+      @last_name  = data['last_name']
+      @email      = data['email']
+      @role       = data['role']
+    end
+
+    def save
+      options = {
+        :first_name => @first_name,
+        :last_name => @last_name,
+        :email => @email,
+        :role => @role
+      }
+      super(options)
+    end
+
+  end
+end

data/lib/ctm/webhook.rb

@@ -0,0 +1,15 @@
+module CTM
+  class Webhook < Base
+    attr_reader :id
+    attr_accessor :weburl, :with_resource_url, :position
+
+    def initialize(data, token=nil)
+      super(data, token)
+      @id                = data['id']
+      @weburl            = data['weburl']
+      @with_resource_url = data['with_resource_url']
+      @position          = data['position']
+    end
+
+  end
+end

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: ctm
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- CallTrackingMetrics
+- Todd Fisher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: phony
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email: info@calltrackingmetrics.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- TODO
+- ctm.gemspec
+- examples/buy_numbers.rb
+- examples/example.rb
+- examples/manage_numbers.rb
+- examples/manage_receivng_numbers.rb
+- examples/manage_sources.rb
+- examples/manage_users.rb
+- examples/manage_webhooks.rb
+- lib/ctm.rb
+- lib/ctm/account.rb
+- lib/ctm/auth.rb
+- lib/ctm/available_number.rb
+- lib/ctm/base.rb
+- lib/ctm/call.rb
+- lib/ctm/error.rb
+- lib/ctm/list.rb
+- lib/ctm/number.rb
+- lib/ctm/number_list.rb
+- lib/ctm/receiving_number.rb
+- lib/ctm/receiving_number_list.rb
+- lib/ctm/sale.rb
+- lib/ctm/source.rb
+- lib/ctm/token.rb
+- lib/ctm/user.rb
+- lib/ctm/webhook.rb
+homepage: http://github.com/calltracking/ctm-ruby
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: API Library for CallTrackingMetrics
+test_files: []
+has_rdoc: