Platform API

LogDeviceStatuses

Logs multiple device event details. Details include an event(crash,error,unexpected result) and the device status at the time of the event.

**LogDeviceStatuses** Parameters:
Name	Parameter	Data Type	Required	Description
DeviceStatuses	query	int	Yes	A list of logged event statuses for a device.

**LogDeviceStatus** Parameters:
Name	Parameter	Data Type	Required	Description
ApplianceId	query	Guid	Yes	Guid of the Appliance this Device is logging an event status for.
DeviceId	query	Guid	Yes	Guid representing the saved Device
Latitude	query	double	Yes	The latitude the device was last located at.
Longitude	query	double	Yes	The longitude the device was last located at.
EventName	query	string	No	Name of the event we're logging.
EventDetail1	query	string	No	Details of the event up to (255 char).
EventDetail2	query	string	No	Details of the event up to (255 char).
EventDetail3	query	string	No	Details of the event up to (255 char).
EventDetail4	query	string	No	Details of the event up to (255 char).
EventDetail5	query	string	No	Details of the event up to (255 char).
Orientation	query	string	No	Details of the event up to (255 char).
InternetConnectionStatus	query	string	No	The device internet connection status.
Log	query	string	No	Unlimited text field for logging details of the event.
Event	query	DateTime	No	Date and Time of the event.
IsInPortrait	query	bool	No	True if the device is in portrait mode.
IsInLandscape	query	bool	No	True if the device is in landscape mode.
CellularDataEnabled	query	bool	No	True if cellular data is enabled.
DataRoamingEnabled	query	bool	No	True if data roaming is enabled.
IsNetworkAvailable	query	bool	No	True if the network is available.
CanSendSMS	query	bool	No	True if the device can send an sms.
BatteryCharging	query	bool	No	True if the battery is charging.
BatteryLevel	query	int	No	The amount of battery life left as a percentage.
MediaFileId1	query	Guid	No	The Guid of a saved Media Object.
MediaFileId2	query	Guid	No	The Guid of a saved Media Object.

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /xml/reply/LogDeviceStatuses HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<LogDeviceStatuses xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eros.Subtle.Canvara.WebAPIModel.ServiceModel">
  <DeviceStatuses>
    <LogDeviceStatus>
      <ApplianceId>00000000-0000-0000-0000-000000000000</ApplianceId>
      <BatteryCharging>false</BatteryCharging>
      <BatteryLevel>0</BatteryLevel>
      <CanSendSMS>false</CanSendSMS>
      <CellularDataEnabled>false</CellularDataEnabled>
      <DataRoamingEnabled>false</DataRoamingEnabled>
      <DeviceId>00000000-0000-0000-0000-000000000000</DeviceId>
      <Event>0001-01-01T00:00:00</Event>
      <EventDetail1>String</EventDetail1>
      <EventDetail2>String</EventDetail2>
      <EventDetail3>String</EventDetail3>
      <EventDetail4>String</EventDetail4>
      <EventDetail5>String</EventDetail5>
      <EventName>String</EventName>
      <InternetConnectionStatus>String</InternetConnectionStatus>
      <IsInLandscape>false</IsInLandscape>
      <IsInPortrait>false</IsInPortrait>
      <IsNetworkAvailable>false</IsNetworkAvailable>
      <Latitude>0</Latitude>
      <Log>String</Log>
      <Longitude>0</Longitude>
      <MediaFileId1>00000000-0000-0000-0000-000000000000</MediaFileId1>
      <MediaFileId2>00000000-0000-0000-0000-000000000000</MediaFileId2>
      <Orientation>String</Orientation>
    </LogDeviceStatus>
  </DeviceStatuses>
</LogDeviceStatuses>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ResponseStatus xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.servicestack.net/types">
  <ErrorCode>String</ErrorCode>
  <Message>String</Message>
  <StackTrace>String</StackTrace>
  <Errors>
    <ResponseError>
      <ErrorCode>String</ErrorCode>
      <FieldName>String</FieldName>
      <Message>String</Message>
      <Meta xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>String</d4p1:Key>
          <d4p1:Value>String</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </Meta>
    </ResponseError>
  </Errors>
  <Meta xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringstring>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>String</d2p1:Value>
    </d2p1:KeyValueOfstringstring>
  </Meta>
</ResponseStatus>