trackfriendslist

Returns the list of friends that shared their tracks with the specified user.

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: “trackfriendslist”.

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

  • txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?> 
<trackfriendslist>
	<maxitem>20</maxitem>
	<time>20101112173025</time> 
</trackfriendslist>
{
  "trackfriendslist": {
    "maxitem": "20",
    "time": "20101112173025"
  }
}

 

Where

  • <minitem> optional. Used for paging results. If set returns tracks greater than this value.

  • <maxitem> optional. Used for paging results. If set returns tracks less than this value. Note that order to prevent your system from being flooded with oversized responses, the number of messages that will be returned on a single response is limited to 500.

  • <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:
“trackfriendslist20101112173025xx”


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

Returns a structure like the following:

<?xml version="1.0" encoding="utf-8" ?> 
<furesult>
	<message><![CDATA[ OK ]]></message>
	<items>
		<item>
			<id>8a54781a-fdg5-6788-56gh-7646g8g45678</id>
			<description><![CDATA[Mario]]></description>
			<avatar><![CDATA[http://urlavatar]]></avatar>
			<tottrack>5</tottrack>
			<lasttracktime>20101004163025</lasttracktime>
		</item> 
		<item>
			<id>5j57563h-tnj4-8765-88mn-6846d2n87654</id>
			<description><![CDATA[Giorgio]]></description>
			<avatar><![CDATA[http://urlavatar]]></avatar>
			<tottrack>6</tottrack>
			<lasttracktime>20101004184032</lasttracktime>
		</item>
	</items>
</furesult>
{
  "furesult": {
    "message": " OK ",
    "items": {
      "item": [
        {
          "id": "8a54781a-fdg5-6788-56gh-7646g8g45678",
          "description": "Mario",
          "avatar": "http://urlavatar",
          "tottrack": "5",
          "lasttracktime": "20101004163025"
        },
        {
          "id": "5j57563h-tnj4-8765-88mn-6846d2n87654",
          "description": "Giorgio",
          "avatar": "http://urlavatar",
          "tottrack": "6",
          "lasttracktime": "20101004184032"
        }
      ]
    }
  }
}

 

Where

  • <message> contains OK or Error description
  • <items> if the command has succeeded and <message> is OK this tag exists and contains the list of the track with following node:
    • <item> each element of the list, can be repeated more times and contains the following tags:
      • <id> The Unique Identifier of the friend: necessary to get this friend's tracks
      • <description> Friend's user name
      • <avatar> Friend's avatar URL
      • <tottrack> Friend's total number of tracks
      • <lasttracktime> Last friend's track starting time in yyyyMMddhhmmss format

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

Terms Of Use | Privacy Statement | Company info
  • © Cedac Sistemi srl
  • Head office: Via Toscana, 3 40035 Castiglione dei Pepoli (Italy) Tel.: +39 0534-93811 Fax: +39 0534-93899
  • Branch office: Via del Lavoro, 47 40033 Casalecchio di Reno (Italy)
  • Branch office: Via Parini, 1 40033 Casalecchio di Reno (Italy)
  • Share capital Euro 26,000.00 - Company Register of Bologna / VAT no / fiscal code 01695261204