User.getFavoriteTracks

From MeeMixWiki

Contents 1 Overview 2 Request 3 Response 4 Faults

Overview

Retrieves the user's favorite tracks (or ringtones, videos etc) based on their music profile in MeeMix.

Request

Parameters:

Required	Name	Type	Description
required	partnerId	string	your assigned partner ID.
required	partnerKey	string	your assigned 32-character partner key.
required	userId	string	unique user ID.
optional	libId	string	the media library to retrieve info from (created before using lib.create).
optional	linkType	string	the type of media items to retrieve (mediaType; e.g., audio, ringtone, video). Default is audio. Media items submitted before using lib.submitTrack.

REST example:

http://ws.shadow.meemix.com:8080/mxws/services/mxws/user.getFavoriteTracks?partnerId=1001&partnerKey=...&userId=jim

SOAP example:

 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:q0="http://ws.meemix.com/mxws/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
   <q0:userGetFavoriteTracksRequest>
     <partnerId>1001</partnerId>
     <partnerKey>...</partnerKey>
     <userId>jim</userId>
     <libId/>
     <linkType>audio</linkType>
   </q0:userGetFavoriteTracksRequest>
 </soapenv:Body>
</soapenv:Envelope>

Response

<ns1:userGetFavoriteTracksResponse
   xmlns:ns1="http://ws.meemix.com/mxws/">
   <tracks>
       <track>
           <trackId>692821</trackId>
           <libTrackId>692821</libTrackId>
           <trackName>One</trackName>
           <duration>473</duration>
           <artist>
               <artistId>241</artistId>
               <libArtistId>241</libArtistId>
               <artistName>Metallica</artistName>
               <links>
                   <link>
                       <linkId>1026114</linkId>
                       <linkType>event</linkType>
                       <linkData>http://tickets.meemix.com/ResultsTicket.aspx?evtid=1026114
                       </linkData>
                   </link>
               </links>
           </artist>
           <album>
               <albumId>46068</albumId>
               <albumName>S & M</albumName>
           </album>
           <links>
               <link>
                   <linkId>592697</linkId>
                   <linkType>ringtone</linkType>
                   <linkData>http://offers.thumbplay.com/offers/Open_Artist_6817/atb3ringtones?thptitle=One&selectedContent=592697&thpartist=Metallica
                   </linkData>
               </link>
               <link>
                   <linkId>337825</linkId>
                   <linkType>video</linkType>
                   <linkData>http://www.youtube.com/v/AWwmIfy0GNE&f=videos&app=youtube_gdata
                   </linkData>
               </link>
           </links>
       </track>
   </tracks>
</ns1:userGetFavoriteTracksResponse>

Faults

Code	Description
1	Invalid partner ID
2	Invalid partner key
4	Invalid user ID
15	Internal server error

For a full faults list and example of soapFault please visit the Faults page.