Channel API 1.0

From Livestream » User Guide

Jump to: navigation, search

The Channel API rest service allows you to retrieve specific channel related Information like playlists and clips, in the form of media rss syndication feeds. The thumbnail uri for the clips can also be retrieved using the API. The media rss feeds obtained from the API can be used with Player API to build your custom livestream player to play the clips.

Contents

Audience


This document is intended for programmers who want to write client applications that can access the Channel API. The document provides examples of the supported operations using raw HTTP and XML, along with explanations.


Prerequisites


In order to query the Livestream API you need to have a livestream channel. To create a channel please refer Account API or visit www.livestream.com [1]

Required Knowledge and skills

1. Media RSS

2. Basic understanding of REST

3. Any programming language.

List Playlists


To obtain the list of video-on-demand playlists for a channel send an HTTP GET request to

channel.api.livestream.com/1.0/listplaylists with the following HTTP parameter(s).

HTTP parameters

1. channel - name of the channel

e.g. To retrieve the list of video-on-demand playlists belonging to the channel proshowcase

GET

    
 http://channel.api.livestream.com/1.0/listplaylists?channel=proshowcase

The response returned will be similar to the following RSS xml.

<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:ls="http://channel.api.livestream.com/1.0/"
	version="2.0">
	<channel>
		<ls:totalLibraries>3</ls:totalLibraries>
		<title>Mogulus Pro Showcase</title>
		<link>http://www.livestream.com/proshowcase</link>
		<description />
		<pubDate>Thu, 01 Oct 2009 13:13:42 GMT</pubDate>
		<dc:date>2009-10-01T13:13:42Z</dc:date>

		<image>
			<title>Mogulus Pro Showcase</title>
			<url>http://mogulus-default.s3.amazonaws.com/image-thumbnail.gif</url>
		</image>
		<ls:directory id="9205475006471204305" title="ondemand"
			hasClips="true">
			<ls:directory id="9205475006471204305/4056950833275962776"
				title="HD - 1,700 Kbps (Pro) Samples" hasClips="true" />
			<ls:directory id="9205475006471204305/6845317970224595470"
				title="High - 700 Kbps (Pro) Samples" hasClips="true" />
		</ls:directory>
	</channel>
</rss>

Each directory element (Having id attribute) in the above xml represents a playlist. The id attributes of these elements represents the unique id of the playlist, which can be used to list the clips within the playlist. The xml is organized in such a way to represent the exact directory structure of the playlists. For e.g., In the above example the root playlist (directory) has two sub playlists within it. The attribute hasClips indicates whether a playlist contains clips within it or not. Any request made to listclips using the id belonging to the directory not having clips will result in response with code 404 (Resource Not Found) All the directory elements belongs to livestream namespace having URI http://channel.api.livestream.com with the prefix ls.

The totalLibraries element in the response xml specifies the number of total playlists belonging to the channel.

List Clips


To obtain the list of clips belonging to a playlist of a channel send an HTTP GET request to

channel.api.livestream.com/1.0/listclips with the following HTTP parameter(s).

HTTP parameters

1. channel - name of the channel

2. id - the playlist id. The playlist id can be obtained from List Playlists. (The value of the element guid in the List Playlist response).

e.g. To retrieve the list of clips belonging to the playlist with id 9205475006471204305/4056950833275962776

GET

    
 http://channel.api.livestream.com/1.0/listclips?channel=proshowcase&
 id=9205475006471204305/4056950833275962776

The response returned will be similar to the following media RSS xml.

