The pando:send URL tells Pando to open a Send window. If provided, it will auto-fill the email address and local files so that the user can review the information and send it. It can be used by either web sites or applications.
pando:send?email_address=submissions@videosite.com&files_to_send=c:\Cover.JPG,c:\Video.avi
Both email_address and files_to_send are optional. If they are not provided, they are left blank for the user to fill in. This provides you with the flexibility for many uses:
The pando:send URL's can be used from either a web site or an application.
For example, a web site may want users to send video files to the site using Pando. It could do so by giving a single 'submissions' email address, like this:
pando:send?email_address=submissions@videosite.com
This would open Pando's Send New window, pre-filled to send a package to submissions@videosite.com. The user would simply add the video, and click send. This is much simpler for users than launching Pando, clicking "Send Now", and copying and pasting the email address.
To provide a link on a web page to allow people to send using Pando, here is a sample HTML:
<a href="pando:send?email_address=submissions@videosite.example.com"><img src="http://www.pando.com/sites/developers.pando.com/files/Pando-Me-Button.png"></a>
We recommend that web sites use the above graphic, so that Pando users will be able to tell that you support Pando more easily.
The web site could choose to generate a unique email address for each sender to use, and to implement an automated email processing facility. This is a technique commonly used on photo hosting web sites to allow people to send photo's securely from camera-phones (so that other people can't post photos to your web site). Similarly, this technique would allow people to use Pando to send files into their personal web sites. In this case, the URL would be similar to the above, but with a unique user ID, like this:
pando:send?email_address=12345678@submissions.videosite.com
If you are interested in integrating Pando deliveries into your workflow, you should contact us to discuss the Pando Server Integration Toolkit.
An application that is used to create or organize rich media files (such as a photo organizer, a video editor, etc.) may want to make it easy for users to send the result of their work using Pando. This can be done by adding a button to the application to "Send using Pando" that opens a pando:send URL. This will cause Pando to launch (if it is not already running), and to prepare the sending.
For example, if a video editing application added a "send using Pando" command to its GUI, it could attach the files to Pando by opening an URL like:
pando:send?files_to_send=c:\Cover.JPG,c:\Video.avi
This would bring up a Send New window in Pando, with the cover art and video file pre-attached, so the user could enter the recipient's email address, name the package, and send it.
We recommend using this button:
for sending using Pando, so that Pando users can easily recognize that your application supports Pando.
The following is an example of how a Windows application can open a URL. The application should construct the URL as defined above, and then execute the following with the desired URL replacing the italicized example URL:
ShellExecute(m_hWnd, NULL, "pando:send?files_to_send=c:\Cover.JPG,c:\Video.avi", NULL, NULL, SW_SHOWDEFAULT);
If the application wants to use Pando to package and upload the files, but manage the delivery of the Pando Package URL itself, it can do so using the Pando Client Automation Toolkit.
pando:send links are supported in Pando version 1.4 and newer, Mac OS X and Windows. The files_to_send parameter may work on Mac 1.4, but the email_address parameter does not work in the current Mac version. This will be addressed in a future version of Pando.