Get Information About The User's Current Playback

{ "actions": { "interrupting_playback": true, "pausing": true, "resuming": true, "seeking": true, "skipping_next": true, "skipping_prev": true, "toggling_repeat_context": true, "toggling_repeat_track": true, "toggling_shuffle": true, "transferring_playback": true }, "context": { "external_urls": { "spotify": "string" }, "href": "string", "type": "string", "uri": "string" }, "currently_playing_type": "string", "device": { "id": "string", "is_active": true, "is_private_session": true, "is_restricted": true, "name": "string", "type": "string", "volume_percent": 0 }, "is_playing": true, "item": { "album": { "album_group": "string", "album_type": "string", "artists": [ { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "name": "string", "type": "string", "uri": "string" } ], "available_markets": [ "string" ], "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "height": 0, "url": "string", "width": 0 } ], "name": "string", "release_date": "string", "release_date_precision": "string", "restrictions": { "reason": "string" }, "total_tracks": 0, "type": "string", "uri": "string" }, "artists": [ { "external_urls": { "spotify": "string" }, "followers": { "href": "string", "total": 0 }, "genres": [ "string" ], "href": "string", "id": "string", "images": [ { "height": 0, "url": "string", "width": 0 } ], "name": "string", "popularity": 0, "type": "string", "uri": "string" } ], "available_markets": [ "string" ], "disc_number": 0, "duration_ms": 0, "explicit": true, "external_ids": { "ean": "string", "isrc": "string", "upc": "string" }, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "is_local": true, "is_playable": true, "linked_from": { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "type": "string", "uri": "string" }, "name": "string", "popularity": 0, "preview_url": "string", "restrictions": { "reason": "string" }, "track_number": 0, "type": "string", "uri": "string" }, "progress_ms": 0, "repeat_state": "string", "shuffle_state": "string", "timestamp": 0 }

请求参数

Query 参数

market

可选

An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track
Relinking.

additional_types

可选

A comma-separated list of item types that your client supports besides the default track type. Valid types are: track and episode. An unsupported type in the response is expected to be represented as null value in the item field. Note: This parameter was introduced to allow existing clients to maintain their current behaviour and might be deprecated in the future. In addition to providing this parameter, make sure that your client properly handles cases of new

Header 参数

Authorization

必需

A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details.

返回响应

🟢200A successful request will return a `200 OK` response code with a json payload that contains information about the current playback. The information returned is for the last known state, which means an inactive device could be returned if it was the last o

application/json

Body

actions

object (DisallowsObject)

可选

interrupting_playback

boolean

可选

Interrupting playback. Optional field.

pausing

boolean

可选

Pausing. Optional field.

resuming

boolean

可选

Resuming. Optional field.

seeking

boolean

可选

Seeking playback location. Optional field.

skipping_next

boolean

可选

Skipping to the next context. Optional field.

skipping_prev

boolean

可选

Skipping to the previous context. Optional field.

toggling_repeat_context

boolean

可选

Toggling repeat context flag. Optional field.

toggling_repeat_track

boolean

可选

Toggling repeat track flag. Optional field.

toggling_shuffle

boolean

可选

Toggling shuffle flag. Optional field.

transferring_playback

boolean

可选

Transfering playback between devices. Optional field.

context

object (ContextObject)

可选

external_urls

object (ExternalUrlObject)

可选

href

string

可选

A link to the Web API endpoint providing full details of the track.

type

string

可选

The object type, e.g. "artist", "playlist", "album", "show".

uri

string

可选

The Spotify URI for the context.

currently_playing_type

string

可选

The object type of the currently playing item. Can be one of track, episode, ad or unknown.

device

object (DeviceObject)

可选

string

可选

The device ID. This may be null.

is_active

boolean

可选

If this device is the currently active device.

is_private_session

boolean

可选

If this device is currently in a private session.

is_restricted

boolean

可选

Whether controlling this device is restricted. At present if this is "true" then no Web API commands will be accepted by this device.

name

string

可选

The name of the device.

type

string

可选

Device type, such as "computer", "smartphone" or "speaker".

volume_percent

integer <int32>

可选

The current volume in percent. This may be null.

is_playing

boolean

可选

If something is currently playing, return true.

item

可选

The currently playing track or episode. Can be null.

One of

TrackObject

EpisodeObject

album

object

SimplifiedAlbumObject

可选

artists

array[object (ArtistObject) {10}]

可选

The artists who performed the track. Each artist object includes a link in href to more detailed information about the artist.

available_markets

array[string]

可选

A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.

disc_number

integer <int32>

可选

The disc number (usually 1 unless the album consists of more than one disc).

duration_ms

integer <int32>

可选

The track length in milliseconds.

explicit

boolean

可选

Whether or not the track has explicit lyrics ( true = yes it does; false = no it does not OR unknown).

external_ids

object

ExternalIdObject

可选

external_urls

object

ExternalUrlObject

可选

href

string

可选

A link to the Web API endpoint providing full details of the track.

string

可选

The Spotify ID for the track.

is_local

boolean

可选

Whether or not the track is from a local file.

is_playable

boolean

可选

Part of the response when Track Relinking is applied. If true , the track is playable in the given market. Otherwise false.

linked_from

object

LinkedTrackObject

可选

name

string

可选

The name of the track.

popularity

integer <int32>

可选

The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.
The popularity of a track is a value between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.
Generally speaking, songs that are being played a lot now will have a higher popularity than songs that were played a lot in the past. Duplicate tracks (e.g. the same track from a single and an album) are rated independently. Artist and album popularity is derived mathematically from track popularity. Note that the popularity value may lag actual popularity by a few days: the value is not updated in real time.

preview_url

string

可选

A link to a 30 second preview (MP3 format) of the track. Can be null

restrictions

object

TrackRestrictionObject

可选

track_number

integer <int32>

可选

The number of the track. If an album has several discs, the track number is the number on the specified disc.

type

string

可选

The object type: "track".

uri

string

可选

The Spotify URI for the track.

progress_ms

integer <int32>

可选

Progress into the currently playing track or episode. Can be null.

repeat_state

string

可选

off, track, context

shuffle_state

string

可选

If shuffle is on or off.

timestamp

integer <int32>

可选

Unix Millisecond Timestamp when data was fetched.

🟢204A successful request will return a `200 OK` response code with a json payload that contains information about the current playback. The information returned is for the last known state, which means an inactive device could be returned if it was the last o

🔴500500