Spotify Web API

Transfer a User's Playback

PUT

/me/player

category-player

Transfer playback to a new device and determine if it should start playing.

请求示例

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.spotify.com/me/player' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw ''

响应示例

200 - 示例 1

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

请求参数

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

device_ids

array[string]

必需

A JSON array containing the ID of the device on which playback should be started/transferred.
For example:{device_ids:["74ASZWbe4lXaubB36ztrGX"]}
Note: Although an array is accepted, only a single device_id is currently supported. Supplying more than one will return 400 Bad Request

play

boolean

可选

true : ensure playback happens on new device.
false or not provided: keep the current playback state.

示例

返回响应

🟢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

修改于 2021-08-02 10:49:34

Get Information About The User's Current Playback

Get the User's Currently Playing Track