Class: Invoiced::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/invoiced.rb

Constant Summary collapse

ApiBase = 
'https://api.invoiced.com'
ApiBaseSandbox = 
'https://api.sandbox.invoiced.com'
OpenTimeout = 
30
ReadTimeout = 
80

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(api_key, sandbox = false, sso_key = false) ⇒ Client

Returns a new instance of Client.



58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/invoiced.rb', line 58

def initialize(api_key, sandbox=false, sso_key=false)
  @api_key = api_key
  @sandbox = sandbox
  @api_url = sandbox ? ApiBaseSandbox : ApiBase
  @sso_key = sso_key

  # Object endpoints
  @CatalogItem = Invoiced::CatalogItem.new(self)
  @Coupon = Invoiced::Coupon.new(self)
  @CreditNote = Invoiced::CreditNote.new(self)
  @Customer = Invoiced::Customer.new(self)
  @Estimate = Invoiced::Estimate.new(self)
  @Event = Invoiced::Event.new(self)
  @File = Invoiced::File.new(self)
  @Invoice = Invoiced::Invoice.new(self)
  @Note = Invoiced::Note.new(self)
  @Plan = Invoiced::Plan.new(self)
  @Subscription = Invoiced::Subscription.new(self)
  @Task = Invoiced::Task.new(self)
  @TaxRate = Invoiced::TaxRate.new(self)
  @Transaction = Invoiced::Transaction.new(self)
end

Instance Attribute Details

#api_key ⇒ Object (readonly)

Returns the value of attribute api_key.



55
56
57
 
# File 'lib/invoiced.rb', line 55

def api_key
  @api_key
end

#api_url ⇒ Object (readonly)

Returns the value of attribute api_url.



55
56
57
 
# File 'lib/invoiced.rb', line 55

def api_url
  @api_url
end

#CatalogItem ⇒ Object (readonly)

Returns the value of attribute CatalogItem.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def CatalogItem
  @CatalogItem
end

#Coupon ⇒ Object (readonly)

Returns the value of attribute Coupon.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Coupon
  @Coupon
end

#CreditNote ⇒ Object (readonly)

Returns the value of attribute CreditNote.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def CreditNote
  @CreditNote
end

#Customer ⇒ Object (readonly)

Returns the value of attribute Customer.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Customer
  @Customer
end

#Estimate ⇒ Object (readonly)

Returns the value of attribute Estimate.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Estimate
  @Estimate
end

#Event ⇒ Object (readonly)

Returns the value of attribute Event.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Event
  @Event
end

#File ⇒ Object (readonly)

Returns the value of attribute File.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def File
  @File
end

#Invoice ⇒ Object (readonly)

Returns the value of attribute Invoice.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Invoice
  @Invoice
end

#Note ⇒ Object (readonly)

Returns the value of attribute Note.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Note
  @Note
end

#Plan ⇒ Object (readonly)

Returns the value of attribute Plan.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Plan
  @Plan
end

#sandbox ⇒ Object (readonly)

Returns the value of attribute sandbox.



55
56
57
 
# File 'lib/invoiced.rb', line 55

def sandbox
  @sandbox
end

#sso_key ⇒ Object (readonly)

Returns the value of attribute sso_key.



55
56
57
 
# File 'lib/invoiced.rb', line 55

def sso_key
  @sso_key
end

#Subscription ⇒ Object (readonly)

Returns the value of attribute Subscription.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Subscription
  @Subscription
end

#Task ⇒ Object (readonly)

Returns the value of attribute Task.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Task
  @Task
end

#TaxRate ⇒ Object (readonly)

Returns the value of attribute TaxRate.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def TaxRate
  @TaxRate
end

#Transaction ⇒ Object (readonly)

Returns the value of attribute Transaction.



56
57
58
 
# File 'lib/invoiced.rb', line 56

def Transaction
  @Transaction
end

Instance Method Details

#generate_sign_in_token(customerId, ttl) ⇒ Object 



115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
 
# File 'lib/invoiced.rb', line 115

def (customerId, ttl)
    if !@sso_key
        raise "Please provide a single sign-on key! You can find this value in Settings > Developers > Single Sign-On of the Invoiced application."
    end

    expires = Time.now + ttl # TTL should be in seconds

    payload = {
        :sub => customerId,
        :iss => "Invoiced Ruby/#{Invoiced::VERSION}",
        :iat => Time.now.to_i,
        :exp => expires.to_i
    }

    JWT.encode payload, @sso_key, 'HS256'
end

#request(method, endpoint, params = {}, opts = {}) ⇒ Object 



81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
 
# File 'lib/invoiced.rb', line 81

def request(method, endpoint, params={}, opts={})
    url = @api_url + endpoint

    case method.to_s.downcase.to_sym
    # These methods don't have a request body
    when :get, :head, :delete
        # Make params into GET parameters
        url += "#{URI.parse(url).query ? '&' : '?'}#{Util.uri_encode(params)}" if params && params.any?
        payload = nil
    # Otherwise, encode request body to JSON
    else
        payload = params.to_json
    end

    begin
        response = RestClient::Request.execute(
            :method => method,
            :url => url,
            :headers => buildHeaders(opts),
            :payload => payload,
            :open_timeout => OpenTimeout,
            :timeout => ReadTimeout
        )
    rescue RestClient::Exception => e
        if e.response
            handle_api_error(e.response)
        else
            handle_network_error(e)
        end
    end

    parse(response)
end