consumercreate

Creates a new consumer.

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

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

  • txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?> 
<consumercreate>
	<description><![CDATA[Fiat Doblo]]></description> 
	<callsign><![CDATA[I1234]]></callsign> 
	<radardescription><![CDATA[AA 999 AA]]></radardescription> 
	<radardescriptioncolor>000000</radardescriptioncolor> 
	<radardescriptionbgcolor>FFFFFF</radardescriptionbgcolor> 
	<radardescriptionbordercolor>FF0000</radardescriptionbordercolor> 
	<time>20101112173025</time> 
</consumercreate>
{
  "consumercreate": {
    "description": "Fiat Doblo",
    "callsign": "I1234",
    "radardescription": "AA 999 AA",
    "radardescriptioncolor": "000000",
    "radardescriptionbgcolor": "FFFFFF",
    "radardescriptionbordercolor": "FF0000",
    "time": "20101112173025"
  }
}

 

Where

  • <description> optional. The consumer description

  • <callsign> mandatory. The consumer callsign

  • <radardescription> optional. The description that will appear in the radar for that consumer (if it is not present the consumer's radar will show the CallSign as description)

  • <radardescriptioncolor> optional. The color of the description's text that will appear near the consumer's icon in the radar. This is expressed in RRGGBB format.

  • <radardescriptionbgcolor> optional. The color of the description's background that will appear near the consumer's icon in the radar. This is expressed in RRGGBB format.

  • <radardescriptionbordercolor> optional. The color of the description's border that will appear near the consumer's icon in the radar. This is expressed in RRGGBB format.

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


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

Returns a structure like the following:

<?xml version="1.0" encoding="utf-8" ?> 
<furesult>
	<message><![CDATA[ OK ]]></message>
	<creationresult>0</creationresult>
	<creationid>44</creationid>
</furesult>
{
  "furesult": {
    "message": " OK ",
    "creationresult": "0",
    "creationid": "44"
  }
}

 

Where

  • <message> contains OK or Error description
  • <creationresult> if the command's result is OK this tag contains:
    • 0 (zero) consumer created correctly
    • 1 (one) consumer not created.
  • <creationid> if the command's result is OK this tag contains the just created new consumer's unique id

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