Spotify

简介

Spotify Web API 可以搜索 Spotify 曲库、读取歌曲/专辑/艺人元数据、管理播放列表和用户收藏、控制播放，以及获取个性化推荐。它是基于 Spotify 构建音乐集成的标准方式。

注：上游收录的链接（beta.developer.spotify.com）已过时——当前文档在 developer.spotify.com/documentation/web-api。

认证方式（OAuth）

两种常用流程：

1. Client Credentials——应用级访问，搜索和元数据够用：

curl -X POST "https://accounts.spotify.com/api/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

返回访问令牌（约 1 小时有效），以 Bearer 方式携带：

curl "https://api.spotify.com/v1/search?q=radiohead&type=track&limit=5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

2. Authorization Code——用户级访问（播放列表、收藏、播放控制）。需要引导用户跳转 Spotify 授权页，用授权码换取令牌；refresh token 可长期维持访问。

快速开始

1. 在 Spotify Developer Dashboard 创建开发者账号并注册应用。
2. 记下 Client ID 和 Client Secret。
3. 按需选择上述流程（是否需要用户数据）。
4. 凭据保存在服务端，切勿嵌入前端代码。

速率限制与注意事项

• Web API 本身免费使用；按应用有速率限制（当前数值以官方文档为准）。
• 访问令牌约 1 小时后过期；长会话请用 refresh token（Authorization Code 流程）。
• 播放控制需要 Spotify 处于活跃会话（部分接口需要 Premium）。
• 尊重用户隐私：只申请你真正需要的 scope。

常见问题

Spotify Web API 免费吗？ API 本身免费——只需 Spotify 开发者账号和注册的应用。（部分播放功能需要 Premium 用户账号。）

需要 OAuth 吗？ 是的——Spotify 使用 OAuth 2.0。目录数据用 Client Credentials，用户数据用 Authorization Code。

可以在浏览器直接调用吗？ 不建议——令牌必须保存在服务端，请从后端调用。