<rss xmlns:media="http://search.yahoo.com/mrss/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:ls="http://channel.api.livestream.com/1.0/" version="2.0">
	<channel>
		<ls:totalClips>2</ls:totalClips>
		<title>Mogulus Pro Showcase</title>
		<link>http://www.livestream.com/proshowcase</link>
		<description />
		<pubDate>Thu, 10 Sep 2009 11:10:42 GMT</pubDate>
		<dc:date>2009-09-10T11:10:42Z</dc:date>
		<image>
		    <title>
			http://s3.amazonaws.com/mogulus-default/image-thumbnail.gif
		    </title>
		    <url>
			http://s3.amazonaws.com/mogulus-default/image-thumbnail.gif
		    </url>
		</image>
		<item>
			<title>Iron Man Trailer (1,700Kbps)</title>
			<link>flv_3271446087426817161</link>
			<description />
			<pubDate>Thu, 10 Sep 2009 11:10:42 GMT</pubDate>
			<guid>flv_3271446087426817161</guid>
			<dc:date>2009-09-10T11:10:42Z</dc:date>
			<media:keywords />
			<media:thumbnail
				url="http://s3.amazonaws.com/mogulus-user-files
                                     /chproshowcase/2008/10/17/8591abac-bd89-47fd-
                                     bb23-4473816eb0b9_80.jpg"
				width="100" height="100" />
			<media:content duration="149500" type="video/x-flv"
				url="http://www.livestream.com/proshowcase/ondemand
                                     /flv_3271446087426817161" />
		</item>
		<item>
			<title>Quantum of Solace Trailer (1,700Kbps)</title>
			<link>flv_d71a8296-643a-4479-bf12-f5ddb564d37e</link>
			<description />
			<pubDate>Thu, 10 Sep 2009 11:10:42 GMT</pubDate>
			<guid>flv_d71a8296-643a-4479-bf12-f5ddb564d37e</guid>
			<dc:date>2009-09-10T11:10:42Z</dc:date>
			<media:keywords />
			<media:thumbnail
				url="http://s3.amazonaws.com/mogulus-user-files
                                    /chproshowcase/2008/11/26/d71a8296-643a-4479-bf12-
                                    f5ddb564d37e_80.jpg"
				width="100" height="100" />
			<media:content duration="147400" type="video/x-flv"
				url="http://www.livestream.com/proshowcase/ondemand
                                     /flv_d71a8296-643a-4479-bf12-f5ddb564d37e" />
		</item>
	</channel>
</rss>

Where each item element in the above rss feed represents a clip. The guid element within the item element contains the unique identifier value of the clip. If the thumbnail is not available for the clip then the element media:thumbnail will not be present.

The totalClips element is used to show the total number of clips belonging to the playlist.

Latest Clips


To obtain the list of clips belonging to a playlist of a channel in the descending order of the date created of the clip (latest first), Send an HTTP GET request to channel.api.livestream.com/1.0/latestclips with the following HTTP parameter(s).

HTTP parameters

1. channel - name of the channel

2. id - (optional) the playlist id. The playlist id can be obtained from List Playlists. (The value of the element guid in the List Playlist response). This parameter can be omitted to retrieve the latest clips belonging to any playlist for the channel.

There are two optional parameters 'page' and 'maxresults' which can be used for pagination.

3. page - used with maxresults to obtain the required results. The default value is 1.

4. maxresults - then number of results to be in one page. The default value is 10.

For example, If the page is 1 and maxresults in 5, The first 5 latest clips are returned. To get the second set of 5 clips, set page to 2.

e.g. To retrieve the latest clip belonging to playlist with id 9205475006471204305/4056950833275962776 for channel proshowcase

GET

    
 http://channel.api.livestream.com/1.0/latestclips?id=9205475006471204305
 /4056950833275962776&channel=proshowcase&page=1&maxresults=1

The response returned will be similar to the following media RSS xml.

<rss xmlns:media="http://search.yahoo.com/mrss/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:ls="http://channel.api.livestream.com/1.0/" version="2.0">
	<channel>
		<ls:totalClips>2</ls:totalClips>
		<title>Mogulus Pro Showcase</title>
		<link>http://www.livestream.com/proshowcase</link>
		<description />
		<pubDate>Thu, 10 Sep 2009 11:19:27 GMT</pubDate>
		<dc:date>2009-09-10T11:19:27Z</dc:date>
		<image>
			<title>
				http://s3.amazonaws.com/mogulus-default/image-
                                thumbnail.gif
			</title>
			<url>
				http://s3.amazonaws.com/mogulus-default/image-
                                thumbnail.gif
			</url>
		</image>
		<item>
			<title>Iron Man Trailer (1,700Kbps)</title>
			<link>flv_3271446087426817161</link>
			<description />
			<pubDate>Thu, 10 Sep 2009 11:19:27 GMT</pubDate>
			<guid>flv_3271446087426817161</guid>
			<dc:date>2009-09-10T11:19:27Z</dc:date>
			<media:keywords />
			<media:thumbnail
				url="http://s3.amazonaws.com/mogulus-user-files
                                     /chproshowcase/2008/10/17/8591abac-bd89-47fd-
                                     bb23-4473816eb0b9_80.jpg"
				width="100" height="100" />
			<media:content duration="149500" type="video/x-flv"
				url="http://www.livestream.com/proshowcase/ondemand
                                     /flv_3271446087426817161" />
		</item>
	</channel>
