trackiframetoshow

Returns a one-shot token in order to render MyWakes Tracks Gadget.

Here is an example of how the gadget can be displayed in the page:

Tracks viewer

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

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

  • txtParameter field contains a structure like this:

<?xml version="1.0" encoding="utf-8" ?> 
<trackiframetoshow>
	<id>10</id>
	<title>Tracks viewer</title>
	<width>950</width>
	<height>700</height>
	<border>empty</border>
	<map>1</map>
	<lang>en-US</lang>
	<secure>1</secure> 
	<time>20101112173025</time> 
</trackiframetoshow>
{
  "trackiframetoshow": {
    "id": "10",
    "title": "Tracks viewer",
    "width": "950",
    "height": "700",
    "border": "empty",
    "map": "1",
    "lang": "en-US",
    "secure": "1",
    "time": "20101112173025"
  }
}

 

Where

  • <id> mandatory, it is the track ID. It is possible to select many tracks by separating each ID with “,” (comma). Each track Id must be owned by the user who ask the data. In the case ad ID is not owned by the user, the command returns an error.

  • <title> optional. It is the gadget title. Default value is “Tracks viewer”.

  • <width> optional. It is the gadget width. Default value is 950.

  • <height> optional. It is the gadget height. Default value is 700.

  • <border> optional. It is the gadget border. Default value is “empty”. This field can be:

    • empty

    • single

    • blue

    • green

    • red

    • f1

    • f2

    • f3

    • f4

    • f5

    • f6

    • f7

    • f8

    • f9

    • f10

  • <map> optional. It is the map type. Default is 1 (one). It can be:

    • 1 (one) map.

    • 2 satellite.

    • 3 hybrid.

    • 4 terrain.

  • <lang> optional. It is the gadget language. Default value is “en-US”. It can be:

    • en-US for english.

    • it-IT for italian.

    • fr-FR for french.

  • <secure> optional. Sets the communication protocol for returned IFrame. Default value is 2 (two). It can be:

    • 0 (zero) force the IFrame to use http protocol.

    • 1 (one) force the IFrame to use https protocol.

    • 2 returns the IFrame using the same protocol of the “trackiframetoshow” command request.

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


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

Returns a structure like the following:

<?xml version="1.0" encoding="utf-8" ?> 
<furesult> 
	<message><![CDATA[ OK ]]></message>
	<token>669a437b-4fde-44c3-8dd4-2ab2837dd944</token>
	<iframe><![CDATA[ <iframe id="track_gadget_direct" 
		src="https://www.mywakes.com/userspub/trackgadgetdirect.aspx
		?token=669a437b-4fde-44c3-8dd4-2ab2837dd944&la=en-US
		&ty=1&border=empty&width=950&height=700
		&title=Tracks%20viewer" frameborder="0"
		width="950" height="725"></iframe> ]]></iframe>
	<gadgeturl><![CDATA[ https://www.mywakes.com/userspub/user_gadgetshow.aspx
		?token=669a437b-4fde-44c3-8dd4-2ab2837dd944&la=en-US
		&ty=1&title=Tracks%20viewer ]]></gadgeturl>
</furesult>
{
  "furesult": {
    "message": " OK ",
    "token": "669a437b-4fde-44c3-8dd4-2ab2837dd944",
    "iframe": " <iframe id=\"track_gadget_direct\" src=\"https://www.mywakes.com/userspub/trackgadgetdirect.aspx?token=669a437b-4fde-44c3-8dd4-2ab2837dd944&la=en-US&ty=1&border=empty&width=950&height=700&title=Tracks%20viewer\" frameborder=\"0\" width=\"950\" height=\"725\"></iframe> ",
    "gadgeturl": " https://www.mywakes.com/userspub/user_gadgetshow.aspx?token=669a437b-4fde-44c3-8dd4-2ab2837dd944&la=en-US&ty=1&title=Tracks%20viewer "
  }
}

 

Where

  • <message> contains OK or Error description
  • <token> a Unique Identifier that represent the request. Only if <message> is OK
  • <iframe> contains the full code that will render the MyWakes Gadget according to the setting put in input parameters. This string contains also the <iframe> and </iframe> tags. Only if <message> is OK
  • <gadgeturl> contains the URL address used to show the track gadget in desktop applications. Only if <message> is OK

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