Class: Io::Flow::V0::Clients::Invitations

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

Instance Method Summary collapse

Constructor Details

#initialize(client) ⇒ Invitations

Returns a new instance of Invitations.



3086
3087
3088
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3086

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

Instance Method Details

#delete_by_id(id) ⇒ Object 



3125
3126
3127
3128
3129
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3125

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

#get(incoming = {}) ⇒ Object

Search invitations. Always paginated.



3091
3092
3093
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3091

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)),
    :email => (x = opts.delete(:email); x.nil? ? nil : HttpClient::Preconditions.assert_class('email', x, String)),
    :token => (x = opts.delete(:token); x.nil? ? nil : HttpClient::Preconditions.assert_class('token', x, String)),
    :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),
    :expand => (x = opts.delete(:expand); x.nil? ? nil : HttpClient::Preconditions.assert_class('expand', x, Array).map { |v| HttpClient::Preconditions.assert_class('expand', v, String) })
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/invitations").with_query(query).get
  r.map { |x| ::Io::Flow::V0::Models::Invitation.new(x) }
end

#get_by_id(id, incoming = {}) ⇒ Object

Returns information about a specific invitation.



3115
3116
3117
3118
3119
3120
3121
3122
3123
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3115

def get_by_id(id, incoming={})
  HttpClient::Preconditions.assert_class('id', id, String)
  opts = HttpClient::Helper.symbolize_keys(incoming)
  query = {
    :expand => (x = opts.delete(:expand); x.nil? ? nil : HttpClient::Preconditions.assert_class('expand', x, Array).map { |v| HttpClient::Preconditions.assert_class('expand', v, String) })
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/invitations/#{CGI.escape(id)}").with_query(query).get
  ::Io::Flow::V0::Models::Invitation.new(r)
end

#get_tokens_by_token(token, incoming = {}) ⇒ Object

Lookup an invitation by its token.



3132
3133
3134
3135
3136
3137
3138
3139
3140
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3132

def get_tokens_by_token(token, incoming={})
  HttpClient::Preconditions.assert_class('token', token, String)
  opts = HttpClient::Helper.symbolize_keys(incoming)
  query = {
    :expand => (x = opts.delete(:expand); x.nil? ? nil : HttpClient::Preconditions.assert_class('expand', x, Array).map { |v| HttpClient::Preconditions.assert_class('expand', v, String) })
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/invitations/tokens/#{CGI.escape(token)}").with_query(query).get
  ::Io::Flow::V0::Models::Invitation.new(r)
end

#get_versions(incoming = {}) ⇒ Object 



3153
3154
3155
3156
3157
3158
3159
3160
3161
3162
3163
3164
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3153

def get_versions(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) }),
    :invitation => (x = opts.delete(:invitation); x.nil? ? nil : HttpClient::Preconditions.assert_class('invitation', x, Array).map { |v| HttpClient::Preconditions.assert_class('invitation', v, String) }),
    :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? ? "journal_timestamp" : x), String)
  }.delete_if { |k, v| v.nil? }
  r = @client.request("/invitations/versions").with_query(query).get
  r.map { |x| ::Io::Flow::V0::Models::InvitationVersion.new(x) }
end

#post(invitation_form) ⇒ Object

Create a new invitation.



3108
3109
3110
3111
3112
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3108

def post(invitation_form)
  HttpClient::Preconditions.assert_class('invitation_form', invitation_form, ::Io::Flow::V0::Models::InvitationForm)
  r = @client.request("/invitations").with_json(invitation_form.to_json).post
  ::Io::Flow::V0::Models::Invitation.new(r)
end

#put_tokens_by_token(token, invitation_accepts_form) ⇒ Object

Accepts the invitation w/ the specified token, creating a membership record for this user within this organization. Invitations are one time use only - you will get a validation error if the invitation has previously been accepted.



3146
3147
3148
3149
3150
3151
 
# File 'lib/flow_commerce/flow_api_v0_client.rb', line 3146

def put_tokens_by_token(token, invitation_accepts_form)
  HttpClient::Preconditions.assert_class('token', token, String)
  HttpClient::Preconditions.assert_class('invitation_accepts_form', invitation_accepts_form, ::Io::Flow::V0::Models::InvitationAcceptsForm)
  r = @client.request("/invitations/tokens/#{CGI.escape(token)}").with_json(invitation_accepts_form.to_json).put
  ::Io::Flow::V0::Models::Membership.new(r)
end