</rss>

Where each item element in the above rss feed represents a clip. The guid element within the item element contains the unique identifier value of the clip. If the thumbnail is not available for the clip then the element media:thumbnail will not be present.

The totalClips element is used to show the total number of clips belonging to the playlist. This is useful in pagination. In the above example, There are totally 2 clips within the playlist 9205475006471204305/4056950833275962776 whereas only one was requested through the HTTP request by specifying the parameter maxresult=1.

Search Clips


To obtain the list of clips matching the keyword for a channel, Send an HTTP GET request to channel.api.livestream.com/1.0/searchclips with the following HTTP parameter(s). The keyword is matched against the title,tags and description of the clips.

HTTP parameters

1. channel - name of the channel

2. keyword - the keyword to match

There are two optional parameters 'page' and 'maxresults' which can be used for pagination.

3. page - used with maxresults to obtain the required results. The default value is 1.

4. maxresults - then number of results to be in one page. The default value is 10.

For example, If the page is 1 and maxresults in 5, The first 5 latest clips are returned. To get the second set of 5 clips, set page to 2.

e.g. To retrieve the latest clips matching the keyword mogulus for channel proshowcase

GET

    
http://channel.api.livestream.com/1.0/searchclips?channel=proshowcase&
keyword=mogulus&maxresults=2&page=2 

The response returned will be similar to the following media RSS xml.

<rss xmlns:media="http://search.yahoo.com/mrss/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:ls="http://channel.api.livestream.com/1.0/" version="2.0">
	<channel>
		<ls:totalClips>32</ls:totalClips>
		<title>Mogulus Pro Showcase</title>
		<link>http://www.livestream.com/proshowcase</link>
		<description />
		<pubDate>Thu, 10 Sep 2009 11:22:40 GMT</pubDate>
		<dc:date>2009-09-10T11:22:40Z</dc:date>
		<image>
			<title>
				http://s3.amazonaws.com/mogulus-default/image-
                                thumbnail.gif
			</title>
			<url>
				http://s3.amazonaws.com/mogulus-default/image-
                                thumbnail.gif
			</url>
		</image>
		<item>
			<title>
				Live Show [mogulus] Mon Nov 24 2008 02:34:48 PM
			</title>
			<link>pla_1437316973745899683</link>
			<description />
			<pubDate>Thu, 10 Sep 2009 11:22:40 GMT</pubDate>
			<guid>pla_1437316973745899683</guid>
			<dc:date>2009-09-10T11:22:40Z</dc:date>
			<media:thumbnail
				url="http://s3.amazonaws.com/mogulus-user-files
                                     /chproshowcase/2008/11/24/09465829-b1be-43be-
                                     80b2-8885f87ddac1_20.jpg"
				width="100" height="100" />
			<media:content duration="35733" type="video/x-flv"
				url="http://www.livestream.com/proshowcase/ondemand
                                     /pla_1437316973745899683" />
		</item>
		<item>
			<title>
				Live Show [mogulus] Mon Nov 24 2008 02:27:18 PM
			</title>
			<link>pla_1625174981056159649</link>
			<description />
			<pubDate>Thu, 10 Sep 2009 11:22:40 GMT</pubDate>
			<guid>pla_1625174981056159649</guid>
			<dc:date>2009-09-10T11:22:40Z</dc:date>
			<media:thumbnail
				url="http://s3.amazonaws.com/mogulus-user-files
                                     /chproshowcase/2008/11/24/db95118a-594e-4f14-
                                     a84d-5f149803d4b0_40.jpg"
				width="100" height="100" />
			<media:content duration="62853" type="video/x-flv"
				url="http://www.livestream.com/proshowcase/ondemand 
                                     /pla_1625174981056159649" />
		</item>
	</channel>
</rss>

Where each item element in the above rss feed represents a clip. The guid element within the item element contains the unique identifier value of the clip. If the thumbnail is not available for the clip then the element media:thumbnail will not be present.

