API/Playlist Management Protocol/addTracks

From ickStream Wiki
Jump to: navigation, search

Add new tracks to a previously existing playlist Position to add them at can be specified either as a specific position or they are added at the end of the playlist

Request:

{
    "jsonrpc": 2.0,
    "id": < A unique number used to correlate requests with responses, see JSON-RPC specification for more information >,
    "method": "addTracks",
    "params": {
        "playlistId": < Globally unique identity of the playlist to change >,
        "playlistPos": <Optional, playlist position to add tracks before >
        "items": [
            {
                "id": < Globally unique track identity, for example soundcloud:track:somenicetrack >,
                "type": < Type of item, one of [track|stream] >,
                "text": < Text representation of this track >,
		"sortText": < Optional, if specified it represents the appropriate sorting order >,
                "image": < Optional, URL to an image which represent this item >
                "streamingRefs": [
                    {
                        "format": <format of stream, for example "mp3" >,
			"intermediate": <Optional, true if pointed to a redirected stream >,
			"sampleRate": <Optional, sample rate, for example 44100 >,
			"sampleSize": <Optional, sample size, for example 16 >,
			"channels": <Optional, number of channels, for example 2 >,
			"streamFormatInformation": <Optional, additional format information about the
			                            stream, for example aac container type >
                        "url": Url of this streaming reference >
                    }
                    ...
                ]
                "itemAttributes": {
                    < Model attibute identity >: < Model attribute value >
                }
            },
            ...
        ]
    }
}

Specific Information:

  • If playlistPos is not defined, the tracks are added at the end of the playlist
  • For more details about individual parameters in beneath the track structure see Content Access Protocol findItems method.

Response:

{
    "jsonrpc": 2.0,
    "id": < The request identity >,
    "result": {
        "result": <true if tracks were successfully added >
        "playlistId": < Globally unique identity of the playlist itself >,
    }
}
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox