Get the User's Currently Playing Track

{ "context": { "external_urls": { "spotify": "string" }, "href": "string", "type": "string", "uri": "string" }, "currently_playing_type": "string", "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, "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 types in the future by checking against the currently_playing_type field.

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-read-currently-playing and/or user-read-playback-state scope authorized in order to read information.

返回响应

🟢200A successful request will return a `200 OK` response code with a json payload that contains information about the currently playing track or episode and its context (see below). The information returned is for the last known state, which means an inactive

application/json

Body

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.

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.

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 currently playing track or episode and its context (see below). The information returned is for the last known state, which means an inactive

🔴500500