Add Items to a Playlist

POST

/playlists/{playlist_id}/tracks

category-playlists

Add one or more items to a user's playlist.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.spotify.com/playlists//tracks' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "position": 0,
    "uris": [
        "string"
    ]
}'

响应示例

200 - 示例 1

{
  "error": {
    "message": "string",
    "status": 0
  }
}

请求参数

Path 参数

playlist_id

必需

The Spotify ID for the playlist.

Query 参数

position

可选

The position to insert the items, a zero-based index. For example, to insert the items in the first position: position=0; to insert the items in the third position: position=2 . If omitted, the items will be appended to the playlist. Items are added in the order they are listed in the query string or request body.

uris

可选

A comma-separated list of Spotify URIs to add, can be track or episode URIs. For example:
uris=spotify:track:4iV5W9uYEdYUVa79Axb7Rh, spotify:track:1301WleyT98MSxVHPZCA6M, spotify:episode:512ojhOuo1ktJprKbVcKyQ
A maximum of 100 items can be added in one request. Note: it is likely that passing a large number of item URIs as a query parameter will exceed the maximum length of the request URI. When adding a large number of items, it is recommended to pass them in the request body, see below.

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the user.
Adding items to the current user's public playlists requires authorization of the playlist-modify-public scope; adding items to the current user's private playlist (including collaborative playlists) requires the playlist-modify-private scope. See Using Scopes.

Content-Type

必需

Required if URIs are passed in the request body, otherwise ignored. The content type of the request body: application/json

Body 参数application/json

position

integer <int32>

可选

The position to insert the items, a zero-based index. For example, to insert the items in the first position: position=0 ; to insert the items in the third position: position=2. If omitted, the items will be appended to the playlist. Items are added in the order they appear in the uris array. For example: {"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh","spotify:track:1301WleyT98MSxVHPZCA6M"], "position": 3}

uris

array[string]

可选

A JSON array of the Spotify URIs to add. For example:

{"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh","spotify:track:1301WleyT98MSxVHPZCA6M", "spotify:episode:512ojhOuo1ktJprKbVcKyQ"]}

A maximum of 100 items can be added in one request. Note: if the uris parameter is present in the query string, any URIs listed here in the body will be ignored.

示例

返回响应

🟢200成功

application/json

Body

error

object (ErrorObject)

可选

message

string

可选

A short description of the cause of the error.

status

integer <int32>

可选

The HTTP status code (also returned in the response header; see Response Status Codes for more information).

🟢201On success, the HTTP status code in the response header is `201` Created. The response body contains a `snapshot_id` in JSON format. The `snapshot_id` can be used to identify your playlist version in future requests. On error, the header status code is an

Get a Playlist's Items

Reorder or Replace a Playlist's Items