GET api/v1/bots/sparkbots/{id}
Get a specific ParticleBot by id.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
id | globally unique identifier |
Required |
Body Parameters
None.
Response Information
Resource Description
ParticleBotDtoName | Description | Type | Additional information |
---|---|---|---|
AutoAddDevice | boolean |
None. |
|
TokenExpiresOn | date |
None. |
|
HasTokenExpired | boolean |
None. |
|
ParticleAccount | string |
None. |
|
Devices | Collection of ParticleDeviceSummaryDto |
None. |
|
DeviceTags | Collection of string |
None. |
|
AllowStatusMessageCommands |
Allow status messages to be used to invoke Alexa SmartHome functions |
boolean |
None. |
LimitStatusMessageCommandsToUser |
Only allow status message commands from this member/device (Null allows any member/device). |
globally unique identifier |
None. |
AuthenticationFailCount |
How many authentication failures have been seen |
integer |
None. |
HasError |
If the bot has errors |
boolean |
None. |
StreamingCollectionEnabled |
If the bot should use a stream connection to collect data from the device. |
boolean |
None. |
VariableCollectionEnabled | boolean |
None. |
|
DevicesCheckInterval |
How often the users account should check for new devices |
time interval |
None. |
DefaultMeasurementCollectionInterval |
Default for how often the device should be checked for measurement collection. |
time interval |
None. |
LastSimUpdatedAt |
When the sims were last updated |
date |
None. |
LastCheckedDevicesAt |
When the last devices check occured |
date |
None. |
Id |
User Id |
globally unique identifier |
None. |
Name |
The users name |
string |
None. |
UserName |
UserName (used to login with) |
string |
None. |
FullUserName |
User Id and Account name |
string |
None. |
BotType |
The type of bot. |
string |
None. |
DisplayName |
Users first and last name |
string |
None. |
DevicesCheckIntervalMinutes |
How often the spark account should be checked for new devices. |
integer |
None. |
MeasurementCollectionIntervalMinutes |
How often measurements should be collected from the devices (applies to new devices only). |
integer |
None. |
Links |
Collection of links appropriate for the user |
Collection of LinkDto |
None. |
Actions | Collection of LinkDto |
None. |
|
Description | string |
None. |
|
Enabled | boolean |
None. |
|
Authenticated |
If the bot is authenticated. |
boolean |
None. |
Response Formats
application/json, text/json, application/senml+json
{ "AutoAddDevice": true, "TokenExpiresOn": "2024-12-01T20:59:20.3978201+00:00", "HasTokenExpired": true, "ParticleAccount": "sample string 4", "Devices": [ { "Id": "0b9707a2-93c1-4f54-b1c1-5b7d966abe2c", "UserName": "sample string 2", "ParticleDeviceId": "sample string 3", "ParticleDeviceType": 4, "ParticleDeviceTypeName": "sample string 5", "Name": "sample string 6", "Associated": true, "Links": [], "Actions": [] }, { "Id": "0b9707a2-93c1-4f54-b1c1-5b7d966abe2c", "UserName": "sample string 2", "ParticleDeviceId": "sample string 3", "ParticleDeviceType": 4, "ParticleDeviceTypeName": "sample string 5", "Name": "sample string 6", "Associated": true, "Links": [], "Actions": [] } ], "DeviceTags": [ "sample string 1", "sample string 2" ], "AllowStatusMessageCommands": true, "LimitStatusMessageCommandsToUser": "3cf57917-3c2f-494f-9f65-2398d086b331", "CollectorId": 6, "AuthenticationFailCount": 7, "HasError": true, "StreamingCollectionEnabled": true, "VariableCollectionEnabled": true, "DevicesCheckInterval": "00:00:00.1234567", "DefaultMeasurementCollectionInterval": "00:00:00.1234567", "LastSimUpdatedAt": "2024-12-01T20:59:20.3978201+00:00", "LastCheckedDevicesAt": "2024-12-01T20:59:20.3978201+00:00", "Id": "bdc08122-4aa2-4eca-912d-f9e1ec943d40", "Name": "sample string 15", "UserName": "sample string 16", "FullUserName": "sample string 17", "BotType": "sample string 18", "DisplayName": "sample string 19", "DevicesCheckIntervalMinutes": 20, "MeasurementCollectionIntervalMinutes": 21, "Links": [ { "Href": "sample string 1", "Rel": "sample string 2", "Action": "sample string 3" }, { "Href": "sample string 1", "Rel": "sample string 2", "Action": "sample string 3" } ], "Actions": [ { "Href": "sample string 1", "Rel": "sample string 2", "Action": "sample string 3" }, { "Href": "sample string 1", "Rel": "sample string 2", "Action": "sample string 3" } ], "Description": "sample string 22", "Enabled": true, "Authenticated": true }
application/xml, text/xml
<ParticleBotDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots.SparkBot"> <Actions xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots"> <d2p1:LinkViewModel> <d2p1:Action>sample string 3</d2p1:Action> <d2p1:Href>sample string 1</d2p1:Href> <d2p1:Rel>sample string 2</d2p1:Rel> </d2p1:LinkViewModel> <d2p1:LinkViewModel> <d2p1:Action>sample string 3</d2p1:Action> <d2p1:Href>sample string 1</d2p1:Href> <d2p1:Rel>sample string 2</d2p1:Rel> </d2p1:LinkViewModel> </Actions> <Authenticated xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">true</Authenticated> <BotType xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 18</BotType> <Description xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 22</Description> <DevicesCheckIntervalMinutes xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">20</DevicesCheckIntervalMinutes> <DisplayName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 19</DisplayName> <Enabled xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">true</Enabled> <FullUserName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 17</FullUserName> <Id xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">bdc08122-4aa2-4eca-912d-f9e1ec943d40</Id> <Links xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots"> <d2p1:LinkViewModel> <d2p1:Action>sample string 3</d2p1:Action> <d2p1:Href>sample string 1</d2p1:Href> <d2p1:Rel>sample string 2</d2p1:Rel> </d2p1:LinkViewModel> <d2p1:LinkViewModel> <d2p1:Action>sample string 3</d2p1:Action> <d2p1:Href>sample string 1</d2p1:Href> <d2p1:Rel>sample string 2</d2p1:Rel> </d2p1:LinkViewModel> </Links> <MeasurementCollectionIntervalMinutes xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">21</MeasurementCollectionIntervalMinutes> <Name xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 15</Name> <UserName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 16</UserName> <AllowStatusMessageCommands>true</AllowStatusMessageCommands> <AuthenticationFailCount>7</AuthenticationFailCount> <AutoAddDevice>true</AutoAddDevice> <CollectorId>6</CollectorId> <DefaultMeasurementCollectionInterval>PT0.1234567S</DefaultMeasurementCollectionInterval> <DeviceTags xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d2p1:string>sample string 1</d2p1:string> <d2p1:string>sample string 2</d2p1:string> </DeviceTags> <Devices xmlns:d2p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Bots.Models"> <d2p1:ParticleDeviceSummaryDto> <d2p1:Actions xmlns:d4p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" /> <d2p1:Associated>true</d2p1:Associated> <d2p1:Id>0b9707a2-93c1-4f54-b1c1-5b7d966abe2c</d2p1:Id> <d2p1:Links xmlns:d4p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" /> <d2p1:Name>sample string 6</d2p1:Name> <d2p1:ParticleDeviceId>sample string 3</d2p1:ParticleDeviceId> <d2p1:ParticleDeviceType>4</d2p1:ParticleDeviceType> <d2p1:ParticleDeviceTypeName>sample string 5</d2p1:ParticleDeviceTypeName> <d2p1:UserName>sample string 2</d2p1:UserName> </d2p1:ParticleDeviceSummaryDto> <d2p1:ParticleDeviceSummaryDto> <d2p1:Actions xmlns:d4p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" /> <d2p1:Associated>true</d2p1:Associated> <d2p1:Id>0b9707a2-93c1-4f54-b1c1-5b7d966abe2c</d2p1:Id> <d2p1:Links xmlns:d4p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" /> <d2p1:Name>sample string 6</d2p1:Name> <d2p1:ParticleDeviceId>sample string 3</d2p1:ParticleDeviceId> <d2p1:ParticleDeviceType>4</d2p1:ParticleDeviceType> <d2p1:ParticleDeviceTypeName>sample string 5</d2p1:ParticleDeviceTypeName> <d2p1:UserName>sample string 2</d2p1:UserName> </d2p1:ParticleDeviceSummaryDto> </Devices> <DevicesCheckInterval>PT0.1234567S</DevicesCheckInterval> <HasError>true</HasError> <HasTokenExpired>true</HasTokenExpired> <LastCheckedDevicesAt>2024-12-01T20:59:20.3978201+00:00</LastCheckedDevicesAt> <LastSimUpdatedAt>2024-12-01T20:59:20.3978201+00:00</LastSimUpdatedAt> <LimitStatusMessageCommandsToUser>3cf57917-3c2f-494f-9f65-2398d086b331</LimitStatusMessageCommandsToUser> <ParticleAccount>sample string 4</ParticleAccount> <StreamingCollectionEnabled>true</StreamingCollectionEnabled> <TokenExpiresOn>2024-12-01T20:59:20.3978201+00:00</TokenExpiresOn> <VariableCollectionEnabled>true</VariableCollectionEnabled> </ParticleBotDto>