Getting asset details.

22Aug2011 Posted by admin

Retrieve the details of an asset.

Request URL

/asset/$asset_id [GET]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)	Description	Required	Default value	Max. length
asset_id (ALPHA_NUM)	The ID of the asset to retrieve.	Required		-
acl_domain (STRING)	The domain of the user for autohorisation.	Optional		-
acl_group_id[] (ALPHA_NUM)	The group(s), where the current user is in, is used for authorization.	Optional		-
acl_realm (STRING)	The realm of the user for autohorisation.	Optional		-
acl_user_id (ALPHA_NUM)	The current user is used for authorization. The acl_* fields affect the [granted] field in the output, and the parameter "granted" was given the number of records.	Optional		-
is_oai (BOOL)	Generate additonal asset data for OAI output.	Optional	FALSE	-
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		-
show_collections (BOOL)	If true, then include all of the collection information.	Optional	FALSE	-
show_stills (BOOL)	If true, then include all of the still information.	Optional	TRUE	-
tag (STRING)	Include tag to search on mediafiles of the specified asset.	Optional		-
user_id (ALPHA_NUM)	Alias for acl_user_id parameter. Warning: is chosen above acl_user_id when both are used.	Optional		-
view_hidden_metadata (BOOL)	View hidden metadata.	Optional	FALSE	-

Example Request

/asset/VlN2ZDKv9rpsfmBAWpvfiw1zQ6z

Example Response

