User.getFavoriteArtists

From MeeMixWiki

Jump to: navigation, search

Contents

Overview

Get user's favorite artists( or events etc ) based on his 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 get favorite artists based on media library created with lib.create.
optional linkType string get favorite artists based on a specific mediaType (e.g, events) submitted with lib.submitArtistLinks.

REST example:

http://ws.shadow.meemix.com:8080/mxws/services/mxws/user.getFavoriteArtists?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:userGetFavoriteArtistsRequest>
     <partnerId>1001</partnerId>
     <partnerKey>...</partnerKey>
     <userId>jim</userId>
     <libId/>
     <linkType>audio</linkType>
   </q0:userGetFavoriteArtistsRequest>
 </soapenv:Body>
</soapenv:Envelope>

Response

<ns1:userGetFavoriteArtistsResponse
   xmlns:ns1="http://ws.meemix.com/mxws/">
   <artists>
       <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>
   </artists>
</ns1:userGetFavoriteArtistsResponse>

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.

Personal tools
        © 2009 MeeMix ltd