vivialconnect 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 828c9a5c3422698044222a0d637bf1993c27014e
+  data.tar.gz: ac62e677b700bb6a7a653ea44d0fcf76933001c8
+SHA512:
+  metadata.gz: f2a45113770f5c43391cef5484983713f24ecd6f69717c1f2b88c2844ad72bc49fc85ca030c9c651446c6ad36669808eecef8c200dc3c952314bcc31fccdb816
+  data.tar.gz: 3363eb281a9da8c0bfe760843b80ace6d0705138fa136ef64502dd27a7e53a1bc2489f539cb494f72af7180b5aae7fb2343f7237aaf0b92110934b9967003bba

data/lib/vivialconnect.rb

@@ -0,0 +1,14 @@
+require 'json'
+require 'vivialconnect/version'
+require 'vivialconnect/client'
+require 'vivialconnect/resource'
+require 'vivialconnect/message'
+require 'vivialconnect/account'
+require 'vivialconnect/user'
+require 'vivialconnect/attachment'
+require 'vivialconnect/configuration'
+require 'vivialconnect/number'
+require 'vivialconnect/log'
+require 'vivialconnect/contact'
+require 'vivialconnect/vivial_connect_error'
+

data/lib/vivialconnect/account.rb

@@ -0,0 +1,278 @@
+module VivialConnect
+  ##
+  #=== .add_main_contact_to_subaccount(options={})
+  #
+  #Creates a new contact and adds it as the main contact to a subaccount.
+  #
+  # Required parameters:
+  #
+  # account_id   | Fixnum | 123456 (subaccount id)
+  # company_name | String | "App Developer Inc." 
+  # first_name   | String | "Bob"
+  # last_name    | String | "Tester"
+  # email        | String | "btester@vivialconnect"                   
+  #
+  # 
+  # Optional parameters:
+  #
+  # address1     | String | "500 Office Building Ln"
+  # address2     | String | "Suite 300"
+  # address3     | String | "c/o Front Desk"
+  # city         | String | "Columbia Heights"
+  # country      | String | "United States"
+  # state        | String | "Minnesota"
+  # postal_code  | String | "55421"
+  # title        | String | "CMO"
+  # work_phone   | String | "+1XXXXXXXXXX"
+  # mobile_phone | String | "+1XXXXXXXXXX"
+  # fax          | String | "+1XXXXXXXXXX"
+  #
+  # Example Usage
+  #
+  #
+  # VivialConnect::Account.add_main_contact_to_subaccount(email: "btester@vivialconnect", contact_type:"main", company_name: "Acme")
+  # => #<VivialConnect::Contact account_id=1XXXX, active=true, address1=nil, address2=nil, address3=nil, city=nil, company_name="Acme", contact_type="main", country="United States", date_created="2017-04-21T10:51:50-04:00", date_modified="2017-04-21T10:51:50-04:00", email="btester@vivialconnect", fax=nil, first_name="Bob", id=89, last_name="Tester", mobile_phone=nil, postal_code="55421", state=nil, title=nil, work_phone="+1XXXXXXXXXX"> 
+  #
+  #
+  ##
+  #=== .add_user_to_subaccount(options={})
+  #
+  #Creates a new User and adds it to a subaccount.
+  #
+  #
+  # Required parameters:                                                             
+  #
+  #
+  # first_name   | String | "Bob"
+  # last_name    | String | "Tester"
+  # email        | String | "btester@vivialconnect"                     
+  # username     | String | "btester"
+  # password     | String | "dlrowolleh"
+  # 
+  #
+  # Example Usage
+  #
+  #
+  # VivialConnect::Account.add_user_to_subaccount(account_id: 1XXXX, email: "btester@vivialconnect.net", username: "btester", first_name: "Bob", last_name: "Tester", password: "XXXXXXX")
+  # => #<VivialConnect::User account_id=1XXXX, active=true, api_key="XYZYXZYXYZXYXZYXZYXYZYXYZYXYZYXYZYX", date_created="2017-04-21T11:27:16-04:00", date_modified="2017-04-21T11:27:16-04:00", email="btester@vivialconnect.net", first_name="Bob", id=10093, last_name="Tester", roles=[{"active"=>true, "date_created"=>"2016-09-30T19:42:59-04:00", "date_modified"=>"2016-09-30T19:42:59-04:00", "description"=>"User role", "id"=>4, "name"=>"User", "role_type"=>"client"}], timezone="US/Eastern", username="btester", verified=false> 
+  #
+  # Note: This method triggers an email to the created user's account. They need to answer this confirmation email before they will be able to log in.
+  ##
+  #=== .all
+  #
+  #Returns an array containing ruby objects corresponding to all Account resources associated with your account i.e. main account and associated subaccounts
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.all
+  # => [#<VivialConnect::Account>, #<VivialConnect::Account>, #<VivialConnect::Account>]
+  #
+  #
+  #===  .count
+  #
+  #Returns the amount of Accounts associated with your account
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.count
+  # => 5
+  #
+  #
+  ##
+  #=== .create(options={})
+  #
+  #Creates a subaccount tied to your main account
+  #
+  #
+  # Required parameters:                                                                  
+  #
+  #
+  # company_name | String | "App Developer Inc."                    
+  #
+  # 
+  # Example Usage
+  #
+  #
+  # VivialConnect::Account.create(company_name: "App Developer Inc.")
+  # => #<VivialConnect::Account account_id=1XXXX, accounts=[], active=true, company_name="App Developer Inc.", contacts=[], date_created="2017-04-20T17:07:08-04:00", date_modified="2017-04-20T17:07:08-04:00", id=10086, services=[{"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"SMS service", "id"=>1, "name"=>"sms", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Account service", "id"=>2, "name"=>"accounts", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Public service", "id"=>3, "name"=>"public", "service_type"=>"client"}]> 
+  #
+  #
+  # Note: When creating subaccounts, the `id` refers to the subaccount id, whereas the `account_id` refers to the main account.
+  #  
+  #
+  ##
+  #=== .find(id)
+  #
+  #Returns the a Account object referenced by the `id` value.
+  #
+  # Required parameter:
+  #
+  # id | Fixnum | the id of the account you would like to retrieve
+  #   
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.find(10086)
+  # => #<VivialConnect::Account account_id=1XXXX, accounts=[], active=true, company_name="App Developer Inc.", contacts=[], date_created="2017-04-20T17:07:08-04:00", date_modified="2017-04-20T17:07:08-04:00", id=10086, services=[{"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"SMS service", "id"=>1, "name"=>"sms", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Account service", "id"=>2, "name"=>"accounts", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Public service", "id"=>3, "name"=>"public", "service_type"=>"client"}]> 
+  #
+  #
+  ##
+  #=== .find_each(start: 1, finish: nil, batch_size: 150) 
+  #
+  #Iterates through all Account objects on your account in N sized batches beginning at the `start: value` and ending at the `finish: value`.
+  # 
+  #
+  # When a block is given this method yields an individual Account object. 
+  # Without a block, this method returns an Enumerator. 
+  #
+  #
+  # By default, it will begin at the first Account and end at the last Account
+  # 
+  # 
+  # With default batch_size: 150, if you wanted to get your records from
+  # 150 to 300 you would start at 2 and finish at 2.
+  #
+  # Returns an Array of objects corresponding to the `start` and `finish` values. Default is all objects.
+  #
+  # Optional parameters:
+  #
+  # start      | Fixnum | batch to start with
+  # finish     | Fixnum | batch to end with
+  # batch_size | Fixnum | between 1..150
+  #   
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.find_each {|account| puts account.company_name }
+  # App Developer Inc.
+  # => [#<VivialConnect::Account>] 
+  #
+  #
+  #
+  #
+  ##
+  #===  .find_in_batches(start: 1, finish: nil, batch_size: 150)  
+  # 
+  #Iterates through all of the Account objects on your account in N sized batches beginning at the `start: value` and ending at the `finish: value`. 
+  #
+  # 
+  # When a block is given this method yields an array of batch_size Account objects. 
+  # Without a block, it returns an Enumerator.
+  #
+  #
+  # By default, it will begin at the first Account and end at the last Account
+  # 
+  # 
+  # With default batch_size: 150, if you wanted to get your records from
+  # 150 to 300 you would start at 2 and finish at 2.
+  #
+  #
+  #
+  # Returns an Array of objects corresponding to the `start` and `finish` values. Default is all objects.
+  #
+  #
+  # Optional parameters:
+  #
+  # start      | Fixnum | batch to start with
+  # finish     | Fixnum | batch to end with
+  # batch_size | Fixnum | between 1..150
+  #   
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.find_in_batches {|batch| do_something_with_an_array(batch)}
+  # => [#<VivialConnect::Account>] 
+  #
+  #
+  ##
+  #=== .subaccounts
+  #
+  #Returns an array containing ruby objects containing all associated subaccounts
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.subaccounts
+  # => [#<VivialConnect::Account>, #<VivialConnect::Account>, #<VivialConnect::Account>]
+  #
+  #
+  ##
+  #=== .update(id, options={})
+  #
+  #  Required parameters:
+  #
+  #  id           | Fixnum | 10000
+  #  company_name | String | "New Name"
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Account.update(1000, company_name: "New Name")
+  # => #<VivialConnect::Account account_id=1XXXX, accounts=[], active=true, company_name="New Name", contacts=[], date_created="2017-04-20T17:07:08-04:00", date_modified="2017-04-20T17:07:08-04:00", id=10086, services=[{"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"SMS service", "id"=>1, "name"=>"sms", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Account service", "id"=>2, "name"=>"accounts", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Public service", "id"=>3, "name"=>"public", "service_type"=>"client"}]> 
+  #
+  #
+  ##
+  #===  \#save
+  #
+  # Creates a subaccount associated with your main account or updates an existing one
+  #
+  #
+  # Example usage:
+  #
+  # account = VivialConnect::Account.new
+  # account.company_name = "B Tester QA Inc."
+  # account.save 
+  # => #<VivialConnect::Account account_id=1XXXX, accounts=[], active=true, company_name="B Tester QA Inc.", contacts=[], date_created="2017-04-20T17:07:08-04:00", date_modified="2017-04-20T17:07:08-04:00", id=10086, services=[{"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"SMS service", "id"=>1, "name"=>"sms", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Account service", "id"=>2, "name"=>"accounts", "service_type"=>"client"}, {"active"=>true, "date_created"=>"2016-09-30T19:42:58-04:00", "date_modified"=>"2016-09-30T19:42:58-04:00", "description"=>"Public service", "id"=>3, "name"=>"public", "service_type"=>"client"}]> 
+  #
+  #
+  class Account < Resource
+
+    def self.subaccounts # :nodoc:
+      uri = '/subaccounts.json'
+      VivialConnect::Client.instance.make_request('GET', uri)
+    end
+
+    def self.add_main_contact_to_subaccount(options={}) # :nodoc:
+      raise VivialConnectClientError, "you must include an account_id parameter" if !options.keys.include?(:account_id)
+
+      # This call must be made from the subaccount, so the client's account_id has to be updated
+      main_account_id = VivialConnect::Client.instance.account_id
+  
+      VivialConnect::Client.instance.account_id = options[:account_id]
+      uri = '/contacts.json'
+      options[:contact_type] = 'main'
+      data = {}
+      data[:contact] = options 
+      data = data.to_json
+
+      begin 
+        response = VivialConnect::Client.instance.make_request('POST', uri, data)
+      ensure
+        # client's account_id must be set back for future calls to work 
+        VivialConnect::Client.instance.account_id = main_account_id
+      end
+
+      response
+    end
+
+    def self.add_user_to_subaccount(options={}) # :nodoc:
+      raise VivialConnectClientError, "you must include an account_id parameter" if !options.keys.include?(:account_id)
+      uri = '/users/register.json'
+      options[:role] = 'User'
+      data = {}
+      data[:user] = options 
+      data = data.to_json
+      response = VivialConnect::Client.instance.make_request('POST', uri, data)
+    end
+
+  end
+end
+
+

