Playlist.getTrack

From MeeMixWiki

Contents 1 Overview 2 Request 3 Response 4 Faults

Overview

Requests the next track on a user`s playlist using userId and playlistId.

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.
required	playlistId	string	the playlistId provided earlier by calling either user.getPlaylists operation or the user.createPlaylistBy* operations.
required	count	integer	How many tracks retrieve in this call.
optional	libId	string	search the track on media library created with lib.create.
optional	linkType	string	search a track on a specific Content Type, created with lib.addLinkType.

REST request example:

http://ws.shadow.meemix.com:8080/mxws/services/mxws/playlist.getTrack?partnerId=1001&partnerKey=...&userId=jim&playlistId=17&count=1

SOAP request example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
   xmlns:q0="http://ws.meemix.com:8080/mxws/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance">
   <soapenv:Body>
       <q0:playlistGetTrackRequest>
           <partnerId>1001</partnerId>
           <partnerKey>...</partnerKey>
           <userId>jim</userId>
           <playlistId>17</playlistId>
           <count>1</count>
       </q0:playlistGetTrackRequest>
   </soapenv:Body>
</soapenv:Envelope>

Response

Returns the next track. See the Track data type page for more information.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Body>
       <playlistGetTrackResponse xmlns:ns1="http://ws.meemix.com:8080/mxws/">
           <track>
               <trackId>6470</trackId>
               <trackName>Midnight Cowboy</trackName>
               <artist>
                   <artistId>374</artistId>
                   <artistName>Faith No More</artistName>
               </artist>
               <album>
                   <albumId>478</albumId>
                   <albumName>Angel Dust</albumName>
               </album>
           </track>
       </playlistGetTrackResponse>
   </soapenv:Body>
</soapenv:Envelope>

Faults

Code	Description
1	Invalid partner ID
2	Invalid partner key
4	Invalid user ID
6	Invalid playlist ID

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