Get a User's Available Devices

Get information about a user's available devices.

{ "devices": [ { "id": "string", "is_active": true, "is_private_session": true, "is_restricted": true, "name": "string", "type": "string", "volume_percent": 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-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 the device objects (see below). When no available devices are found, the request will return a 200 OK response with an empty devices list.

application/json

Body

devices

array[object (DeviceObject) {7}]

可选

A list of 0..n Device objects

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.

🔴500500