data/lib/vivialconnect/attachment.rb

@@ -0,0 +1,74 @@
+module VivialConnect 
+  ##
+  #=== .count_by_message_id(message_id)
+  #
+  #Returns the number of attachments related to the message_id passed.
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Attachment.count_by_message_id(844)
+  # => 1
+  #
+  #
+  ##
+  #=== .delete(message_id, attachment_id)
+  #
+  #Deletes Attachment related to the `message_id` passed
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Attachment.delete(844, 190)
+  # => true
+  #
+  #
+  ##
+  #=== .find(message_id, attachment_id)
+  #
+  #Returns an Attachment corresponding to the `message_id` and `attachment_id` passed
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Attachment.find(844, 190)
+  # => [#<VivialConnect::Attachment account_id=1XXXX, content_type="image/jpeg", date_created="2017-04-19T11:18:16-04:00", date_modified="2017-04-19T11:18:16-04:00", file_name="great-dane.jpg", id=190, key_name="mms/50/e9aa5a6970498352a399ebdf798b86bb801b5b/great-dane.jpg", message_id=844, size=110805>]
+  #
+  #
+  ##
+  #=== .find_all_by_message_id(message_id)
+  #
+  #Returns an array containing ruby objects corresponding to all attachment resources related to the `message_id` passed
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Attachment.find_all_by_message_id(844)
+  # => [#<VivialConnect::Attachment account_id=1XXXX, content_type="image/jpeg", date_created="2017-04-19T11:18:16-04:00", date_modified="2017-04-19T11:18:16-04:00", file_name="great-dane.jpg", id=190, key_name="mms/50/e9aa5a6970498352a399ebdf798b86bb801b5b/great-dane.jpg", message_id=844, size=110805>]
+  #
+  #
+
+  class Attachment < Resource
+
+    def self.find_all_by_message_id(message_id) #:nodoc:
+      VivialConnect::Client.instance.make_request('GET', "/messages/#{message_id}/attachments.json")
+    end
+
+    def self.find(message_id, attachment_id) #:nodoc:
+      VivialConnect::Client.instance.make_request('GET', "/messages/#{message_id}/attachments/#{attachment_id}.json")
+    end
+
+    def self.count_by_message_id(message_id) #:nodoc:
+      VivialConnect::Client.instance.make_request('GET', "/messages/#{message_id}/attachments/count.json")
+    end
+
+    def self.delete(message_id, attachment_id) #:nodoc:
+      VivialConnect::Client.instance.make_request('DELETE', "/messages/#{message_id}/attachments/#{attachment_id}.json")
+    end
+
+  end
+end