The totalClips element is used to show the total number of clips belonging to the playlist. This is useful in pagination. In the above example, There are totally 31 clips matching the keyword mogulus. The clips 3 and 4 from the search results are returned as the maxresults and page are set to 2.

Clip Details


To obtain the details of a clip, Send an HTTP GET request to channel.api.livestream.com/1.0/clipdetails

HTTP parameters

1. channel - name of the channel.

2. id - the clip id. This can be obtained from any of List Clips, Latest Clips, Search Clips(The value of the element guid in the response).

e.g. To retrieve the details of the clip with id pla_1145907244544877845 belonging to the channel proshowcase

GET

    
http://channel.api.livestream.com/1.0/clipdetails?id=pla_1145907244544877845&
channel=proshowcase 

The response returned will be similar to the following media RSS feed

<rss xmlns:media="http://search.yahoo.com/mrss/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:ls="http://channel.api.livestream.com/1.0/" version="2.0">
	<channel>
		<ls:totalClips>1</ls:totalClips>
		<ls:status updatedAt="" />
		<ls:shortName>proshowcase</ls:shortName>
		<ls:dateCreated>2008-10-16 20:59:38.0</ls:dateCreated>
		<ls:isPremium>true</ls:isPremium>
		<ls:isLive>false</ls:isLive>
		<ls:language>English</ls:language>
		<ls:category>Entertainment</ls:category>
		<ls:creator>maxhaot</ls:creator>
		<ls:currentViewerCount>0</ls:currentViewerCount>
		<title>Mogulus Pro Showcase</title>
		<link>http://www.livestream.com/proshowcase</link>
		<description />
		<pubDate>Thu, 10 Sep 2009 11:25:52 GMT</pubDate>
		<dc:date>2009-09-10T11:25:52Z</dc:date>
		<image>
			<title>
				http://s3.amazonaws.com/mogulus-default/image-
                                thumbnail.gif
			</title>
			<url>
				http://s3.amazonaws.com/mogulus-default/image-
                                thumbnail.gif
			</url>
		</image>
		<item>
			<title>
				Live Show [mogulus] Mon Nov 24 2008 04:09:48 PM
			</title>
			<link>pla_1145907244544877845</link>
			<description />
			<pubDate>Thu, 10 Sep 2009 11:25:52 GMT</pubDate>
			<guid>pla_1145907244544877845</guid>
			<dc:date>2009-09-10T11:25:52Z</dc:date>
			<media:thumbnail
				url="http://s3.amazonaws.com/mogulus-user-files
                                     /chproshowcase/2008/11/24/4bbf53dc-9aec-4ebe-
                                     ab41-1da397363e34_1000.jpg"
				width="100" height="100" />
			<media:content duration="1987279" type="video/x-flv"
				url="http://www.livestream.com/proshowcase/ondemand
                                     /pla_1145907244544877845" />
		</item>
	</channel>
</rss>

Channel Information


To obtain the meta data of a channel, Send an HTTP GET request to channel.api.livestream.com/1.0/info

HTTP parameters

1. channel - name of the channel.

e.g. To retrieve the meta data of the channel proshowcase

GET

    
http://channel.api.livestream.com/1.0/info?channel=proshowcase

The response returned will be similar to the following xml

<ls:channel xmlns:ls="http://channel.api.livestream.com/1.0/"
	name="proshowcase">
	<ls:status updatedAt="" />
	<ls:shortName>proshowcase</ls:shortName>
	<ls:title>Mogulus Pro Showcase</ls:title>
	<ls:link>http://www.livestream.com/proshowcase</ls:link>
	<ls:description></ls:description>
	<ls:dateCreated>2008-10-16 20:59:38.0</ls:dateCreated>
	<ls:logoUrl>http://mogulus-default.s3.amazonaws.com/image-thumbnail.gif</ls:logoUrl>
	<ls:isPremium>true</ls:isPremium>
	<ls:isLive>false</ls:isLive>
	<ls:language>English</ls:language>
	<ls:category>Entertainment</ls:category>
	<ls:creator>maxhaot</ls:creator>
	<ls:currentViewerCount>0</ls:currentViewerCount>
	<ls:iphoneUrl>http://xproshowcasex.is.livestream-api.com/livestreamiphone/proshowcase
					/playlist.m3u8</ls:iphoneUrl>
</ls:channel>

shortName specifies the channel name.

title specifies the channel full name.