<items>
  <item id="1">
    <asset_id>M9FyEFTVy0zFzpbOv7DaEH4U</asset_id>
    <app_id>4</app_id>
    <provider_id></provider_id>
    <owner_id>owner</owner_id>
    <group_id></group_id>
    <videotimestamp>2009-06-11 16:07:38</videotimestamp>
    <videotimestampmodified>2009-09-23 14:40:54</videotimestampmodified>
    <play_restriction_start></play_restriction_start>
    <play_restriction_end></play_restriction_end>
    <reference_id></reference_id>
    <isprivate>FALSE</isprivate>
    <mediafile_duration>00:00:45.7</mediafile_duration>
    <mediafile_container_type>asf</mediafile_container_type>
    <is_unappropiate>FALSE</is_unappropiate>
    <is_unappropriate>FALSE</is_unappropriate>
    <is_external>FALSE</is_external>
    <viewed>1631</viewed>
    <played>97</played>
    <is_empty_asset>FALSE</is_empty_asset>
    <is_protected>DOMAIN_REALM</is_protected>
    <has_streamable_mediafiles>FALSE</has_streamable_mediafiles>
    <dublin_core>
      <type></type>
      <format></format>
      <language>nl</language>
      <title>Test title</title>
      <creator></creator>
      <publisher></publisher>
      <subject></subject>
      <description>Test description</description>
      <contributor></contributor>
      <date></date>
      <identifier></identifier>
      <source></source>
      <relation></relation>
      <coverage_temporal></coverage_temporal>
      <coverage_spatial></coverage_spatial>
      <rights></rights>
    </dublin_core>
    <qualified_dublin_core>
      <title_alternative></title_alternative>
      <description_abstract></description_abstract>
      <created></created>
      <issued></issued>
      <hasformat></hasformat>
      <isformatof></isformatof>
      <format_medium></format_medium>
      <format_extent></format_extent>
      <license></license>
      <rightsholder></rightsholder>
      <isreferencedby></isreferencedby>
    </qualified_dublin_core>
    <czp>
      <schemanaam>http://your_wle/</schemanaam>
      <identificatiecode>http://your_wle/asset/M9FyEFTVy0zFzpbOv7DaEH4U</identificatiecode>
      <titel></titel>
      <taal></taal>
      <beschrijving></beschrijving>
      <sleutelwoord></sleutelwoord>
      <aggregatieniveau>niveau</aggregatieniveau>
      <versie>x</versie>
      <status>final</status>
      <soort_leermateriaal>Evaluatie- en toetsmateriaal</soort_leermateriaal>
      <beoogde_eindgebruiker>Auteur</beoogde_eindgebruiker>
      <context>VVE</context>
      <beoogde_leeftijdsgroep></beoogde_leeftijdsgroep>
      <kosten>nee</kosten>
      <auteursrechten>Ja</auteursrechten>
      <omschrijving_rechten>x</omschrijving_rechten>
      <classificatie>x</classificatie>
    </czp>
    <ega_view_url>http://your_ega_view_url/viewasset/M9FyEFTVy0zFzpbOv7DaEH4U</ega_view_url>
    <is_favorite>FALSE</is_favorite>
    <granted>TRUE</granted>
    <vpx_still_url>http://your_vpx/still/Em4fKZU6iiKuuWrgbcQ86vPR</vpx_still_url>
    <ega_still_url>http://your_still_url/M9FyEFTVy0zFzpbOv7DaEH4U</ega_still_url>
    <mediafiles>
      <mediafile id="1">
        <mediafile_id>9PIxRij3YGRgenkyjwOT7zyS</mediafile_id>
        <asset_id>M9FyEFTVy0zFzpbOv7DaEH4U</asset_id>
        <app_id>4</app_id>
        <owner_id>owner</owner_id>
        <group_id></group_id>
        <is_original_file>TRUE</is_original_file>
        <is_downloadable>FALSE</is_downloadable>
        <filename>testfilename.wmv</filename>
        <uri></uri>
        <transcode_profile_id></transcode_profile_id>
        <tool></tool>
        <command></command>
        <file_extension></file_extension>
        <is_protected>FALSE</is_protected>
        <created>2009-09-22 14:42:03</created>
        <changed>2009-09-23 14:40:02</changed>
        <transcode_inherits_acl>FALSE</transcode_inherits_acl>
        <mediafile_source></mediafile_source>
        <tag>test</tag>
        <is_streamable>FALSE</is_streamable>
        <is_still>FALSE</is_still>
        <metadata>
          <video_codec>wmv3</video_codec>
          <colorspace>yuv420p</colorspace>
          <width>384</width>
          <height>288</height>
          <fps>25</fps>
          <audio_codec>wmav2</audio_codec>
          <sample_rate>44100</sample_rate>
          <channels>2</channels>
          <file_duration>00:00:45.7</file_duration>
          <container_type>asf</container_type>
          <bitrate>1023</bitrate>
          <bpp>0.37</bpp>
          <filesize>5851382</filesize>
          <mime_type>video/x-ms-asf</mime_type>
          <created>2009-10-12 16:48:33</created>
          <changed>2009-10-12 16:48:33</changed>
          <is_hinted>FALSE</is_hinted>
          <is_inserted_md>FALSE</is_inserted_md>
        </metadata>
        <ega_download_url></ega_download_url>
        <ega_play_url>http://your_ega_play_url/play/M9FyEFTVy0zFzpbOv7DaEH4U/9PIxRij3YGRgenkyjwOT7zyS/19697</ega_play_url>
        <ega_stream_url>http://your_stream_url/M9FyEFTVy0zFzpbOv7DaEH4U/9PIxRij3YGRgenkyjwOT7zyS/19697</ega_stream_url>
      </mediafile>
      <mediafile id="2">
        <mediafile_id>2vi8R0dDLXyCKE3vC6qYL2bG</mediafile_id>
        <asset_id>M9FyEFTVy0zFzpbOv7DaEH4U</asset_id>
        <app_id>4</app_id>
        <owner_id>owner</owner_id>
        <group_id></group_id>
        <is_original_file>FALSE</is_original_file>
        <is_downloadable>FALSE</is_downloadable>
        <filename>testvideo.flv</filename>
        <uri></uri>
        <transcode_profile_id>2</transcode_profile_id>
        <tool>ffmpeg</tool>
        <command>videobitrate:200000;size:320x240;audiosamplingrate:22050;maintain_aspect_ratio:yes;padding:no</command>
        <file_extension>flv</file_extension>
        <is_protected>FALSE</is_protected>
        <created>2009-09-22 14:42:30</created>
        <changed>2009-09-22 15:19:49</changed>
        <transcode_inherits_acl>FALSE</transcode_inherits_acl>
        <mediafile_source></mediafile_source>
        <tag>transcoded</tag>
        <is_streamable>FALSE</is_streamable>
        <is_still>FALSE</is_still>
        <metadata>
          <video_codec>flv</video_codec>
          <colorspace>yuv420p</colorspace>
          <width>320</width>
          <height>240</height>
          <fps>25</fps>
          <audio_codec>mp3</audio_codec>
          <sample_rate>22050</sample_rate>
          <channels>1</channels>
          <file_duration>00:00:45.6</file_duration>
          <container_type>flv</container_type>
          <bitrate>200</bitrate>
          <bpp>0.1</bpp>
          <filesize>1828989</filesize>
          <mime_type>video/x-flv</mime_type>
          <created>2009-10-12 16:48:33</created>
          <changed>2009-10-12 16:48:33</changed>
          <is_hinted>FALSE</is_hinted>
          <is_inserted_md>TRUE</is_inserted_md>
        </metadata>
        <ega_download_url></ega_download_url>
        <ega_play_url>http://your_ega_play_url/play/M9FyEFTVy0zFzpbOv7DaEH4U/2vi8R0dDLXyCKE3vC6qYL2bG/19697.flv</ega_play_url>
        <ega_stream_url>http://your_stream_url/M9FyEFTVy0zFzpbOv7DaEH4U/2vi8R0dDLXyCKE3vC6qYL2bG/19697.flv</ega_stream_url>
      </mediafile>
    </mediafiles>
  </item>
</items>

Comments

ega_view_url is missing from /asset response

Posted by forgacs on September 20th, 2011 - 16:01

You can set a preview transcode profile id on the client application edit page:
http://your-mediamosa/admin/mediamosa/config/app
Also you can set the "Play proxy url" (for ega_play_url) and "View asset url" (for ega_view_url) on the same page.
According to these you see an ega_play_url or an ega_view_url.

If there is a transcoded mediafile in the asset you requested with the preview transcode profile id, then MediaMosa responses an ega_play_url, otherwise an ega_view_url is in the response.