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"
  }
}

 

Where

  • <message> contains OK or Error description
  • <rowsUpdated> if the command's result is OK this tag contains the number of the consumers successfully updated

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