---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
title: 创建 Spotify 应用并连接 OOMOL
description: 配置自己的 Spotify OAuth 应用，将账号加入白名单，并连接 OOMOL。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/docs/spotify-oauth-app/
markdown_url: https://oomol.com/zh-cn/docs/spotify-oauth-app.md
---

# 创建 Spotify 应用并连接 OOMOL

在 OOMOL 连接 Spotify 需要使用自己的 OAuth 应用。开发模式（Development Mode）要求应用所有者拥有有效的 Spotify Premium 订阅。目前每个开发模式应用最多支持五名授权用户；要连接的账号须加入该应用的用户白名单。

## 1. 创建或打开 Spotify 应用

登录 [Spotify Developer Dashboard](https://developer.spotify.com/dashboard)，创建应用或打开你管理的应用。填写应用名称和描述，在选择要使用的 API 时勾选 **Web API**。

## 2. 填写回调地址

打开 [OOMOL 应用连接](https://console.oomol.com/connections)，找到 Spotify，点击 **添加账号**。复制 OAuth 客户端配置中完整的 **重定向 URI**，将它添加到 Spotify 应用设置的 **Redirect URIs** 中并保存。

原样使用 OOMOL 显示的地址，保留路径和结尾斜杠。Spotify 要求非回环地址使用 HTTPS。

## 3. 将 Spotify 账号加入白名单

在同一个 Spotify 应用中，打开 **Settings → Users Management → Add new user**，填写要连接的账号姓名和 Spotify 邮箱，确认该账号已出现在白名单中。

## 4. 保存凭据并连接

1. 在 Spotify 应用设置中复制 **Client ID**，显示并复制 **Client Secret**。
2. 将它们填入 OOMOL OAuth 客户端配置的同名字段并保存。两个值必须来自同一个应用。
3. 发起连接，登录刚刚加入白名单的 Spotify 账号，并同意授权。
4. 返回 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 官方的[应用配置](https://developer.spotify.com/documentation/web-api/concepts/apps)、[配额模式与用户白名单](https://developer.spotify.com/documentation/web-api/concepts/quota-modes)和[回调地址要求](https://developer.spotify.com/documentation/web-api/concepts/redirect_uri)。