Asset URLs and File Formats

 

GetServiceInfo returns image, download & streaming URL patterns that are required to access media for guest members.

More details on using AssetURLs can be found here.

File formats are also available. Included is a property isdefaultdownload="true" which is the account default for downloads. There is also a property isdefaultdownloadfortype-"true" which is a default for the available types (WAV,AIFF,MP3). These can also be define for members (see Members).


Request:

GET /getserviceinfo/{serviceToken}

Returns service details which include:

AssetURL Element Comment
  Album Art Album image (jpeg)
  Wave Form Track waveform (png)
  Track Stream Access to the track media (format can be defined as mp3 96Kbps or 128Kbps in the admin for specific regions)
  Download Download the specified file format
  Montage Stream Access to the montage media for streaming.
  Montage Wave Form Montage waveform (png)
  Playlist Art Playlist image (jpeg)
  Playlist Category Art playlist category image (jpeg)
  Library Logo Access to the logo for the library at specified dimensions
Trackformats    
  Trackformat The available track file formats

Successful Response:

<responseserviceinfo>

<asseturl

directdownload=”http://download.harvestmedia.net/wsdirectdownload/{downloadtoken}”

trackstream=”http://cf.harvestmedia.net/assets/samples/6168b9200000000000000000de35899ef/{id}”

albummontagestream=”http://cf.harvestmedia.net/assets/samples/montage/6168b9200000000000000000de35899ef/{id}”

albumart=”http://cf.harvestmedia.net/assets/albumart/6168b9200000000000000000de35899ef/{id}/{width}/{height}”

waveform=”http://cf.harvestmedia.net/assets/waveforms/6168b9200000000000000000de35899ef/{id}/{width}/{height}”

montagewaveform=”http://cf.harvestmedia.net/assets/waveforms/montage/6168b9200000000000000000de35899ef/{id}/{width}/{height}”

librarylogo=”http://cf.harvestmedia.net/assets/librarylogo/6168b9200000000000000000de35899ef/{id}/{width}/{height}”

playlistart=”http://cf.harvestmedia.net/assets/playlistart/6168b9200000000000000000de35899ef/{id}/{width}/{height}”

playlistcategoryart=”http://cf.harvestmedia.net/assets/playlistcategoryart/6168b9200000000000000000de35899ef/{id}/{width}/{height}”/>

<trackformats>

<trackformat identifier=”19b8000000dde” extension=”mp3″ bitrate=”320″ samplerate=”44.1″ samplesize=”0″ ismaster=”false” isdefaultdownload="true" isdefaultdownloadfortype-"true"/>

<trackformat identifier=”70200000000607″ extension=”mp3″ bitrate=”128″ samplerate=”44.1″ samplesize=”0″ ismaster=”false” isdefaultdownload="false" isdefaultdownloadfortype-"false"/>

<trackformat identifier=”9900000001e” extension=”aif” bitrate=”0″ samplerate=”48″ samplesize=”16″ ismaster=”false” isdefaultdownload="false" isdefaultdownloadfortype-"true"/>

<trackformat identifier=”3d000000003b” extension=”mp3″ bitrate=”320″ samplerate=”48″ samplesize=”0″ ismaster=”false” isdefaultdownload="false" isdefaultdownloadfortype-"false"/>

<trackformat identifier=”0c000000021″ extension=”wav” bitrate=”0″ samplerate=”0″ samplesize=”0″ ismaster=”true” isdefaultdownload="false" isdefaultdownloadfortype-"true"/>

</trackformats>

</responseserviceinfo>

Error Response:

<responsecode>

 

<error>

<code>5</code>

<description>Invalid Token</description>

</error>

</responsecode>

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Please sign in to leave a comment.