User.getFavoriteArtists
From MeeMixWiki
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.
