trackstatus

Returns if exists an open track. If it exists returns also the last received trackpoint date and time.

Command's fields description:

• txtUser1 field is the “username” of MyWakes account.

• txtUser2 field is the “password” of MyWakes account.

• txtCommand field contains the command: “trackstatus”.

• txtFormat optional field specifies txtParameters and response formats. more info.

• txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?> 
<trackstatus>
	<time>20101025183000</time> 
</trackstatus>

{
  "trackstatus": { 
    "time": "20101025183000"
  }
}

Where

• <consumer> optional, it is the consumer Id. If not specified it will be returned the status of non defined user's track.

• <time> mandatory, date and time in UTC. The accepted format is “yyyyMMddhhmmss”.

• txtProvider field must contain the application calling ID and generated characters.

• txtSignature field must contain the signature based on the string made of “Command Name” + “time” + “generated character to 32”.

Looking at the previous example, the string on which calculate the check will be:
“trackstatus20101112173025xxxxxxx”

Therefore the txtProvider field will be:
“76a865d4-fab8-51cd-ba78-2da325f6955axxxxxxx”

Returns a structure like the following:

<?xml version="1.0" encoding="utf-8" ?>
<furesult>
	<message><![CDATA[ OK ]]></message>
	<status>
		<open>1</open>
		<id>12</id>
		<description><![CDATA[track title]]></description>
		<lastpointtime>20101112172943</lastpointtime>
	</status>
</furesult>

{
  "furesult": {
    "message": " OK ",
    "status": {
      "open": "1",
      "id": "12",
      "description": "track title",
      "lastpointtime": "20101112172943"
    }
  }
}

Where

• <message> contains OK or Error description
• <status> it's the consumer status. It is present only if <message> is “OK” and contains the following tags:
• <open> user track's status. Can be:
• 0 (zero) – there are no open tracks
• 1 (one) – the consumer has at least one open track
• <id> if an open track exists contains the track Id. This is required in order to get the track
• <description> if an open track exists contains the track description
• <lastpointtime> if an open track exists contains the <time> of last trackpoint in yyyyMMddhhmmss format. If the data refers to an open track with no trackpoint, this field stil empty.

If MyWakes server returns an error, the format of this answer is described in the error section.