description specifies the channel description.

dateCreated specifies the channel creation date.

language the channel language.

category the channel category.

logoUrl specifies the channel logo url.

isPremium specifies whether the channel is premium or not.

isLive specifies whether the channel is live or not.

creator specifies the channel owner's username.

currentViewerCount specifies the current viewers for the channel.

iphoneUrl this element exists only if the channel is live and iphone active.

An empty channel element is returned for a non-existing channel

Meta data for the multiple channels can be obtained by sending an HTTP GET request to

channel.api.livestream.com/1.0/channelsinfo

The parameter channel in this case is a comma separated value of channel names

e.g. To retrieve the meta data of the channels proshowcase and livestream

GET

    
http://channel.api.livestream.com/1.0/channelsinfo?channel=proshowcase,livestream

The response returned will be similar to the following xml

<ls:channels xmlns:ls="http://channel.api.livestream.com/1.0/">
	<ls:channel name="proshowcase">
		<ls:status updatedAt="" />
		<ls:shortName>proshowcase</ls:shortName>
		<ls:title>Mogulus Pro Showcase</ls:title>
		<ls:link>http://www.livestream.com/proshowcase</ls:link>
		<ls:description></ls:description>
		<ls:dateCreated>2008-10-16 20:59:38.0</ls:dateCreated>
		<ls:logoUrl>http://mogulus-default.s3.amazonaws.com/image-thumbnail.gif
		</ls:logoUrl>
		<ls:isPremium>true</ls:isPremium>
		<ls:isLive>false</ls:isLive>
		<ls:language>English</ls:language>
		<ls:category>Entertainment</ls:category>
		<ls:creator>maxhaot</ls:creator>
		<ls:currentViewerCount>0</ls:currentViewerCount>
		<ls:ls:iphoneUrl>http://xproshowcasex.is.livestream-api.com/livestreamiphone 
                           /proshowcase/playlist.m3u8</ls:ls:iphoneUrl>
	</ls:channel>
	<ls:channel name="livestream">
		<ls:status updatedAt="" />
		<ls:shortName>livestream</ls:shortName>
		<ls:title>Live Stream Ads</ls:title>
		<ls:link>http://www.livestream.com/livestream</ls:link>
		<ls:description>Live Stream Ads</ls:description>
		<ls:dateCreated>2007-10-29 09:42:28.0</ls:dateCreated>
		<ls:logoUrl>http://mogulus-default.s3.amazonaws.com/image-thumbnail.gif
		</ls:logoUrl>
		<ls:isPremium>false</ls:isPremium>
		<ls:isLive>false</ls:isLive>
		<ls:language>English</ls:language>
		<ls:category>Science & Tech</ls:category>
		<ls:creator>travel</ls:creator>
		<ls:currentViewerCount>0</ls:currentViewerCount>
	</ls:channel>
</ls:channels>

Channel Live Status


To know whether a channel is live or not, Send an HTTP GET request to channel.api.livestream.com/1.0/livestatus

Currently this feature is available only for premium and verified channels.


HTTP parameters

1. channel - name of the channel.

e.g. To retrieve the live updatedAt=""status for channel proshowcase

GET

    
http://channel.api.livestream.com/1.0/livestatus?channel=proshowcase

The response returned will be similar to the following xml

<ls:channel xmlns:ls="http://channel.api.livestream.com/1.0/">
	<ls:status updatedAt="" />
	<ls:isLive>false</ls:isLive>
	<ls:currentViewerCount>0</ls:currentViewerCount>
</ls:channel>


isLive specifies whether a channel is live or not.

currentViewerCount specifies the current viewers for the channel

An empty channel element is returned for a non-existing channel

Live status for the multiple channels can be obtained by sending an HTTP GET request to

channel.api.livestream.com/1.0/channelslivestatus

The parameter channel in this case is a comma separated value of channel names

e.g. To retrieve the live status of the channels proshowcase and livestream

GET

    
http://channel.api.livestream.com/1.0/channelslivestatus?channel=proshowcase,livestream

The response returned will be similar to the following xml

