consumerradarupdate

Updates radar-related consumer's data and refresh real time radar.

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

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

• txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?> 
<consumerradarupdate>
	<consumerid>44</consumerid> 
	<radardescription><![CDATA[AA 999 AA]]></radardescription> 
	<radardescriptioncolor>000000</radardescriptioncolor> 
	<radardescriptionbgcolor>FFFFFF</radardescriptionbgcolor> 
	<radardescriptionbordercolor>FF0000</radardescriptionbordercolor> 
	<time>20101112173025</time> 
</consumerradarupdate>

{
  "consumerradarupdate": {
    "consumerid": "44",
    "radardescription": "AA 999 AA",
    "radardescriptioncolor": "000000",
    "radardescriptionbgcolor": "FFFFFF",
    "radardescriptionbordercolor": "FF0000",
    "time": "20101112173025"
  }
}

Where

• <consumerid> mandatory. The id of the consumer to edit

• <radardescription> optional. The new description that will appear in the radar for that consumer after radar refresh (if the value is empy the consumer's radar will show the CallSign as description). Note that if no value is set for this parameter this field will maintain the previous value

• <radardescriptioncolor> optional. The new color of the description's text that will appear near the consumer's icon in the radar after its refresh. This is expressed in RRGGBB format. Note that if no value is set for this parameter this field will maintain the previous value

• <radardescriptionbgcolor> optional. The new color of the description's background that will appear near the consumer's icon in the radar after its refresh. This is expressed in RRGGBB format. Note that if no value is set for this parameter this field will maintain the previous value

• <radardescriptionbordercolor> optional. The new color of the description's border that will appear near the consumer's icon in the radar after its refresh. This is expressed in RRGGBB format. Note that if no value is set for this parameter this field will maintain the previous value

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

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

Returns a structure like the following:

<?xml version="1.0" encoding="utf-8" ?> 
<furesult>
	<message><![CDATA[ OK ]]></message>
	<rowsUpdated>1</rowsUpdated>
</furesult>

{
  "furesult": {
    "message": " OK ",
    "rowsUpdated": "1"
  }
}