Class: Io::Flow::V0::Clients::Tokens

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

Instance Method Summary collapse

Constructor Details

#initialize(client) ⇒ Tokens

Returns a new instance of Tokens.



4744
4745
4746
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4744

def initialize(client)
  @client = HttpClient::Preconditions.assert_class('client', client, ::Io::Flow::V0::Client)
end

Instance Method Details

#delete_by_id(id) ⇒ Object 



4773
4774
4775
4776
4777
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4773

def delete_by_id(id)
  HttpClient::Preconditions.assert_class('id', id, String)
  r = @client.request("/tokens/#{CGI.escape(id)}").delete
  nil
end

#get(incoming = {}) ⇒ Object

Get all tokens that you are authorized to view. Note that the cleartext token value is never sent. To view the API token itself, see the resource path /tokens/:id/cleartext



4751
4752
4753
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763
4764
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4751

def get(incoming={})
  opts = HttpClient::Helper.symbolize_keys(incoming)
  query = {
    :id => (x = opts.delete(:id); x.nil? ? nil : HttpClient::Preconditions.assert_class('id', x, Array).map { |v| HttpClient::Preconditions.assert_class('id', v, String) }),
    :organization => (x = opts.delete(:organization); x.nil? ? nil : HttpClient::Preconditions.assert_class('organization', x, String)),
    :partner => (x = opts.delete(:partner); x.nil? ? nil : HttpClient::Preconditions.assert_class('partner', x, String)),
    :mine => (x = opts.delete(:mine); x.nil? ? nil : HttpClient::Preconditions.assert_boolean('mine', x)),
    :limit => HttpClient::Preconditions.assert_class('limit', (x = opts.delete(:limit); x.nil? ? 25 : x), Integer),
    :offset => HttpClient::Preconditions.assert_class('offset', (x = opts.delete(:offset); x.nil? ? 0 : x), Integer),
    :sort => HttpClient::Preconditions.assert_class('sort', (x = opts.delete(:sort); x.nil? ? "-created_at" : x), String)
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/tokens").with_query(query).get
  r.map { |x| ::Io::Flow::V0::Models::Token.from_json(x) }
end

#get_by_id(id) ⇒ Object

Get metadata for the token with this ID



4767
4768
4769
4770
4771
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4767

def get_by_id(id)
  HttpClient::Preconditions.assert_class('id', id, String)
  r = @client.request("/tokens/#{CGI.escape(id)}").get
  ::Io::Flow::V0::Models::Token.from_json(r)
end

#get_cleartext_by_id(id) ⇒ Object

Retrieves the token with the actual string token in cleartext



4780
4781
4782
4783
4784
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4780

def get_cleartext_by_id(id)
  HttpClient::Preconditions.assert_class('id', id, String)
  r = @client.request("/tokens/#{CGI.escape(id)}/cleartext").get
  ::Io::Flow::V0::Models::Cleartext.new(r)
end

#post_authentications(token_authentication_form) ⇒ Object

Preferred method to validate a token, obtaining specific information if the token is valid (or a 404 if the token does not exist). We use an HTTP POST with a form body to enusre that the token itself is not logged in the request logs.



4790
4791
4792
4793
4794
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 4790

def post_authentications(token_authentication_form)
  (x = token_authentication_form; x.is_a?(::Io::Flow::V0::Models::TokenAuthenticationForm) ? x : ::Io::Flow::V0::Models::TokenAuthenticationForm.new(x))
  r = @client.request("/tokens/authentications").with_json(token_authentication_form.to_json).post
  ::Io::Flow::V0::Models::TokenReference.from_json(r)
end