Start/Resume a User's Playback

PUT

/me/player/play

category-player

Start a new context or resume current playback on the user's active device.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.spotify.com/me/player/play' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "context_uri": "string",
    "offset": {},
    "position_ms": 0,
    "uris": [
        "string"
    ]
}'

响应示例

200 - 示例 1

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

请求参数

Query 参数

device_id

可选

The id of the device this command is targeting. If not supplied, the user's currently active device is the target.

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 a user.
The access token must have the user-modify-playback-state scope authorized in order to control playback.

Body 参数application/json

context_uri

string

可选

Spotify URI of the context to play. Valid contexts are albums, artists, playlists. Example: {"context_uri": "spotify:album:1Je1IMUlBXcx1Fz0WE7oPT"}

offset

object

可选

Indicates from where in the context playback should start. Only available when context_uri corresponds to an album or playlist object, or when the uris parameter is used. “position” is zero based and can’t be negative. Example: "offset": {"position": 5} “uri” is a string representing the uri of the item to start at. Example: "offset": {"uri": "spotify:track:1301WleyT98MSxVHPZCA6M"}

position_ms

integer <int32>

可选

Indicates from what position to start playback. Must be a positive number. Passing in a position that is greater than the length of the track will cause the player to start playing the next song.

uris

array[string]

可选

A JSON array of the Spotify track URIs to play. For example: {"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh", "spotify:track:1301WleyT98MSxVHPZCA6M"]}

示例

返回响应

🟢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).

🟢204A completed request will return a `204 NO CONTENT` response code, and then issue the command to the player. Due to the asynchronous nature of the issuance of the command, you should use the [Get Information About The User's Current Playback](https://devel

Pause a User's Playback

Skip User’s Playback To Previous Track