From 59241631db3ec9eaa39637be977d005420afd05d Mon Sep 17 00:00:00 2001
From: RedSTARO <822858602@qq.com>
Date: Thu, 26 Feb 2026 20:12:43 +0800
Subject: [PATCH 1/3] feat: add song download url api end point for 302 * This
 will redirect access from
 http://localhost:3000/song/url/v1?id=2756058128&level=exhigh to actual
 resource url

---
 module/song_download_url_v1_302.js | 53 ++++++++++++++++++++++++++++++
 server.js                          |  8 ++++-
 2 files changed, 60 insertions(+), 1 deletion(-)
 create mode 100644 module/song_download_url_v1_302.js

diff --git a/module/song_download_url_v1_302.js b/module/song_download_url_v1_302.js
new file mode 100644
index 0000000..4150832
--- /dev/null
+++ b/module/song_download_url_v1_302.js
@@ -0,0 +1,53 @@
+// 获取客户端歌曲下载链接 - v1
+// 此版本不再采用 br 作为音质区分的标准
+// 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断
+
+const createOption = require('../util/option.js')
+module.exports = async (query, request) => {
+  const data = {
+    id: query.id,
+    immerseType: 'c51',
+    level: query.level,
+  }
+  const response = await request(
+    `/api/song/enhance/download/url/v1`,
+    data,
+    createOption(query),
+  )
+  let url = response?.body?.data?.[0]?.url
+
+  if (!url) {
+    const fallbackData = {
+      ids: `[${query.id}]`,
+      level: query.level,
+      encodeType: 'flac',
+    }
+    if (query.level === 'sky') {
+      fallbackData.immerseType = 'c51'
+    }
+    const fallback = await request(
+      `/api/song/enhance/player/url/v1`,
+      fallbackData,
+      createOption(query),
+    )
+    url = fallback?.body?.data?.[0]?.url
+
+    if (!url) {
+      return fallback
+    }
+
+    return {
+      status: 302,
+      body: '',
+      cookie: fallback.cookie || [],
+      redirectUrl: url,
+    }
+  }
+
+  return {
+    status: 302,
+    body: '',
+    cookie: response.cookie || [],
+    redirectUrl: url,
+  }
+}
diff --git a/server.js b/server.js
index 3bc25ba..56c281d 100644
--- a/server.js
+++ b/server.js
@@ -210,6 +210,7 @@ async function consturctServer(moduleDefs) {
     'daily_signin.js': '/daily_signin',
     'fm_trash.js': '/fm_trash',
     'personal_fm.js': '/personal_fm',
+    'song_download_url_v1_302.js': '/song/url/v1/302',
   }
 
   /**
@@ -221,7 +222,7 @@ async function consturctServer(moduleDefs) {
 
   for (const moduleDef of moduleDefinitions) {
     // Register the route.
-    app.use(moduleDef.route, async (req, res) => {
+    app.all(moduleDef.route, async (req, res) => {
       ;[req.query, req.body].forEach((item) => {
         // item may be undefined (some environments / middlewares).
         // Guard access to avoid "Cannot read properties of undefined (reading 'cookie')".
@@ -307,6 +308,11 @@ async function consturctServer(moduleDefs) {
             }
           }
         }
+        if (moduleResponse.redirectUrl) {
+          res.redirect(moduleResponse.status || 302, moduleResponse.redirectUrl)
+          return
+        }
+
         res.status(moduleResponse.status).send(moduleResponse.body)
       } catch (/** @type {*} */ moduleResponse) {
         logger.error(`${decode(req.originalUrl)}`, {

From 89a70b14d4477c2101f386ed306308d744e6e57b Mon Sep 17 00:00:00 2001
From: RedSTARO <822858602@qq.com>
Date: Sun, 1 Mar 2026 13:48:28 +0800
Subject: [PATCH 2/3] refactor: simplify /song/url/v1/302 call chain

---
 module/{song_download_url_v1_302.js => song_url_v1_302.js} | 0
 server.js                                                  | 1 -
 2 files changed, 1 deletion(-)
 rename module/{song_download_url_v1_302.js => song_url_v1_302.js} (100%)

diff --git a/module/song_download_url_v1_302.js b/module/song_url_v1_302.js
similarity index 100%
rename from module/song_download_url_v1_302.js
rename to module/song_url_v1_302.js
diff --git a/server.js b/server.js
index 56c281d..41838e0 100644
--- a/server.js
+++ b/server.js
@@ -210,7 +210,6 @@ async function consturctServer(moduleDefs) {
     'daily_signin.js': '/daily_signin',
     'fm_trash.js': '/fm_trash',
     'personal_fm.js': '/personal_fm',
-    'song_download_url_v1_302.js': '/song/url/v1/302',
   }
 
   /**

From 266cd8d0599b2b06ba298ae0967b7c29a443b441 Mon Sep 17 00:00:00 2001
From: RedSTARO <822858602@qq.com>
Date: Sun, 1 Mar 2026 14:03:54 +0800
Subject: [PATCH 3/3] chore: doc update for 302 endpoint

---
 public/docs/home.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/public/docs/home.md b/public/docs/home.md
index f3ce57f..1309779 100644
--- a/public/docs/home.md
+++ b/public/docs/home.md
@@ -1254,6 +1254,21 @@ tags: 歌单标签
 
 说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。
 
+### 302到音乐 url - 新版
+
+说明 : 只允许传入单个`id`，会使用302重定向请求到目标url
+
+**必选参数 :** `id` : 音乐 id
+`level`: 播放音质等级, 分为 `standard` => `标准`,`higher` => `较高`, `exhigh`=>`极高`,
+`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带`
+`unblock`: 是否使用使用歌曲解锁, 分为`true`和`false`
+
+**接口地址 :** `/song/url/v1/302`
+
+**调用例子 :** `/song/url/v1/302?id=1969519579&level=exhigh`
+
+说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。
+
 ### 音乐是否可用
 
 说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 `{ success: true, message: 'ok' }` 或者 `{ success: false, message: '亲爱的,暂无版权' }`