Playlist.setPulse
From MeeMixWiki
Contents |
Overview
Set the playlist pulse level. For more information about playlist pulse, see the Playlist data type page.
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 the user.getPlaylists operation or the user.createPlaylistBy* operations. |
| required | pulseLevel | int | the playlist pulse level is an integer between 1 and 6. A pulse of 1 will cause the playlist to bring very relaxing tunes, while 6 will bring party time tunes. |
REST request example:
http://ws.shadow.meemix.com:8080/mxws/services/mxws/playlist.setPulse?partnerId=1001&partnerKey=...&userId=jim&playlistId=17&pulseLevel=5
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:playlistSetPulseRequest> <partnerId>1001</partnerId> <partnerKey>...</partnerKey> <userId>jim</userId> <playlistId>17</playlistId> <pulseLevel>5</pulseLevel> </q0:playlistSetPulseRequest> </soapenv:Body> </soapenv:Envelope>
Response
If no faults have been thrown, the playlist pulse was set successfully.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <playlistSetPulseResponse xmlns:ns1="http://ws.meemix.com:8080/mxws/"> <success>true</success> </playlistSetPulseResponse> </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.
