Pando Developer Tools

Pando:download URL

If you are certain that your users have Pando installed (such as if your application integrates Pando into its installation process), or users have been instructed to install Pando, opening a pando:download link allows your users to one-click download a package using Pando.

Note that if the user does not have Pando installed, either nothing will happen, or an error message will be displayed, depending on the user's operating system and browser settings. Thus, Pando recommends using Pando Package URL's for web links.

Pando one-click download URLs have the following format, where url is the URL to the Pando package:

pando:download?url

For example, the download link for the above package would be:

pando:download?http://cache.pando.com/soapservices/Package/package.pando?
   id=5A4A7B2AE83E0AA3DAF066C28703C6F3132B0633
   &key=3557F2AAD6CEAEC0FB6B1F1E19C7531A116A1C2B209554FC9343F2A6ED9DAC94

When clicked, this link tells Pando to download a package indicated by the Pando Package URL.

Examples

For the above Package URL, a one-click download link would look like:

<a href="pando:download?http://cache.pando.com/soapservices/Package/package.pando?
id=5A4A7B2AE83E0AA3DAF066C28703C6F3132B0633
&key=3557F2AAD6CEAEC0FB6B1F1E19C7531A116A1C2B209554FC9343F2A6ED9DAC94">
CNN: In Case you Missed It for February 12, 2007</a>.

This looks like: CNN: In Case you Missed It for February 12, 2007.

If you like, you can use this download button:

CNN: In Case you Missed It for February 12, 2007<br />
<a href="pando:download?http://cache.pando.com/soapservices/Package/package.pando?
id=5A4A7B2AE83E0AA3DAF066C28703C6F3132B0633
&key=3557F2AAD6CEAEC0FB6B1F1E19C7531A116A1C2B209554FC9343F2A6ED9DAC94">
<img src="http://rss.pando.com/themes/rssvideo/pando_dl_button2.png">
</a>.

This looks like:
CNN: In Case you Missed It for February 12, 2007

You can also use the Package Thumbnail URL to make an image link:

<a href="pando:download?http://cache.pando.com/soapservices/Package/package.pando?
id=5A4A7B2AE83E0AA3DAF066C28703C6F3132B0633
&key=3557F2AAD6CEAEC0FB6B1F1E19C7531A116A1C2B209554FC9343F2A6ED9DAC94">
<img src="http://cache.pando.com/soapservices/SendToWeb?action=thumbnail
&id=5A4A7B2AE83E0AA3DAF066C28703C6F3132B0633"></a>

Which looks like:

Supported Versions

pando:download links are supported in Pando version 0.9.1 and newer.

Important Note

In many cases, using the default "Send-to-IM"-style package URL will provide a better user experience than using the pando:download links. When a user without Pando installed clicks on a pando:download link, nothing happens. When a user without Pando installed clicks on a "Send-to-IM"-style URL, they are sent to a web page explaining that they need Pando to download the package they clicked on and, in some cases, the package will begin downloading automatically upon a successful installation. In either case, users with Pando installed will be able to download the package.