protocol.GetPlaylistsResponse3
This response acts as an acknowledgment to its corresponding request as well as containing a collection of playlists matching your request parameters. There is meta data included prior to the list to indicate the number of results returned as well as the total matching results in the database. This is useful if you have subset the results. There is also meta data relating to slice if slice is used which indicates upper and lower index of the slice in relation to all the data in this context. There is an optional meta data if interested in playlists for certain users and of certain types.
| Parameter | Optional | Max Allowed | DataType | Notes |
|---|---|---|---|---|
| cid | no | 1 | text | client id. used to track origin of any particular message |
| ixs | yes | 1 | indices | start (i0) and end (i1) index inclusive |
| sli | yes | 1 | slice | pivot returned results around matching string (ss) with number of items before (w0) and after (w1) matching string. Contains (li) lower index and (ui) upper index position of slice in relation to all data. Contains (ix) index of matching result thats pivoted around |
| uids | yes | 1 | list of userids | an empty user id signifies any playlist without an id, i.e shared/global ones |
| flt2 | yes | 1 | list of types tp filter | read only, playlist types |
| tn | no | 1 | integer | total number matching request |
| n | no | 1 | integer | number of results returned |
| col | no | 1 | list | list of playlists. |
Example xml:
<siresp>
<cid>Mum</cid>
<fn>
<getPlaylists3>
<ixs>
<i0>0</i0>
<i1>9</i1>
</ixs>
<sli>
<ss>a</ss>
<w0>50</w0>
<w1>50</w1>
<li>29</li>
<ui>55</ui>
<ix>35</ix>
</sli>
<uids>
<uid></uid>
<uid>1</uid>
<uid>2</uid>
</uids>
<flt2>
<ro>1</ro>
<tys>
<ty>0</ty>
<ty>1</ty>
<tys>
</flt2>
<tn>30</tn>
<n>3</n>
<col>
<pl>
<plid>432546325432</plid>
<plnm>Podcasts</plnm>
<trco></trco>
<cv></cv>
<ro>1</ro>
<uid>mum</uid>
</pl>
<pl>
<plid>432546325432</plid>
<plnm>Podcasts</plnm>
<trco></trco>
<cv></cv>
<ro>1</ro>
<uid>mum</uid>
</pl>
<pl>
<plid>432546325432</plid>
<plnm>My Top Rated</plnm>
<trco></trco>
<cv></cv>
<ro>0</ro>
<uid>mum</uid>
</pl>
<pl>
<plid>432546325432</plid>
<plnm>Recently Added</plnm>
<trco></trco>
<cv></cv>
<ro>1</ro>
<uid>mum</uid>
</pl>
</col>
</getPlaylists3>
</fn>
</siresp>