launch_destination

Launch a user's uploaded video to your destinations.

Explorer

Explore this method

Request URL

http://api.oneload.com/api/v3

HTTP method

GET or POST

Arguments

NOTE: Unless otherwise denoted, strings are limited to 256 UTF-8 encoded characters.

upload_id (integer) - Required

The ID of the uploaded video. This value is returned by list_uploads and upload_video.

Example Response

Note that the response status here indicates only the success or failure of sending the launch command. To see the actual status of the launch to the video site, call the getVideoStatus method.

<?xml version="1.0" encoding="utf-8" ?>
<response stat="ok">
  <status>Success</status>
</response>

Error Codes

Standard error codes plus:

10 : One or more required fields are empty

50 : Uploadid is invalid or does not belong to the user

Example Code

<?
# Your user token
$user_token = '';

# Your partner ID
$partner_id = '';

# Your secret key
$secret_key = '';

# Required uploadid
$upload_id = '';

$method = 'launch_destination';

$now = time();

$apihost = 'http://api.oneload.com/api/v3';


#
# valid values come from listAvailableSites
#
$site_id = '';

$poststring = "date=".$now.
              "&userToken=".urlencode($user_token).
              "&partnerID=".urlencode($partner_id).
              "&uploadid=".$upload_id.
              "&method=".$method;

$hash = sha1($secret_key.$poststring);

$poststring .= "&hash=".$hash;

echo $poststring;
?>

<br /><br />
<form action='<? echo $apihost; ?>' method='post'>
<input type='hidden' name='date' value='<? echo $now; ?>' />
<input type='hidden' name='userToken' value='<? echo $user_token; ?>' />
<input type='hidden' name='partnerID' value='<? echo $partner_id; ?>' />
<input type='hidden' name='uploadid' value='<? echo $upload_id; ?>' />
<input type='hidden' name='method' value='<? echo $method; ?>' />
<input type='hidden' name='hash' value='<? echo $hash; ?>' />
<input type='submit' value='submit!' />
</form>