data/lib/vivialconnect/client.rb

@@ -0,0 +1,326 @@
+require 'faraday'
+require 'addressable'
+require 'digest'
+require 'openssl'
+require 'singleton'
+
+module VivialConnect 
+
+  ##
+  #=== .configure(api_key, api_secret, account_id, host="https://api.vivialconnect.net/api/", api_version="v1.0" )
+  #
+  #Configures the client with your `api_key`, `api_secret`, `account_id`, `host`, and `api_version`
+  #
+  # 
+  # Required parameters:
+  #
+  # api_key     | String | "YOURAPIKEY"
+  # api_secret  | String | "YOURAPISECRET"
+  # account_id  | Fixnum | 100000
+  #
+  #
+  # Optional parameters:
+  #
+  # host        | String | "baseapiurl" 
+  # api_version | String | "v1.9"
+  #
+  # NOTE: default host is "https://api.vivialconnect.net/api/" and default version is "v1.0"
+  #
+  #
+  # Example usage:
+  #
+  #
+  # VivialConnect::Client.configure(API_KEY, API_SECRET, ACCOUNT_ID)
+  # => true
+  #
+  # NOTE: .configure does not check if your credentials are good, it merely checks that you have entered values for them
+  #===  .reset
+  #
+  #Resets all of the configuration values to nil. This gives you a blank slate client to call .configure on.
+  #
+  #
+  # Example usage
+  #
+  #
+  # VivialConnect::Client.reset
+  # => true
+  #
+  #
+  #===  \#reset_api_base_path(new_host, new_api_version)
+  #
+  #Resets the api base path (host + api_version) on an instantiated client instance
+  #
+  # Required paramters:
+  #
+  # new_host        | String | "https://api.vivialconnect.net/api/"
+  # new_api_version | String | "v1.1"
+  #
+  #
+  # Example usage
+  #
+  # VivialConnect::Client.instance.reset_api_base_path("https://api.vivialconnect.net/api/", "v1.1" )
+  # => true
+
+  class Client
+
+  #:nodoc:
+
+    include Singleton
+
+    @@configured = false
+
+    def initialize
+      begin 
+        @base_api_path = host + "#{api_version}/"
+        connection
+      rescue NameError => e
+        raise VivialConnectClientError, "Please configure client before making requests. You can do this like so: .configure(api_key, api_secret, account_id) to "
+      end
+    end
+
+    def self.configure(api_key, api_secret, account_id, host="https://api.vivialconnect.net/api/", api_version="v1.0" )
+      @@api_key= api_key
+      @@api_secret = api_secret
+      @@account_id = account_id
+      @@host = host
+      @@api_version = api_version
+      @@configured = true
+      true
+    end
+
+    def self.reset
+      @@api_key= nil
+      @@api_secret = nil
+      @@account_id = nil
+      @@host = nil
+      @@api_version = nil
+      @@configured = false
+      @base_api_path = nil
+      true
+    end
+
+    def host
+      @@host
+    end
+
+    def account_id 
+      @@account_id
+    end 
+
+    def account_id=(id)
+       @@account_id = id
+    end 
+
+    def reset_api_base_path(new_host, new_api_version)
+       @base_api_path = new_host + "#{new_api_version}/"
+       connection
+       true
+    end 
+
+
+    def api_version
+      @@api_version
+    end
+
+    def base_api_path
+      @base_api_path
+    end 
+
+
+    def self.configured?
+      @@configured == true
+    end
+
+
+    def set_request_timestamp 
+      @request_timestamp = Time.now.utc.strftime('%Y%m%dT%H%M%SZ')
+    end
+
+
+    def request_timestamp
+      @request_timestamp
+    end 
+
+
+    def set_date_for_date_header
+      @date_for_date_header = Time.now.utc.strftime('%a, %d %b %Y %H:%M:%S GMT')
+    end 
+
+
+    def date_for_date_header
+      @date_for_date_header 
+    end 
+
+
+    def api_key
+      @@api_key
+    end
+
+
+    def api_secret
+      @@api_secret
+    end
+
+
+    def set_hmac_sha256(canonical_request)
+      @hmac_sha256 = OpenSSL::HMAC.hexdigest('SHA256', api_secret, canonical_request)
+    end
+
+
+    def hmac_sha256
+      @hmac_sha256 
+    end
+
+    def build_canonical_request(http_verb, url, request_timestamp, canonicalized_headers, canonicalized_header_names, data={})
+      canonical_request = http_verb + "\n" + request_timestamp + "\n" + Addressable::URI.encode(url.path) + 
+                          "\n" + get_canonicalized_query_string(url) + "\n" + canonicalized_headers + "\n" +
+                           canonicalized_header_names +  "\n" + Digest::SHA256.hexdigest(data.to_s)
+    end 
+
+
+    def sign_request(http_verb, url, data={})
+      set_request_timestamp 
+      set_date_for_date_header
+      canonicalized_headers = "accept:application/json" + "\n" + "date:#{date_for_date_header}" + "\n" +"host:api.vivialconnect.net"
+      canonicalized_header_names = "accept;date;host"
+      canonical_request = build_canonical_request(http_verb, url, request_timestamp, canonicalized_headers, canonicalized_header_names, data)
+      set_hmac_sha256(canonical_request)
+    end 
+
+
+    def get_canonicalized_query_string(url)
+      return "" unless url.query_values
+      sorted_params = url.query_values.sort
+      # gsub because Addressable encodes an empty space as + in parameters
+      # and vivial connect api requires spaces to be %20 encoded
+      # http://stackoverflow.com/questions/2824126/whats-the-difference-between-uri-escape-and-cgi-escape
+      encoded_sorted_params = Addressable::URI.form_encode(sorted_params).gsub('+', '%20') 
+    end
+
+
+    def connection
+      @conn = Faraday.new(:url => base_api_path) 
+    end
+
+    def make_request(request_method, url, data={})
+      raise VivialConnectClientError, "invalid request method" unless ['GET', 'POST', 'PUT', 'DELETE'].include?(request_method)
+      raise VivialConnectClientError, "Please configure client before making requests. You can do this like so: .configure(api_key, api_secret, account_id) to " if !VivialConnect::Client.configured?
+
+      url = get_request_path(url)
+      sign_request(request_method, url, data)
+      headers = create_request_headers
+      request_method = request_method.downcase.to_sym                                                                                                                                                                                                                                                                                                                                               
+      response = connection.run_request(request_method, url, data.to_s, headers)
+      process_api_response(response, url)
+    end
+
+
+    def create_request_headers
+      headers = {}
+      headers['Content-Type'] = 'application/json'
+      headers['Host'] = 'api.vivialconnect.net'
+      headers['X-Auth-Date'] = request_timestamp
+      headers['X-Auth-SignedHeaders'] = 'accept;date;host'
+      headers['Authorization'] = "HMAC" + " " + api_key + ":" + hmac_sha256
+      headers['Date'] = date_for_date_header
+      headers['Accept'] = 'application/json'
+      headers
+    end 
+
+
+    def no_account_number_endpoints
+      ['accounts.json', '/accounts/count.json', 'registration/register.json'] 
+    end
+
+
+    def account_regex_match?(url)
+      m =  /accounts\/[0-9]+.json/.match(url)
+      return !m.nil? 
+    end
+
+
+    def account_query_match?(url)
+      url.include?("accounts.json?")
+    end
+
+
+    def get_request_path(url)
+      if no_account_number_endpoints.include?(url) || account_regex_match?(url) || account_query_match?(url)
+        base_path = base_api_path
+        Addressable::URI.parse(base_path + url)
+      else
+        base_path = base_api_path + "accounts/#{account_id}"
+        Addressable::URI.parse(base_path + url)
+      end
+    end 
+
+    def process_api_response(response, url)
+      # make API response into appropriate object and return it
+      api_response = {}
+        raise VivialConnectClientError, JSON.parse(response.body)['message'] ? JSON.parse(response.body)['message'] : response.body if response.status >= 400
+        response_class = choose_response_class(url.path)
+        if response.body == "" || response.body.include?("{}")
+          return true if response.status.between?(200, 299)
+          false
+        else
+          api_response = JSON.parse(response.body)
+          if api_response[api_response.keys.first].is_a?(Array) 
+            #return an array of resource objects
+            response_array = api_response[api_response.keys.first]
+            api_response = process_array(response_array, response_class)
+          elsif url.path.split("/")[-1] == "subaccounts.json"
+            #handle subaccounts array
+            response_array = api_response[api_response.keys.first]['accounts']
+            api_response = process_array(response_array, response_class)
+          elsif api_response[api_response.keys[1]].is_a?(Array)
+            #handle Log resource, return last key and an array full of log objects
+            last_key = api_response['last_key']
+            response_array = api_response['log_items']
+            processed_array = process_array(response_array, response_class)    
+            [last_key, processed_array]
+          elsif api_response[api_response.keys.first].is_a?(Fixnum)
+            # json is only one level deep for .count response, so no need to delete the json root
+            # return the number
+            api_response['count']
+          else 
+            if response_class == VivialConnect::Log 
+              # json is only one level deep for Log response, so no need to delete the json root
+              response_class.new(api_response)
+            else 
+              # remove json root, these resources return nested info
+              api_response = api_response[api_response.keys.first]
+              response_class.new(api_response)
+            end
+          end 
+
+      end
+    end
+
+    def process_array(array, response_class)
+      final_array = []
+      array.each {|index| final_array << response_class.new(index)}
+      final_array
+    end 
+
+    def choose_response_class(url)
+      url = url.gsub('.json', '').split('/')
+      if (url.count <= 5 )|| (url.count == 6 && url[5] == 'count')  
+        return Account 
+      elsif url.include?('attachments')
+        return Attachment
+      elsif url.include?('subaccounts')
+        return Account
+      else 
+        api_resource = url[5]
+        #exceptions needed for resources requiring camelcase
+        klass = api_resource.capitalize
+        #takes off pluralization -- may have to be updated to match self.pluralize(string) in Resource, or use library if necessary
+        klass = klass[0..-2]
+        return VivialConnect.const_get(klass) 
+      end 
+    end
+
+
+  end
+end 
+