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:

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