artikcloud 2.0.0 → 2.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 732690591f46e45397d1dfbf3f85aa563137195d
-  data.tar.gz: 52b4ee9cb8e9223bbd6a628cec7e124a858d66d5
+  metadata.gz: 27bb94b7bdb058454fce957393571c296a64f7f7
+  data.tar.gz: bcd21f9de20efb0b6c0928c422789a787b21aff9
 SHA512:
-  metadata.gz: 5c87ad0e3aca778160bf351392e7b52424e7ec783cdba2e2f4bfa867ca0ad48de85559d535a29c1c05759953e46f954b446f4154e84c4e08e49d668e1337e5c4
-  data.tar.gz: d3fc313afe395d695e600c502f89ffc9cf1e7d9ac188a0a090126c9300dae5bb8079dfdc49ebed3add72a48de1170e39be9f73c4fe4241bee112b8a7e180c689
+  metadata.gz: 6eb62eeedf0253870550b05335680033863326296df8a5134fc1df8b5317ba06de4fba3d94f83755488ebc52c2d9874c8326b6e0f37ab096431b17c0a7480c9b
+  data.tar.gz: 2de7e18ae6308ddb3b1289b76a1803934ba271f9478b273cf479bd24a105f6c0c1d78032e84979d4595607c2a6b9b585282e534916f31013391047199fdccc58

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    artikcloud (2.0.0)
-      json (~> 1.4, >= 1.4.6)
-      typhoeus (~> 0.2, >= 0.2.1)
+    artikcloud (2.0.5)
+      json (~> 1.8, >= 1.8.3)
+      typhoeus (~> 1.0, >= 1.0.1)
 
 GEM
   remote: http://rubygems.org/
@@ -19,7 +19,7 @@ GEM
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
     diff-lcs (1.2.5)
-    ethon (0.8.1)
+    ethon (0.9.0)
       ffi (>= 1.3.0)
     ffi (1.9.10)
     hashdiff (0.3.0)
@@ -40,10 +40,10 @@ GEM
     safe_yaml (1.0.4)
     sys-uname (1.0.2)
       ffi (>= 1.0.0)
-    typhoeus (0.8.0)
-      ethon (>= 0.8.0)
-    vcr (2.9.3)
-    webmock (1.24.2)
+    typhoeus (1.1.0)
+      ethon (>= 0.9.0)
+    vcr (3.0.3)
+    webmock (1.24.6)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff
@@ -57,9 +57,9 @@ DEPENDENCIES
   autotest-fsevent (~> 0.2, >= 0.2.11)
   autotest-growl (~> 0.2, >= 0.2.16)
   autotest-rails-pure (~> 4.1, >= 4.1.2)
-  rspec (~> 3.2, >= 3.2.0)
-  vcr (~> 2.9, >= 2.9.3)
-  webmock (~> 1.6, >= 1.6.2)
+  rspec (~> 3.4, >= 3.4.0)
+  vcr (~> 3.0, >= 3.0.1)
+  webmock (~> 1.24, >= 1.24.3)
 
 BUNDLED WITH
-   1.11.2
+   1.12.0

data/README.md

@@ -1,6 +1,8 @@
 ARTIK Cloud Ruby SDK
 ================
 
