Spotify Web API
  1. category-player
Spotify Web API
  • category-albums
    • Get Multiple Albums
      GET
    • Get an Album
      GET
    • Get an Album's Tracks
      GET
  • category-artists
    • Get Multiple Artists
      GET
    • Get an Artist
      GET
    • Get an Artist's Albums
      GET
    • Get an Artist's Related Artists
      GET
    • Get an Artist's Top Tracks
      GET
  • category-tracks
    • Get Audio Analysis for a Track
      GET
    • Get Audio Features for Several Tracks
      GET
    • Get Audio Features for a Track
      GET
    • Get Several Tracks
      GET
    • Get a Track
      GET
  • category-browse
    • Get All Categories
    • Get a Category
    • Get a Category's Playlists
    • Get All Featured Playlists
    • Get All New Releases
    • Get Recommendations
    • Get Recommendation Genres
  • category-episodes
    • Get Multiple Episodes
    • Get an Episode
  • category-markets
    • Get Available Markets
  • category-users-profile
    • Get Current User's Profile
    • Get a User's Profile
  • category-library
    • Remove Albums for Current User
    • Get User's Saved Albums
    • Save Albums for Current User
    • Check User's Saved Albums
    • Remove User's Saved Episodes
    • Get User's Saved Episodes
    • Save Episodes for User
    • Check User's Saved Episodes
    • Remove User's Saved Shows
    • Get User's Saved Shows
    • Save Shows for Current User
    • Check User's Saved Shows
    • Remove User's Saved Tracks
    • Get User's Saved Tracks
    • Save Tracks for User
    • Check User's Saved Tracks
  • category-follow
    • Unfollow Artists or Users
    • Get User's Followed Artists
    • Follow Artists or Users
    • Get Following State for Artists/Users
    • Unfollow Playlist
    • Follow a Playlist
    • Check if Users Follow a Playlist
  • category-player
    • Get Information About The User's Current Playback
      GET
    • Transfer a User's Playback
      PUT
    • Get the User's Currently Playing Track
      GET
    • Get a User's Available Devices
      GET
    • Skip User’s Playback To Next Track
      POST
    • Pause a User's Playback
      PUT
    • Start/Resume a User's Playback
      PUT
    • Skip User’s Playback To Previous Track
      POST
    • Add an item to queue
      POST
    • Get Current User's Recently Played Tracks
      GET
    • Set Repeat Mode On User’s Playback
      PUT
    • Seek To Position In Currently Playing Track
      PUT
    • Toggle Shuffle For User’s Playback
      PUT
    • Set Volume For User's Playback
      PUT
  • category-playlists
    • Get a List of Current User's Playlists
    • Get a Playlist
    • Change a Playlist's Details
    • Get a Playlist Cover Image
    • Upload a Custom Playlist Cover Image
    • Remove Items from a Playlist
    • Get a Playlist's Items
    • Add Items to a Playlist
    • Reorder or Replace a Playlist's Items
    • Get a List of a User's Playlists
    • Create a Playlist
  • category-personalization
    • Get a User's Top Artists and Tracks
  • category-search
    • Search for an Item
  • category-shows
    • Get Multiple Shows
    • Get a Show
    • Get a Show's Episodes
  1. category-player

Transfer a User's Playback

PUT
/me/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 '{
    "device_ids": [
        "string"
    ],
    "play": true
}'
响应示例响应示例
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
Built with