Class: LosantRest::Me
- Inherits:
-
Object
- Object
- LosantRest::Me
- Defined in:
- lib/losant_rest/me.rb
Overview
Class containing all the actions for the Me Resource
Instance Method Summary collapse
-
#add_recent_item(params = {}) ⇒ Object
Adds an item to a recent item list.
-
#delete(params = {}) ⇒ Object
Deletes the current user.
-
#disable_two_factor_auth(params = {}) ⇒ Object
Disables two factor auth for the current user.
-
#disconnect_github(params = {}) ⇒ Object
Disconnects the user from Github.
-
#disconnect_twitter(params = {}) ⇒ Object
Disconnects the user from Twitter.
-
#enable_two_factor_auth(params = {}) ⇒ Object
Enables two factor auth for the current user.
-
#fetch_recent_items(params = {}) ⇒ Object
Gets a recent item list.
-
#get(params = {}) ⇒ Object
Retrieves information on the current user.
-
#initialize(client) ⇒ Me
constructor
A new instance of Me.
-
#patch(params = {}) ⇒ Object
Updates information about the current user.
-
#payload_counts(params = {}) ⇒ Object
Returns payload counts for the time range specified for all applications the current user owns.
-
#transfer_resources(params = {}) ⇒ Object
Moves resources to a new owner.
-
#verify_email(params = {}) ⇒ Object
Sends an email verification to the user.
Constructor Details
#initialize(client) ⇒ Me
Returns a new instance of Me.
6 7 8 |
# File 'lib/losant_rest/me.rb', line 6 def initialize(client) @client = client end |
Instance Method Details
#add_recent_item(params = {}) ⇒ Object
Adds an item to a recent item list
Parameters:
-
hash data - Object containing recent item info (api.losant.com/#/definitions/recentItem)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Updated recent item list (api.losant.com/#/definitions/recentItemList)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 |
# File 'lib/losant_rest/me.rb', line 24 def add_recent_item(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("data is required") unless params.has_key?(:data) body = params[:data] if params.has_key?(:data) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/recentItems" @client.request( method: :post, path: path, query: query_params, headers: headers, body: body) end |
#delete(params = {}) ⇒ Object
Deletes the current user
Parameters:
-
hash credentials - User authentication credentials (api.losant.com/#/definitions/userCredentials)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - If the user was successfully deleted (api.losant.com/#/definitions/success)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 |
# File 'lib/losant_rest/me.rb', line 62 def delete(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("credentials is required") unless params.has_key?(:credentials) body = params[:credentials] if params.has_key?(:credentials) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/delete" @client.request( method: :post, path: path, query: query_params, headers: headers, body: body) end |
#disable_two_factor_auth(params = {}) ⇒ Object
Disables two factor auth for the current user
Parameters:
-
hash data - Object containing two factor auth properties (api.losant.com/#/definitions/disableTwoFactorAuth)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Updated user information (api.losant.com/#/definitions/me)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 |
# File 'lib/losant_rest/me.rb', line 100 def disable_two_factor_auth(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("data is required") unless params.has_key?(:data) body = params[:data] if params.has_key?(:data) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/disableTwoFactorAuth" @client.request( method: :patch, path: path, query: query_params, headers: headers, body: body) end |
#disconnect_github(params = {}) ⇒ Object
Disconnects the user from Github
Parameters:
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Updated user information (api.losant.com/#/definitions/me)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 |
# File 'lib/losant_rest/me.rb', line 137 def disconnect_github(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/disconnectGithub" @client.request( method: :patch, path: path, query: query_params, headers: headers, body: body) end |
#disconnect_twitter(params = {}) ⇒ Object
Disconnects the user from Twitter
Parameters:
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Updated user information (api.losant.com/#/definitions/me)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 |
# File 'lib/losant_rest/me.rb', line 172 def disconnect_twitter(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/disconnectTwitter" @client.request( method: :patch, path: path, query: query_params, headers: headers, body: body) end |
#enable_two_factor_auth(params = {}) ⇒ Object
Enables two factor auth for the current user
Parameters:
-
hash data - Object containing two factor auth properties (api.losant.com/#/definitions/enableTwoFactorAuth)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Updated user information (api.losant.com/#/definitions/me)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 |
# File 'lib/losant_rest/me.rb', line 208 def enable_two_factor_auth(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("data is required") unless params.has_key?(:data) body = params[:data] if params.has_key?(:data) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/enableTwoFactorAuth" @client.request( method: :patch, path: path, query: query_params, headers: headers, body: body) end |
#fetch_recent_items(params = {}) ⇒ Object
Gets a recent item list
Parameters:
-
string parentId - Parent id of the recent list
-
undefined itemType - Item type to get the recent list of. Accepted values are: application, device, flow, dashboard, organization
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Recent item list (api.losant.com/#/definitions/recentItemList)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 |
# File 'lib/losant_rest/me.rb', line 247 def fetch_recent_items(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("itemType is required") unless params.has_key?(:itemType) query_params[:parentId] = params[:parentId] if params.has_key?(:parentId) query_params[:itemType] = params[:itemType] if params.has_key?(:itemType) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/recentItems" @client.request( method: :get, path: path, query: query_params, headers: headers, body: body) end |
#get(params = {}) ⇒ Object
Retrieves information on the current user
Parameters:
-
undefined includeRecent - Should the user include recent app/dashboard info
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Current user information (api.losant.com/#/definitions/me)
Errors:
285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 |
# File 'lib/losant_rest/me.rb', line 285 def get(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil query_params[:includeRecent] = params[:includeRecent] if params.has_key?(:includeRecent) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me" @client.request( method: :get, path: path, query: query_params, headers: headers, body: body) end |
#patch(params = {}) ⇒ Object
Updates information about the current user
Parameters:
-
hash user - Object containing new user properties (api.losant.com/#/definitions/mePatch)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Updated user information (api.losant.com/#/definitions/me)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 |
# File 'lib/losant_rest/me.rb', line 322 def patch(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("user is required") unless params.has_key?(:user) body = params[:user] if params.has_key?(:user) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me" @client.request( method: :patch, path: path, query: query_params, headers: headers, body: body) end |
#payload_counts(params = {}) ⇒ Object
Returns payload counts for the time range specified for all applications the current user owns
Parameters:
-
string start - Start of range for payload count query (ms since epoch)
-
string end - End of range for payload count query (ms since epoch)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - Payload counts, by type and source (api.losant.com/#/definitions/payloadCounts)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 |
# File 'lib/losant_rest/me.rb', line 361 def payload_counts(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil query_params[:start] = params[:start] if params.has_key?(:start) query_params[:end] = params[:end] if params.has_key?(:end) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/payloadCounts" @client.request( method: :get, path: path, query: query_params, headers: headers, body: body) end |
#transfer_resources(params = {}) ⇒ Object
Moves resources to a new owner
Parameters:
-
hash transfer - Object containing properties of the transfer (api.losant.com/#/definitions/resourceTransfer)
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - If resource transfer was successful (api.losant.com/#/definitions/success)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 |
# File 'lib/losant_rest/me.rb', line 399 def transfer_resources(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil raise ArgumentError.new("transfer is required") unless params.has_key?(:transfer) body = params[:transfer] if params.has_key?(:transfer) headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/transferResources" @client.request( method: :patch, path: path, query: query_params, headers: headers, body: body) end |
#verify_email(params = {}) ⇒ Object
Sends an email verification to the user
Parameters:
-
string losantdomain - Domain scope of request (rarely needed)
-
boolean _actions - Return resource actions in response
-
boolean _links - Return resource link in response
-
boolean _embedded - Return embedded resources in response
Responses:
-
200 - If email verification was successfully sent (api.losant.com/#/definitions/success)
Errors:
-
400 - Error if malformed request (api.losant.com/#/definitions/error)
436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 |
# File 'lib/losant_rest/me.rb', line 436 def verify_email(params = {}) params = Utils.symbolize_hash_keys(params) query_params = { _actions: false, _links: true, _embedded: true } headers = {} body = nil headers[:losantdomain] = params[:losantdomain] if params.has_key?(:losantdomain) query_params[:_actions] = params[:_actions] if params.has_key?(:_actions) query_params[:_links] = params[:_links] if params.has_key?(:_links) query_params[:_embedded] = params[:_embedded] if params.has_key?(:_embedded) path = "/me/verify-email" @client.request( method: :post, path: path, query: query_params, headers: headers, body: body) end |