+[![Build Status](https://travis-ci.org/artikcloud/artikcloud-ruby.svg?branch=master)](https://travis-ci.org/artikcloud/artikcloud-ruby) [![Gem Version](https://badge.fury.io/rb/artikcloud.svg)](https://badge.fury.io/rb/artikcloud)
+
 This SDK helps you connect your Ruby scripts to ARTIK Cloud. The SDK exposes a number of methods to easily execute REST API calls to ARTIK Cloud.
 
 ## Installation
@@ -16,14 +18,15 @@ gem build artikcloud.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./artikcloud-2.0.0.gem
+gem install ./artikcloud-2.0.5.gem
 ```
+(for development, run `gem install --dev ./artikcloud-2.0.5.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'artikcloud', '~> 2.0.0'
+    gem 'artikcloud', '~> 2.0.5'
 
 ### Install from Git
 
@@ -82,6 +85,7 @@ Class | Method | HTTP request | Description
 *ArtikCloud::DevicesApi* | [**delete_device**](docs/DevicesApi.md#delete_device) | **DELETE** /devices/{deviceId} | Delete Device
 *ArtikCloud::DevicesApi* | [**delete_device_token**](docs/DevicesApi.md#delete_device_token) | **DELETE** /devices/{deviceId}/tokens | Delete Device Token
 *ArtikCloud::DevicesApi* | [**get_device**](docs/DevicesApi.md#get_device) | **GET** /devices/{deviceId} | Get Device
+*ArtikCloud::DevicesApi* | [**get_device_presence**](docs/DevicesApi.md#get_device_presence) | **GET** /devices/{deviceId}/presence | Get device presence information
 *ArtikCloud::DevicesApi* | [**get_device_token**](docs/DevicesApi.md#get_device_token) | **GET** /devices/{deviceId}/tokens | Get Device Token
 *ArtikCloud::DevicesApi* | [**update_device**](docs/DevicesApi.md#update_device) | **PUT** /devices/{deviceId} | Update Device
 *ArtikCloud::DevicesApi* | [**update_device_token**](docs/DevicesApi.md#update_device_token) | **PUT** /devices/{deviceId}/tokens | Update Device Token
@@ -89,12 +93,15 @@ Class | Method | HTTP request | Description
 *ArtikCloud::ExportApi* | [**get_export_history**](docs/ExportApi.md#get_export_history) | **GET** /messages/export/history | Get Export History
 *ArtikCloud::ExportApi* | [**get_export_result**](docs/ExportApi.md#get_export_result) | **GET** /messages/export/{exportId}/result | Get Export Result
 *ArtikCloud::ExportApi* | [**get_export_status**](docs/ExportApi.md#get_export_status) | **GET** /messages/export/{exportId}/status | Check Export Status
-*ArtikCloud::MessagesApi* | [**get_aggregates_histogram**](docs/MessagesApi.md#get_aggregates_histogram) | **GET** /messages/analytics/histogram | Get Histogram aggregates
+*ArtikCloud::MessagesApi* | [**get_aggregates_histogram**](docs/MessagesApi.md#get_aggregates_histogram) | **GET** /messages/analytics/histogram | Get Normalized Message Histogram
 *ArtikCloud::MessagesApi* | [**get_field_presence**](docs/MessagesApi.md#get_field_presence) | **GET** /messages/presence | Get normalized message presence
 *ArtikCloud::MessagesApi* | [**get_last_normalized_messages**](docs/MessagesApi.md#get_last_normalized_messages) | **GET** /messages/last | Get Last Normalized Message
 *ArtikCloud::MessagesApi* | [**get_message_aggregates**](docs/MessagesApi.md#get_message_aggregates) | **GET** /messages/analytics/aggregates | Get Normalized Message Aggregates
+*ArtikCloud::MessagesApi* | [**get_message_snapshots**](docs/MessagesApi.md#get_message_snapshots) | **GET** /messages/snapshots | Get Message Snapshots
+*ArtikCloud::MessagesApi* | [**get_normalized_actions**](docs/MessagesApi.md#get_normalized_actions) | **GET** /actions | Get Normalized Actions
 *ArtikCloud::MessagesApi* | [**get_normalized_messages**](docs/MessagesApi.md#get_normalized_messages) | **GET** /messages | Get Normalized Messages
-*ArtikCloud::MessagesApi* | [**send_message_action**](docs/MessagesApi.md#send_message_action) | **POST** /messages | Send Message Action
+*ArtikCloud::MessagesApi* | [**send_actions**](docs/MessagesApi.md#send_actions) | **POST** /actions | Send Actions
+*ArtikCloud::MessagesApi* | [**send_message**](docs/MessagesApi.md#send_message) | **POST** /messages | Send Message
 *ArtikCloud::RegistrationsApi* | [**confirm_user**](docs/RegistrationsApi.md#confirm_user) | **PUT** /devices/registrations/pin | Confirm User
 *ArtikCloud::RegistrationsApi* | [**get_request_status_for_user**](docs/RegistrationsApi.md#get_request_status_for_user) | **GET** /devices/registrations/{requestId}/status | Get Request Status For User
 *ArtikCloud::RegistrationsApi* | [**unregister_device**](docs/RegistrationsApi.md#unregister_device) | **DELETE** /devices/{deviceId}/registrations | Unregister Device
@@ -105,8 +112,9 @@ Class | Method | HTTP request | Description
 *ArtikCloud::TagsApi* | [**get_tag_categories**](docs/TagsApi.md#get_tag_categories) | **GET** /tags/categories | Get all categories
 *ArtikCloud::TagsApi* | [**get_tag_suggestions**](docs/TagsApi.md#get_tag_suggestions) | **GET** /tags/suggestions | Get tag suggestions
 *ArtikCloud::TagsApi* | [**get_tags_by_categories**](docs/TagsApi.md#get_tags_by_categories) | **GET** /tags | Get all tags of categories
-*ArtikCloud::TokensApi* | [**check_token**](docs/TokensApi.md#check_token) | **POST** /checkToken | Check Token
-*ArtikCloud::TokensApi* | [**refresh_token**](docs/TokensApi.md#refresh_token) | **POST** /token | Refresh Token
+*ArtikCloud::TokensApi* | [**check_token**](docs/TokensApi.md#check_token) | **POST** /accounts/checkToken | Check Token
+*ArtikCloud::TokensApi* | [**refresh_token**](docs/TokensApi.md#refresh_token) | **POST** /accounts/token | Refresh Token
+*ArtikCloud::TokensApi* | [**token_info**](docs/TokensApi.md#token_info) | **GET** /accounts/tokenInfo | Token Info
 *ArtikCloud::UsersApi* | [**create_user_properties**](docs/UsersApi.md#create_user_properties) | **POST** /users/{userId}/properties | Create User Application Properties
 *ArtikCloud::UsersApi* | [**delete_user_properties**](docs/UsersApi.md#delete_user_properties) | **DELETE** /users/{userId}/properties | Delete User Application Properties
 *ArtikCloud::UsersApi* | [**get_self**](docs/UsersApi.md#get_self) | **GET** /users/self | Get Current User Profile
@@ -121,10 +129,13 @@ Class | Method | HTTP request | Description
 
  - [ArtikCloud::AckEnvelope](docs/AckEnvelope.md)
  - [ArtikCloud::Acknowledgement](docs/Acknowledgement.md)
+ - [ArtikCloud::Action](docs/Action.md)
+ - [ArtikCloud::ActionArray](docs/ActionArray.md)
  - [ArtikCloud::ActionDetails](docs/ActionDetails.md)
  - [ArtikCloud::ActionDetailsArray](docs/ActionDetailsArray.md)
  - [ArtikCloud::ActionIn](docs/ActionIn.md)
  - [ArtikCloud::ActionOut](docs/ActionOut.md)
+ - [ArtikCloud::Actions](docs/Actions.md)
  - [ArtikCloud::AggregateData](docs/AggregateData.md)
  - [ArtikCloud::AggregatesHistogramData](docs/AggregatesHistogramData.md)
  - [ArtikCloud::AggregatesHistogramResponse](docs/AggregatesHistogramResponse.md)
@@ -167,15 +178,20 @@ Class | Method | HTTP request | Description
  - [ArtikCloud::ManifestPropertiesEnvelope](docs/ManifestPropertiesEnvelope.md)
  - [ArtikCloud::ManifestVersions](docs/ManifestVersions.md)
  - [ArtikCloud::ManifestVersionsEnvelope](docs/ManifestVersionsEnvelope.md)
+ - [ArtikCloud::Message](docs/Message.md)
  - [ArtikCloud::MessageAction](docs/MessageAction.md)
  - [ArtikCloud::MessageID](docs/MessageID.md)
  - [ArtikCloud::MessageIDEnvelope](docs/MessageIDEnvelope.md)
  - [ArtikCloud::MessageIn](docs/MessageIn.md)
  - [ArtikCloud::MessageOut](docs/MessageOut.md)
  - [ArtikCloud::NonEmptyString](docs/NonEmptyString.md)
+ - [ArtikCloud::NormalizedAction](docs/NormalizedAction.md)
+ - [ArtikCloud::NormalizedActionsEnvelope](docs/NormalizedActionsEnvelope.md)
  - [ArtikCloud::NormalizedMessage](docs/NormalizedMessage.md)
  - [ArtikCloud::NormalizedMessagesEnvelope](docs/NormalizedMessagesEnvelope.md)
  - [ArtikCloud::OutputRule](docs/OutputRule.md)
+ - [ArtikCloud::PresenceEnvelope](docs/PresenceEnvelope.md)
+ - [ArtikCloud::PresenceModel](docs/PresenceModel.md)
  - [ArtikCloud::PropertiesEnvelope](docs/PropertiesEnvelope.md)
  - [ArtikCloud::RefreshTokenResponse](docs/RefreshTokenResponse.md)
  - [ArtikCloud::RegisterMessage](docs/RegisterMessage.md)
@@ -186,10 +202,15 @@ Class | Method | HTTP request | Description
  - [ArtikCloud::RuleUpdateInfo](docs/RuleUpdateInfo.md)
  - [ArtikCloud::RuleWarningOutput](docs/RuleWarningOutput.md)
  - [ArtikCloud::RulesEnvelope](docs/RulesEnvelope.md)
+ - [ArtikCloud::SnapshotResponse](docs/SnapshotResponse.md)
+ - [ArtikCloud::SnapshotResponses](docs/SnapshotResponses.md)
+ - [ArtikCloud::SnapshotsResponseEnvelope](docs/SnapshotsResponseEnvelope.md)
  - [ArtikCloud::Tag](docs/Tag.md)
  - [ArtikCloud::TagArray](docs/TagArray.md)
  - [ArtikCloud::TagsEnvelope](docs/TagsEnvelope.md)
  - [ArtikCloud::Token](docs/Token.md)
+ - [ArtikCloud::TokenInfo](docs/TokenInfo.md)
+ - [ArtikCloud::TokenInfoSuccessResponse](docs/TokenInfoSuccessResponse.md)
  - [ArtikCloud::TokenRequest](docs/TokenRequest.md)
  - [ArtikCloud::TokenResponse](docs/TokenResponse.md)
  - [ArtikCloud::UnregisterDeviceResponse](docs/UnregisterDeviceResponse.md)
@@ -198,16 +219,18 @@ Class | Method | HTTP request | Description
  - [ArtikCloud::UserEnvelope](docs/UserEnvelope.md)
  - [ArtikCloud::WebSocketError](docs/WebSocketError.md)
 
+
 ## Documentation for Authorization
 
+
 ### artikcloud_oauth
 
 - **Type**: OAuth
 - **Flow**: implicit
-- **Authorizatoin URL**: https://accounts.artik.cloud/authorize
-- **Scopes**: 
-  - read:artikcloud: Read from Artik Cloud
-  - write:artikcloud: Write from Artik Cloud
+- **Authorization URL**: https://accounts.artik.cloud/authorize
+- **Scopes**:
+  - read:artikcloud: Read from ARTIK Cloud
+  - write:artikcloud: Write from ARTIK Cloud
 
 More about ARTIK Cloud
 -------------------------

data/artikcloud.gemspec

@@ -13,13 +13,12 @@ Gem::Specification.new do |s|
   s.description = "A ruby wrapper for the ArtikCloud REST APIs"
   s.license     = "Apache 2.0"
 
+  s.add_runtime_dependency 'typhoeus', '~> 1.0', '>= 1.0.1'
+  s.add_runtime_dependency 'json', '~> 1.8', '>= 1.8.3'
 
-  s.add_runtime_dependency 'typhoeus', '~> 0.2', '>= 0.2.1'
-  s.add_runtime_dependency 'json', '~> 1.4', '>= 1.4.6'
-
-  s.add_development_dependency 'rspec', '~> 3.2', '>= 3.2.0'
-  s.add_development_dependency 'vcr', '~> 2.9', '>= 2.9.3'
-  s.add_development_dependency 'webmock', '~> 1.6', '>= 1.6.2'
+  s.add_development_dependency 'rspec', '~> 3.4', '>= 3.4.0'
+  s.add_development_dependency 'vcr', '~> 3.0', '>= 3.0.1'
+  s.add_development_dependency 'webmock', '~> 1.24', '>= 1.24.3'
   s.add_development_dependency 'autotest', '~> 4.4', '>= 4.4.6'
   s.add_development_dependency 'autotest-rails-pure', '~> 4.1', '>= 4.1.2'
   s.add_development_dependency 'autotest-growl', '~> 0.2', '>= 0.2.16'

data/docs/Action.md

@@ -0,0 +1,9 @@
+# ArtikCloud::Action
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**name** | **String** | Action name. | [optional] 
+**parameters** | **Hash<String, Object>** | Parameters information | [optional] 
+
+

data/docs/ActionArray.md

@@ -0,0 +1,8 @@
+# ArtikCloud::ActionArray
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**actions** | [**Array<Action>**](Action.md) |  | [optional] 
+
+

data/docs/Actions.md

@@ -0,0 +1,12 @@
+# ArtikCloud::Actions
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | [**ActionArray**](ActionArray.md) |  | [optional] 
+**ddid** | **String** | Destination Device ID. | [optional] 
+**sdid** | **String** | Destination Device ID. | [optional] 
+**ts** | **Integer** | Timestamp (past, present or future). Defaults to current time if not provided. | [optional] 
+**type** | **String** | Type - action. | [optional] [default to "action"]
+
+

data/docs/DeviceTypesApi.md

@@ -22,7 +22,7 @@ Get a Device Type's available manifest versions
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -56,7 +56,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -74,7 +74,7 @@ Retrieves a Device Type
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -108,7 +108,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -126,7 +126,7 @@ Retrieves Device Types
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -168,7 +168,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -186,7 +186,7 @@ Get a Device Type's manifest properties for the latest version.
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -220,7 +220,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -238,7 +238,7 @@ Get a Device Type's manifest properties for a specific version.
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -275,7 +275,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json

data/docs/DevicesApi.md

@@ -8,6 +8,7 @@ Method | HTTP request | Description
 [**delete_device**](DevicesApi.md#delete_device) | **DELETE** /devices/{deviceId} | Delete Device
 [**delete_device_token**](DevicesApi.md#delete_device_token) | **DELETE** /devices/{deviceId}/tokens | Delete Device Token
 [**get_device**](DevicesApi.md#get_device) | **GET** /devices/{deviceId} | Get Device
+[**get_device_presence**](DevicesApi.md#get_device_presence) | **GET** /devices/{deviceId}/presence | Get device presence information
 [**get_device_token**](DevicesApi.md#get_device_token) | **GET** /devices/{deviceId}/tokens | Get Device Token
 [**update_device**](DevicesApi.md#update_device) | **PUT** /devices/{deviceId} | Update Device
 [**update_device_token**](DevicesApi.md#update_device_token) | **PUT** /devices/{deviceId}/tokens | Update Device Token
@@ -24,7 +25,7 @@ Create a device
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -58,7 +59,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: application/json
  - **Accept**: application/json
@@ -76,7 +77,7 @@ Deletes a device
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -110,7 +111,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -128,7 +129,7 @@ Deletes a device's token
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -162,7 +163,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -180,7 +181,7 @@ Retrieves a device
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -214,7 +215,59 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+
+# **get_device_presence**
+> PresenceEnvelope get_device_presence(device_id)
+
+Get device presence information
+
+Return the presence status of the given device along with the time it was last seen
+
+### Example
+```ruby
+# load the gem
+require 'artikcloud'
+# setup authorization
+ArtikCloud.configure do |config|
+  # Configure OAuth2 access token for authorization: artikcloud_oauth
+  config.access_token = 'YOUR ACCESS TOKEN'
+end
+
+api_instance = ArtikCloud::DevicesApi.new
+
+device_id = "device_id_example" # String | Device ID.
+
+
+begin
+  #Get device presence information
+  result = api_instance.get_device_presence(device_id)
+  p result
+rescue ArtikCloud::ApiError => e
+  puts "Exception when calling DevicesApi->get_device_presence: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **device_id** | **String**| Device ID. | 
+
+### Return type
+
+[**PresenceEnvelope**](PresenceEnvelope.md)
+
+### Authorization
+
+[artikcloud_oauth](../README.md#artikcloud_oauth)
+
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -232,7 +285,7 @@ Retrieves a device's token
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -266,7 +319,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -284,7 +337,7 @@ Updates a device
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -321,7 +374,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: application/json
  - **Accept**: application/json
@@ -339,7 +392,7 @@ Updates a device's token
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -373,9 +426,9 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
- - **Content-Type**: application/json
+ - **Content-Type**: text/plain
  - **Accept**: application/json
 
 

data/docs/ExportApi.md

@@ -21,7 +21,7 @@ Export normalized messages. The following input combinations are supported:<br/>
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -55,7 +55,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -73,7 +73,7 @@ Get the history of export requests.
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -101,8 +101,8 @@ end
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **trial_id** | **String**| Filter by trialId. | [optional] 
- **count** | [**Integer**](.md)| Pagination count. | [optional] 
- **offset** | [**Integer**](.md)| Pagination offset. | [optional] 
+ **count** | **Integer**| Pagination count. | [optional] 
+ **offset** | **Integer**| Pagination offset. | [optional] 
 
 ### Return type
 
@@ -112,7 +112,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -130,7 +130,7 @@ Retrieve result of the export query in tgz format. The tar file may contain one
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -164,7 +164,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json
@@ -182,7 +182,7 @@ Check status of the export query.
 ```ruby
 # load the gem
 require 'artikcloud'
-# setup authorization 
+# setup authorization
 ArtikCloud.configure do |config|
   # Configure OAuth2 access token for authorization: artikcloud_oauth
   config.access_token = 'YOUR ACCESS TOKEN'
@@ -216,7 +216,7 @@ Name | Type | Description  | Notes
 
 [artikcloud_oauth](../README.md#artikcloud_oauth)
 
-### HTTP reuqest headers
+### HTTP request headers
 
  - **Content-Type**: Not defined
  - **Accept**: application/json

data/docs/Message.md

@@ -0,0 +1,11 @@
+# ArtikCloud::Message
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**data** | **Hash<String, Object>** |  | [optional] 
+**sdid** | **String** | Source Device ID. | [optional] 
+**ts** | **Integer** | Timestamp (past, present or future). Defaults to current time if not provided. | [optional] 
+**type** | **String** | Type - message. | [optional] [default to "message"]
+
+