<ls:channels xmlns:ls="http://channel.api.livestream.com/1.0/">
	<ls:channel name="proshowcase">
		<ls:status updatedAt="" />
		<ls:isLive>false</ls:isLive>
		<ls:currentViewerCount>0</ls:currentViewerCount>
	</ls:channel>
	<ls:channel name="livestream">
		<ls:status updatedAt="" />
		<ls:isLive>false</ls:isLive>
		<ls:currentViewerCount>0</ls:currentViewerCount>
	</ls:channel>
</ls:channels>

Thumbnail


To obtain the thumbnail uri of a clip, Send an HTTP GET request to channel.api.livestream.com/1.0/thumbnail

HTTP parameters

1. channel - name of the channel.

2. id - the clip id. This can be obtained from any of List Clips, Latest Clips, Search Clips(The value of the element guid in the response).

3. time - the optional parameter specifying the duration of the video in seconds for which the thumbnail uri is requested. If parameter is not specified then the total duration of the video is considered to retrieve the thumbnail uri.

e.g. To retrieve the thumbnail uri of clip with id pla_1145907244544877845 belonging to the channel proshowcase for the 20th second

GET

    
http://channel.api.livestream.com/1.0/thumbnail?id=pla_1145907244544877845&
channel=proshowcase&time=20

The response returned will be similar to the following simple xml

<response status="200">
	<url>http://mogulus-user-files.s3.amazonaws.com/chproshowcase/2008/11/24/
             4bbf53dc-9aec-4ebe-ab41-1da397363e34_20.jpg</url>
</response>

where text value of the url element is the url location of the thumbnail.

Upcoming Events


To obtain the upcoming events for a channel, Send an HTTP GET request to channel.api.livestream.com/1.0/events

HTTP parameters

1. channel - name of the channel.


e.g. To retrieve the upcoming events for the channel proshowcase

GET

    
http://channel.api.livestream.com/1.0/events?channel=proshowcase

The response returned will be similar to the following simple xml

<ls:events xmlns:ls="http://channel.api.livestream.com/1.0/" >
	<ls:event title="showcase" startDate="2009-10-27 11:25:00.0"
		endDate="2009-10-27 11:43:00.0" />
	<ls:event title="organize" startDate="2009-10-28 11:20:00.0"
		endDate="2009-10-28 11:53:00.0" />
</ls:events>


The events are ordered by their start dates.

Embed



To obtain the embed tags for a Livestream, Send an HTTP GET request to channel.api.livestream.com/1.0/embed

HTTP parameters

1. channel - name of the channel.

2. clip - (optional) The clip id which can be obtained from clipdetails/listclips.

3. width - (optional) The desired width for the player.

3. height - (optional) The desired height for the player.

3. autoplay - (optional) True if the clips has to be played automatically or else false. True by default

3. mute - (optional) True if the clips has to be played without audio on startup. False by default.

e.g. To retrieve the embed tags for the channel proshowcase

GET

    
http://channel.api.livestream.com/1.0/embed?channel=proshowcase

The response returned will be similar to the following simple xml

<object width="500" height="229" id="livestreamPlayer"
	classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000">
	<param name="movie" value="http://static.livestream.com/grid/LSPlayer.swf"></param>
	<param name="flashVars"
		value="channel=proshowcase&autoPlay=true&mute=false"></param>
	<param name="allowScriptAccess" value="always"></param>
	<param name="allowFullScreen" value="true"></param>
	<embed id="livestreamPlayer" src="http://static.livestream.com/grid/LSPlayer.swf"
		flashVars="channel=proshowcase&autoPlay=true&mute=false"
		width="500" height="229" allowScriptAccess="always" allowFullScreen="true"
		type="application/x-shockwave-flash"></embed>
</object>
<div style="font-size: 11px;padding-top:10px;text-align:center;width:px">
	Watch
	<a href="http://livestream.com/" title="live streaming video">live streaming video</a>
	from
	<a href="http://livestream.com/proshowcase" title="Watch proshowcase at livestream.com">proshowcase</a>
	at livestream.com
</div>


Response Codes


The above services in case of invalid requests/ server error will return an xml with the appropriate error code and the message.

The possible error codes are

400

     Bad Request. The request is not understood by the server due to invalid  
     action or invalid parameters.

404

     Not Found. The requested resource (clip, channel, playlist, thumbnail) is not found.

410

     Gone. The channel is deleted.

500

     Internal Server Error. The server encountered an unexpected condition which
     prevented it from fulfilling the request.

Using the Player API


You can find an example of how to use the channel API with the player API here.