asset/$asset_id/still

17Sep2009 Posted by forgacs

Asking a link to a still

This provides a still for an asset. The asset_id is the obligatory parameter. The result is a URL, that you can use as an image in your HTML code <img src='' />. You can use this link only once.

3.2.1 Request URL

/asset/{asset_id}/still [GET]

3.2.2 Request parameters

Parameter	Format	Description	Method	Obligatory/Option
asset_id	alphanumeric	asset id	URL	obligatory
user_id	string	user id	GET	obligatory
size *	string	The size of the still. Eg. “176x144”	GET	optional
format *	string	The format of the still. Eg. “jpeg”	GET	optional
range *	string	The rande of the still order parameter. Eg. “1,3,5,7-12”	GET	optional

* Size, format and range are exists till version 1.7.

3.2.3 Example request URL

/asset/6c704fbd4ef58f2447fd1a3e7/still?user_id=entree004

3.2.4 Example response

<items>

<output>http://download.vpx.kennisnet.nl/still/MhS3b2rOUdsoYDoUFeBxT8</output>

<content_type></content_type>

      <stills>
        <still_id>FgEKwbQlKzjxx4FCvC5qJwkC</still_id>
        <mediafile_id>SOGsCn8yIYAYlf9LAoP058pr</mediafile_id>
        <asset_id>6c704fbd4ef58f2447fd1a3e7</asset_id>
        <app_id>14</app_id>
        <owner_id>admin</owner_id>
        <filename></filename>
        <width>176</width>
        <height>144</height>
        <filesize>5765</filesize>
        <mime_type>image/jpeg</mime_type>
        <still_time_code>119</still_time_code>
        <still_order>11</still_order>
        <still_format>jpeg</still_format>
        <still_type>SCENE</still_type>
        <still_default>FALSE</still_default>
        <ticket>G85vLXBhOQ5OtW6mL9jn7zY0</ticket>
        <still_ticket>http://vpx/still/G85vLXBhOQ5OtW6mL9jn7zY0</still_ticket>
      </stills>
      <stills>
        <still_id>fkoraodCy3u33QoHamjXk00j</still_id>
        <mediafile_id>SOGsCn8yIYAYlf9LAoP058pr</mediafile_id>
        <asset_id>6c704fbd4ef58f2447fd1a3e7</asset_id>
        <app_id>14</app_id>
        <owner_id>admin</owner_id>
        <filename></filename>
        <width>176</width>
        <height>144</height>
        <filesize>5105</filesize>
        <mime_type>image/jpeg</mime_type>
        <still_time_code>98</still_time_code>
        <still_order>9</still_order>
        <still_format>jpeg</still_format>
        <still_type>SCENE</still_type>
        <still_default>FALSE</still_default>
        <ticket>Lse7dPIa1pT6IcpUY9WrJjdt</ticket>
        <still_ticket>http://vpx/still/Lse7dPIa1pT6IcpUY9WrJjdt</still_ticket>
      </stills>
    </item>

</items>

3.2.5 Response fields

Field	Description
output	Url to the image on the download server (standard)
still_id *	The unique still_id.
mediafile_id *	The id of the mediafile of the still.
asset_id *	The asset_id.
app_id *	The app_id.
owner_id *	The owner_id.
filename *	When the still was uploaded as an image, this is the original filename.
width *	The width of the still.
height *	The height of the still.
filesize *	The file size of the still.
mime_type *	The mime type of the still.
still_time_code *	The time code of the still, when the video was made. Eg. 1 seconds.
still_order *	Still order parameter
still_format *	Still format.
still_type *	How the still was made? Eg. “NORMAL”, “SECOND”, “SCENE”
still_default *	Is the still default?
ticket *	Ticket id.
still_ticket *	The still ticket URL.