创建 Spotify 应用并连接 OOMOL
在 OOMOL 连接 Spotify 需要使用自己的 OAuth 应用。开发模式(Development Mode)要求应用所有者拥有有效的 Spotify Premium 订阅。目前每个开发模式应用最多支持五名授权用户;要连接的账号须加入该应用的用户白名单。
1. 创建或打开 Spotify 应用
登录 Spotify Developer Dashboard,创建应用或打开你管理的应用。填写应用名称和描述,在选择要使用的 API 时勾选 Web API。
2. 填写回调地址
打开 OOMOL 应用连接,找到 Spotify,点击 添加账号。复制 OAuth 客户端配置中完整的 重定向 URI,将它添加到 Spotify 应用设置的 Redirect URIs 中并保存。
原样使用 OOMOL 显示的地址,保留路径和结尾斜杠。Spotify 要求非回环地址使用 HTTPS。
3. 将 Spotify 账号加入白名单
在同一个 Spotify 应用中,打开 Settings → Users Management → Add new user,填写要连接的账号姓名和 Spotify 邮箱,确认该账号已出现在白名单中。
4. 保存凭据并连接
- 在 Spotify 应用设置中复制 Client ID,显示并复制 Client Secret。
- 将它们填入 OOMOL OAuth 客户端配置的同名字段并保存。两个值必须来自同一个应用。
- 发起连接,登录刚刚加入白名单的 Spotify 账号,并同意授权。
- 返回 OOMOL,确认账号显示为已连接。读取 Spotify 个人资料,确认账号正确。
妥善保管 Client Secret。如果此前通过 OOMOL 的共享 Spotify 应用连接,请保存自己的应用凭据后重新授权。
遇到问题时
- “The user is not registered for this application”:检查 OOMOL 中 Client ID 对应应用的用户白名单。账号未在名单中时,Spotify 可能允许登录,随后在 API 请求中返回 403。即使 OOMOL 与 Spotify 使用相同邮箱,账号也不会自动加入白名单。
- 回调地址无效:重新复制 OOMOL 显示的地址,原样保存到 Spotify。
- 连接成功但某个操作不可用:检查 Spotify 的端点访问限制、已授予权限及 Premium 要求。自建应用仍受开发模式限制。
参考 Spotify 官方的应用配置、配额模式与用户白名单和回调地址要求。