HomeAboutRetrieve the still information of a asset.

Retrieve the still information of a asset.

22Aug2011 Posted by admin

Retrieve the complete still list of the given asset ID.

Request URL

/asset/$asset_id/still [GET]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
asset_id (ALPHA_NUM)The asset ID.Required-
user_id (ALPHA_NUM)The user ID and owner of the asset.Required-
acl_domain (STRING)The domain for which the application is made. If specified it is used for authorization. The domain is checked against the acl rules of the media files, if the domain appears in the / acl / domain list, the video is played.Optional-
acl_group_id[] (ALPHA_NUM)Group ID of the person who wants to play the video, can be used for authorization.Optional-
acl_realm (STRING)If specified it is used for authorization.Optional-
autostart (BOOL)Adjust the value of the autostart in object code.OptionalTRUE-
domain (STRING)The domain for which the application is made. If specified it is used for authorization. The domain is checked against the acl rules of the media files, if the domain appears in the / acl / domain list, the video is played.Optional-
duration (INT)Playing length of the video clip in milliseconds. Must be less than 24 hours (86,400,000).Optional-
format (STRING)If response type = still, then it is possble to filter the response to format (eg. 'jpeg').Optional-
group_id[] (ALPHA_NUM)Deprecated. Use acl_group_id instead. Group ID of the person who wants to play the video, can be used for authorization.Optional-
height (INT)The height of the video.Optional-
mediafile_id (ALPHA_NUM)The mediafile ID, is not required when profile_id is used or when response type is still.Optional-
mediamosa_version (MEDIAMOSA_VERSION)Provide the version to get the REST call returned in the format of the specified MediaMosa version. Keep empty or skip to retrieve in current (latest) version. Provide '2' to retrieve the REST call in 2.x format. Or be more specific by providing up to 3 digits; '2.3.0'. This setting will override any setting used by client application or the default setting in MediaMosa.Optional-
original_mediafile_id (ALPHA_NUM)The original mediafile ID.Optional-
profile_id (INT)Play the mediafile which is transcode with {profile_id}. (new since 1.7.0) If {original_mediafile_id} is also given, plays the transcoded file with profile_id= {profile_id} which was transcoded from source file mediafile_id = {original_mediafile_id}Optional-
range (STRING)If response type = still, then it is possible to filter the response to range (to the still order value) (eg. '3', or '3,5,6', or '3, 5-8').Optional-
realm (STRING)If specified it is used for authorization.Optional-
response (STRING)The still response type.
Value (when supplied) must be either "still".		Optionalstill-
size (STRING)If response type = still, then size parameter may filter the response (eg. 150x120).Optional-
start (INT)Start time of the video clip in milliseconds. Must be less than 24 hours (86,400,000)Optional-
still_id (ALPHA_NUM)The still ID.Optional-
tag (STRING)Tag to indentify and search for the mediafile to play.Optional-
width (INT)The width of the video.Optional-

Example Request

asset/2XCvTieR5AnFDWZadHjbM6fl/still?user_id=testuser&mediafile_id=ZWm0J9IuWlfoU7qoeT9LDl9H

Example Response

<items>
  <item id="1">
    <output>http://download.mediamosa.local/still/n2Ybk1bPL6jRgkSSLUiYxfLn</output>
    <content_type></content_type>
    <ticket_id>n2Ybk1bPL6jRgkSSLUiYxfLn</ticket_id>
  </item>
</items>