导入
授权端点的请求参数
获取有关用于授权的端点所使用的请求参数的信息。
| 查询参数 | 类别 | 类型 | 描述 |
|---|---|---|---|
| client_id | 必需 | 字符串 | 这是与我们的 Spotify 应用关联的客户端 ID。 |
| response_type | 必需 | 字符串 | 其值设置为 code。 |
| redirect_uri | 必需 | 字符串 | 这是我们之前在 Spotify 应用设置中添加到重定向 URI 列表中的地址。 |
| state | 可选 | 字符串 | 用于增强请求的安全性。 |
| scope | 可选 | 字符串 | 定义我们希望访问的用户相关信息。如果未指定，我们将只能访问用户的公开信息，无法对用户的资源进行任何修改。完整的范围列表请参见下一部分。 |
| show_dialog | 可选 | 字符串 | 决定每次请求用户授权码时，用户是否必须重新批准该应用。此参数的可能取值为 TRUE 或 FALSE。 |
| 授权权限范围 | 范围 | 描述 |
|---|---|---|
| 图片上传 | ugc-image-upload | 允许使用用户的 Spotify 账户上传图片。 |
| Spotify Connect | user-modify-playback-state | 允许控制连接到用户账户的设备上的 Spotify 播放器。 |
| user-read-playback-state | 允许读取用户设备上当前播放的内容，同时可获取连接到用户账户的设备信息。 | |
| user-read-currently-playing | 允许读取用户设备上当前播放的内容。 | |
| 关注功能 | user-follow-modify | 允许关注或取消关注艺术家及其他 Spotify 用户。 |
| user-follow-read | 允许查看用户的关注列表。 | |
| 听歌历史 | user-read-recently-played | 允许查看用户最近收听的内容。 |
| user-read-playback-position | 允许读取用户设备上正在播放内容的当前播放位置。 | |
| user-top-read | 允许查看用户的顶级艺术家和歌曲。 | |
| 歌单功能 | playlist-read-collaborative | 可用于访问用户的协作歌单。 |
| playlist-modify-public | 允许修改用户的公开歌单。 | |
| playlist-read-private | 允许查看用户的私密歌单。 | |
| playlist-modify-private | 允许修改用户的私密歌单。 | |
| 播放控制 | app-remote-control | 允许通过另一个应用控制 Spotify 用户账户。 |
| streaming | 允许在其他设备上播放内容。 | |
| 用户信息 | user-read-email | 允许读取用户的电子邮件地址。 |
| user-read-private | 允许访问用户的订阅信息。 | |
| 个人音乐库 | user-library-modify | 允许写入或删除用户“我的音乐”库中的内容。 |
| user-library-read | 允许读取用户“我的音乐”库的内容。 |
| 查询参数 | 类型 | 描述 |
|---|---|---|
| grant_type | 字符串 | 确定我们请求的授权类型。在此情况下，其值为 authorization_code。 |
| code | 字符串 | 该代码由服务器在用户验证后返回。 |
| redirect_uri | 字符串 | 此参数仅用于此端点的 URL 验证。 |
| refresh_token | 字符串 | 该令牌是在请求访问令牌时由服务器返回的。 |
| 查询参数 | 使用刷新令牌获取授权码访问令牌 | 使用用户代码获取授权码访问令牌 | 使用客户端凭证获取访问令牌 |
|---|---|---|---|
| grant_type | 必需 | 必需 | 必需 |
| code | 不需要 | 必需 | 不需要 |
| redirect_uri | 不需要 | 必需 | 不需要 |
| refresh_token | 必需 | 不需要 | 不需要 |
| 头部参数 | 类别 | 类型 | 描述 |
|---|---|---|---|
| Authorization | 必需 | 字符串 | 包含经过 Base64 编码的客户端 ID 和客户端密钥。格式为 Basic encoded(client id:client secret)。 |
| Content-Type | 必需 | 字符串 | 表示发送的数据为表单数据。其值为 application/x-www-form-urlencoded。 |