Playlist.unblockTrack
From MeeMixWiki
Contents |
Overview
Unblock a previously blocked track (blocked earlier using the playlist.blockTrack operation).
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. |
| optional | libId | string | unblock track based on media library created with lib.create. Should be used only if using the libTrackId. |
| optional | libTrackId | string | unblock track based on your local track id submitted with lib.submitTrack. |
| optional | trackId | string | the ID of the track to unblock, blocked earlier by calling playlist.blockTrack operation. |
Note: either libTrackID or trackId must be presented in the request. In case you are using libTrackId, libId must be presented as well.
REST request example:
http://ws.shadow.meemix.com:8080/mxws/services/mxws/playlist.unblockTrack?partnerId=1001&partnerKey=...&userId=jim&playlistId=17&trackId=6470
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:playlistUnBlockTrackRequest> <partnerId>1001</partnerId> <partnerKey>...</partnerKey> <userId>jim</userId> <playlistId>17</playlistId> <trackId>6470</trackId> </q0:playlistUnBlockTrackRequest> </soapenv:Body> </soapenv:Envelope>
Response
If no faults have been thrown, the track was unblocked successfully.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <playlistUnBlockTrackResponse xmlns:ns1="http://ws.meemix.com:8080/mxws/"> <success>true</success> </playlistUnBlockTrackResponse> </soapenv:Body> </soapenv:Envelope>
Faults
| Code | Description |
|---|---|
| 1 | Invalid partner ID |
| 2 | Invalid partner key |
| 4 | Invalid user ID |
| 6 | Invalid playlist ID |
| 9 | Invalid track ID |
For a full faults list and example of soapFault please visit the Faults page.
