API Documentation Encoded Video

Comparing version 7 and version 6 back

URL: http://heywatch.com/encoded_video


h2. Actions


    * [GET] http://heywatch.com/encoded_video/ : retrieve information about all your encoded videos
    * [GET] http://heywatch.com/encoded_video/ID : retrieve information about the encoded video ID
    * [PUT] http://heywatch.com/encoded_video/ID : modify the encoded video ID
    * [DELETE] http://heywatch.com/encoded_video/ID : destroy the encoded video ID

There are other exceptional formats for this resource:

    * bin: get the encoded video in binary format (download)
    * jpg: get the encoded video thumbnail
    * rss: get the RSS feed of your encoded videos (Podcast client compliant)

Example response in XML: http://heywatch.com/encoded_video/508.xml [GET]


  
  20960
  
    Mobile MP4
    
  http: //static-1.heywatch.com/683072/zYWzTZB3kD/YouTube_-_Mel_Gibson_on_Grey_s_Anatomy.mp4
  508
  Fri Oct 27 01:08:17 CEST 2006



h2. Valid parameters for PUT


    * title: title of the encoded video


h2. Thumbnail generation

You can generate a thumbnail with a GET request. Here are the parameters:

* **start:** offset in second
* **width:** width of the image
* **height:** height of the image

"start" must be specified, and "width" _and_ "height" are optionals.
"width" and "height" values must be a multiple of 2.

*Example*

http:// heywatch.com/encoded_video/105477.jpg?start=54&width=640&height=480


This will generate an image at the 54th second with a size of 640x480.

Note that this request returns the binary data directly.