Control Panel — API Documentation

This API creates a Playlist of live streams and/or VOD files to be played on a Channel at a scheduled time. The playlist can be configured to play through its list once, or to loop continuously.

DVR applications additionally can set the # of chunks to keep in their playlist and how long to keep the dvr session alive by providing a 'playlist_count' and 'playlist_timeout' or disable dvr using 'enable_dvr'. To edit the dvr settings see stream.dvrsettings api.

You can track viewer session data on your channel from Google Analytics (GA) by providing your GA key. When creating or updating a playlist, all playlists on the same channel will have their GA keys updated.

$request = array(
	'command' => 'channel.addchannel',
	'api_key' => 'APX4GKLM0RKQLSP2FBO1ROPKSSW47DZE',
	'timestamp' => time(),
	'cdn' => 158,
	'app' => 'jb-chorigin', 
	'name' => 'My first playlist',
	'stream' => 'my_channel_stream_name',
	'repeat' => 1,
	'active' => 0,
	'scheduled' => '2014-10-13 15:00:00',
	'videos' => array(                      // optional
		0 => array(
			'video' => 'sestore1/username/path/play_first.mp4',
			'start' => 0,
			'length' => -1,
			'sort_order' => 1
		),
		1 => array(
			'video' => 'sestore1/username/path/play_second.mp4',
			'start' => 0,
			'length' => -1,
			'sort_order' => 2
		),
		
	),
	// DVR settings
	'playlist_count' => 4, // optional
	'playlist_timeout' => 600, // optional
	'enable_dvr' => true, // optional
	
	//Google Analytics
	'ga_key' => '' //optional
);

    //Create request signature
    $json_request = json_encode($request);
    $sig = base64_encode(hash_hmac('sha256', $json_request,
        '8fc8c48da81e6a2a06a9556379bf798af508dc0792497c678b4c3532ba8b637f', true));
    $request['signature'] = $sig;
    $json_request = json_encode($request);
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://api.scaleengine.net/stable/'); // Set the URL
    curl_setopt($ch, CURLOPT_POST, true); // Perform a POST
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // If not set, curl prints output to the browser
    curl_setopt($ch, CURLOPT_HEADER, false); // If set, curl returns headers as part of the data stream
    curl_setopt($ch, CURLOPT_POSTFIELDS, array('json' => $json_request)); //'Json' string or 'PHP' serialized return
    
    //If your PHP host does not have a proper SSL certificate bundle, you will need to turn off SSL Certificate Verification
    //This is dangerous, and should only be done temporarily until a proper certificate bundle can be installed
    //curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); // Turns off verification of the SSL certificate.
    //curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // Turns off verification of the SSL certificate.
    
    $response = curl_exec($ch); //Execute the API Call
    if (!$response) {
        die('Failed to connect to ScaleEngine API');
    }
    
    //Decode the response as an associative array 
    $arrResponse = json_decode($response, true); 
    if ($arrResponse) {
        //Operation completed successfully
        //TODO Add work here
        print_r($arrResponse);
    } else {
        //Operation failed
        echo 'An error occured processing your request:';
        print_r($response);
    }
    	

{
	"message": "channel created",
	"status": "success",
	"id" : 1,
	"videos_not_added" : [{
		1 : "#1: sestore1/username/path/play_second.mp4 - video name invalid",
	}],
	"handle_time":"0.3795 seconds"
}