@sansenjian/qq-music-api 2.2.9 → 2.3.1

package/docs-dist/assets/README.md.CHbArqA7.js

@@ -0,0 +1,421 @@
+import{c as o,S as e,j as a,m as i}from"./chunks/framework.BUY3a635.js";const l=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"README.md","filePath":"README.md","lastUpdated":1779031768000}'),n={name:"README.md"};function u(s,t,p,c,d,q){return e(),a("div",null,[...t[0]||(t[0]=[i(`<h2 align="center" id="qqmusicapi">QQ Music API</h2><p>!&gt; QQ音乐API koa2 版本, 通过Web网页版请求QQ音乐接口数据, 有问题请提 <a href="https://github.com/Rain120/qq-music-api/issues" target="_blank" rel="noreferrer">issue</a>, 或者你有其他想法欢迎<code>PR</code>.</p><h2 id="api结构图" tabindex="-1">API结构图 <a class="header-anchor" href="#api结构图" aria-label="Permalink to “API结构图”">​</a></h2><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/qq-music.png" alt="qq-music"></p><h2 id="api接口" tabindex="-1">API接口 <a class="header-anchor" href="#api接口" aria-label="Permalink to “API接口”">​</a></h2><p>!&gt; koa2 接口说明(参数, 地址, 效果图)</p><h2 id="新特性" tabindex="-1">新特性 <a class="header-anchor" href="#新特性" aria-label="Permalink to “新特性”">​</a></h2><h3 id="支持自定义设置cookie" tabindex="-1">支持自定义设置cookie <a class="header-anchor" href="#支持自定义设置cookie" aria-label="Permalink to “支持自定义设置cookie”">​</a></h3><p>!&gt; 2020-01-23 新增, 只需要配置 <code>config/user-info.js</code> 中的 <code>cookies</code> 字段就会在发送请求时带上你的 <code>cookies</code>。</p><h4 id="格式化自定义的-cookie" tabindex="-1">格式化自定义的 cookie <a class="header-anchor" href="#格式化自定义的-cookie" aria-label="Permalink to “格式化自定义的 cookie”">​</a></h4><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/normalize-cookie.png" alt="normalize-cookie.png"></p><h3 id="特性提示支持" tabindex="-1">特性提示支持 <a class="header-anchor" href="#特性提示支持" aria-label="Permalink to “特性提示支持”">​</a></h3><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/new-feature-error-tips.png" alt="new-feature-error-tips.png"></p><h3 id="获取-cookie" tabindex="-1">获取 Cookie <a class="header-anchor" href="#获取-cookie" aria-label="Permalink to “获取 Cookie”">​</a></h3><p>!&gt; 目前只支持用户自己从 <em>QQ音乐</em> 获取获取 <code>Cookie</code>, 如何获取 <code>Cookie</code>, 登录 <code>QQ音乐</code>, 然后 <code>F12</code>, 找到 <code>Network</code>, 随便找一个获取数据的接口, 复制接口中 <code>request headers</code> 中的 <code>Cookie</code> 即可。</p><p>接口说明: 调用此接口, 可获取自己在 <code>config/user-info.js</code> 配置的 <code>Cookie</code> 被格式化的结果</p><p>配置信息如下:</p><div class="language-"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>const userInfo = {</span></span>
+<span class="line"><span>	loginUin: &#39;qq号码&#39;,</span></span>
+<span class="line"><span>	cookie: &#39;&#39;,</span></span>
+<span class="line"><span>}</span></span></code></pre></div><p>接口地址: <code>/user/getCookie</code></p><p>调用例子: <code>/user/getCookie</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/normalize-cookie.png" alt="normalize-cookie.png"></p><h3 id="获取qq音乐产品的下载地址" tabindex="-1">获取QQ音乐产品的下载地址 <a class="header-anchor" href="#获取qq音乐产品的下载地址" aria-label="Permalink to “获取QQ音乐产品的下载地址”">​</a></h3><p>接口说明: 调用此接口, 可获取QQ音乐标准产品下载链接</p><p>接口地址: <code>/downloadQQMusic</code></p><p>调用例子: <code>/downloadQQMusic</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/downloadQQMusic.png" alt="获取QQ音乐产品的下载地址"></p><h3 id="获取歌单分类" tabindex="-1">获取歌单分类 <a class="header-anchor" href="#获取歌单分类" aria-label="Permalink to “获取歌单分类”">​</a></h3><p>接口说明: 调用此接口, 可获取歌单分类, 包含<code>category</code>信息</p><p>接口地址: <code>/getSongListCategories</code></p><p>调用例子: <code>/getSongListCategories</code></p><details><summary>SortID</summary><pre><code>sortId: 1, sortName: 默认
+sortId: 2, sortName: 最新
+sortId: 3, sortName: 最热
+sortId: 4, sortName: 评分
+sortId: 5, sortName: none
+</code></pre></details><p><strong>歌单分类(categoryId &amp; categoryName)</strong></p><details><summary>1. 热门</summary><pre><code>1.1
+  &quot;categoryId&quot;: 10000000,
+  &quot;categoryName&quot;: 全部,
+</code></pre></details><details><summary>2. 语种</summary><pre><code>2.1
+  &quot;categoryId&quot;: 167,
+  &quot;categoryName&quot;: &quot;英语&quot;,
+2.2
+  &quot;categoryId&quot;: 168,
+  &quot;categoryName&quot;: &quot;韩语&quot;,
+2.3
+  &quot;categoryId&quot;: 166,
+  &quot;categoryName&quot;: &quot;粤语&quot;,
+2.4
+  &quot;categoryId&quot;: 169,
+  &quot;categoryName&quot;: &quot;日语&quot;,
+2.5
+  &quot;categoryId&quot;: 170,
+  &quot;categoryName&quot;: &quot;小语种&quot;,
+2.6
+  &quot;categoryId&quot;: 203,
+  &quot;categoryName&quot;: &quot;闽南语&quot;,
+2.7
+  &quot;categoryId&quot;: 204,
+  &quot;categoryName&quot;: &quot;法语&quot;,
+2.8
+  &quot;categoryId&quot;: 205,
+  &quot;categoryName&quot;: &quot;拉丁语&quot;,
+</code></pre></details><details><summary>3. 流派</summary><pre><code>3.1
+  &quot;categoryId&quot;: 6,
+  &quot;categoryName&quot;: &quot;流行&quot;,
+3.2
+  &quot;categoryId&quot;: 15,
+  &quot;categoryName&quot;: &quot;轻音乐&quot;,
+3.3
+  &quot;categoryId&quot;: 11,
+  &quot;categoryName&quot;: &quot;摇滚&quot;,
+3.4
+  &quot;categoryId&quot;: 28,
+  &quot;categoryName&quot;: &quot;民谣&quot;,
+3.5
+  &quot;categoryId&quot;: 8,
+  &quot;categoryName&quot;: &quot;R&amp;B&quot;,
+3.6
+  &quot;categoryId&quot;: 153,
+  &quot;categoryName&quot;: &quot;嘻哈&quot;,
+3.7
+  &quot;categoryId&quot;: 24,
+  &quot;categoryName&quot;: &quot;电子&quot;,
+3.8
+  &quot;categoryId&quot;: 27,
+  &quot;categoryName&quot;: &quot;古典&quot;,
+3.9
+  &quot;categoryId&quot;: 18,
+  &quot;categoryName&quot;: &quot;乡村&quot;,
+3.10
+  &quot;categoryId&quot;: 22,
+  &quot;categoryName&quot;: &quot;蓝调&quot;,
+3.11
+  &quot;categoryId&quot;: 21,
+  &quot;categoryName&quot;: &quot;爵士&quot;,
+3.12
+  &quot;categoryId&quot;: 164,
+  &quot;categoryName&quot;: &quot;新世纪&quot;,
+3.13
+  &quot;categoryId&quot;: 25,
+  &quot;categoryName&quot;: &quot;拉丁&quot;,
+3.14
+  &quot;categoryId&quot;: 218,
+  &quot;categoryName&quot;: &quot;后摇&quot;,
+3.15
+  &quot;categoryId&quot;: 219,
+  &quot;categoryName&quot;: &quot;中国传统&quot;,
+3.16
+  &quot;categoryId&quot;: 220,
+  &quot;categoryName&quot;: &quot;世界音乐&quot;,
+</code></pre></details><details><summary>4. 主题</summary><pre><code>4.1
+  &quot;categoryId&quot;: 39,
+  &quot;categoryName&quot;: &quot;ACG&quot;,
+4.2
+  &quot;categoryId&quot;: 136,
+  &quot;categoryName&quot;: &quot;经典&quot;,
+4.3
+  &quot;categoryId&quot;: 146,
+  &quot;categoryName&quot;: &quot;网络歌曲&quot;,
+4.4
+  &quot;categoryId&quot;: 133,
+  &quot;categoryName&quot;: &quot;影视&quot;,
+4.5
+  &quot;categoryId&quot;: 141,
+  &quot;categoryName&quot;: &quot;KTV热歌&quot;,
+4.6
+  &quot;categoryId&quot;: 131,
+  &quot;categoryName&quot;: &quot;儿歌&quot;,
+4.7
+  &quot;categoryId&quot;: 145,
+  &quot;categoryName&quot;: &quot;中国风&quot;,
+4.8
+  &quot;categoryId&quot;: 194,
+  &quot;categoryName&quot;: &quot;古风&quot;,
+4.9
+  &quot;categoryId&quot;: 148,
+  &quot;categoryName&quot;: &quot;情歌&quot;,
+4.10
+  &quot;categoryId&quot;: 196,
+  &quot;categoryName&quot;: &quot;城市&quot;,
+4.11
+  &quot;categoryId&quot;: 197,
+  &quot;categoryName&quot;: &quot;现场音乐&quot;,
+4.12
+  &quot;categoryId&quot;: 199,
+  &quot;categoryName&quot;: &quot;背景音乐&quot;,
+4.13
+  &quot;categoryId&quot;: 200,
+  &quot;categoryName&quot;: &quot;佛教音乐&quot;,
+4.14
+  &quot;categoryId&quot;: 201,
+  &quot;categoryName&quot;: &quot;UP主&quot;,
+4.15
+  &quot;categoryId&quot;: 202,
+  &quot;categoryName&quot;: &quot;乐器&quot;,
+4.16
+  &quot;categoryId&quot;: 14,
+  &quot;categoryName&quot;: &quot;DJ&quot;,
+</code></pre></details><details><summary>5. 心情</summary><pre><code>5.1
+  &quot;categoryId&quot;: 52,
+  &quot;categoryName&quot;: &quot;伤感&quot;,
+5.2
+  &quot;categoryId&quot;: 122,
+  &quot;categoryName&quot;: &quot;安静&quot;,
+5.3
+  &quot;categoryId&quot;: 117,
+  &quot;categoryName&quot;: &quot;快乐&quot;,
+5.4
+  &quot;categoryId&quot;: 116,
+  &quot;categoryName&quot;: &quot;治愈&quot;,
+5.5
+  &quot;categoryId&quot;: 125,
+  &quot;categoryName&quot;: &quot;励志&quot;,
+5.6
+  &quot;categoryId&quot;: 59,
+  &quot;categoryName&quot;: &quot;甜蜜&quot;,
+5.7
+  &quot;categoryId&quot;: 55,
+  &quot;categoryName&quot;: &quot;寂寞&quot;,
+5.8
+  &quot;categoryId&quot;: 126,
+  &quot;categoryName&quot;: &quot;宣泄&quot;,
+5.9
+  &quot;categoryId&quot;: 68,
+  &quot;categoryName&quot;: &quot;思念&quot;,
+</code></pre></details><details><summary>6. 场景</summary><pre><code>6.1
+  &quot;categoryId&quot;: 78,
+  &quot;categoryName&quot;: &quot;睡前&quot;,
+6.2
+  &quot;categoryId&quot;: 102,
+  &quot;categoryName&quot;: &quot;夜店&quot;,
+6.3
+  &quot;categoryId&quot;: 101,
+  &quot;categoryName&quot;: &quot;学习&quot;,
+6.4
+  &quot;categoryId&quot;: 99,
+  &quot;categoryName&quot;: &quot;运动&quot;,
+6.5
+  &quot;categoryId&quot;: 99,
+  &quot;categoryName&quot;: &quot;运动&quot;,
+6.6
+  &quot;categoryId&quot;: 76,
+  &quot;categoryName&quot;: &quot;约会&quot;,
+6.7
+  &quot;categoryId&quot;: 94,
+  &quot;categoryName&quot;: &quot;工作&quot;,
+6.8
+  &quot;categoryId&quot;: 81,
+  &quot;categoryName&quot;: &quot;旅行&quot;,
+6.9
+  &quot;categoryId&quot;: 103,
+  &quot;categoryName&quot;: &quot;派对&quot;,
+6.10
+  &quot;categoryId&quot;: 222,
+  &quot;categoryName&quot;: &quot;婚礼&quot;,
+6.11
+  &quot;categoryId&quot;: 223,
+  &quot;categoryName&quot;: &quot;咖啡馆&quot;,
+6.12
+  &quot;categoryId&quot;: 224,
+  &quot;categoryName&quot;: &quot;跳舞&quot;,
+6.13
+  &quot;categoryId&quot;: 16,
+  &quot;categoryName&quot;: &quot;校园&quot;,
+</code></pre></details><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongListCategories.png" alt="获取歌单分类"></p><h3 id="获取歌单列表" tabindex="-1">获取歌单列表 <a class="header-anchor" href="#获取歌单列表" aria-label="Permalink to “获取歌单列表”">​</a></h3><p>接口说明: 调用此接口, 可获取歌单列表</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>categoryId</code>: 类别<code>id</code>, 详见 <code>/getSongListCategories</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li><li><p><code>sortId</code>: 最新, 最热,评分, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSongLists</code></p><p>调用例子: <code>/getSongLists?categoryId=10000000</code></p><p>示例截图:</p><p><strong>获取歌单列表</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongLists.png" alt="获取歌单列表"></p><h3 id="批量获取歌单列表" tabindex="-1">批量获取歌单列表 <a class="header-anchor" href="#批量获取歌单列表" aria-label="Permalink to “批量获取歌单列表”">​</a></h3><p>接口说明: 调用此接口, 可批量获取歌单列表</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>categoryIds</code>: 类别<code>id</code>列表, 详见 <code>/getSongListCategories</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li><li><p><code>sortId</code>: 最新, 最热,评分, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/batchGetSongLists</code></p><p>调用例子: <code>/batchGetSongLists</code></p><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">limit</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 19</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">page</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 0</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">sortId</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 5</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">categoryIds</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> [</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;">167</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 168</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><p>示例截图:</p><p><strong>批量获取歌单列表</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/batchGetSongLists.png" alt="获取歌单列表"></p><p><strong>获取歌单列表-带参数</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongLists-params.png" alt="获取歌单列表-带参数"></p><h3 id="获取歌单详情" tabindex="-1">获取歌单详情 <a class="header-anchor" href="#获取歌单详情" aria-label="Permalink to “获取歌单详情”">​</a></h3><p>接口说明: 调用此接口, 可获取歌单详情</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>disstid</code>: 歌单<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSongListDetail</code></p><p>调用例子: <code>/getSongListDetail?disstid=7011264340</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongListDetail.png" alt="获取歌单详情"></p><h3 id="获取mv标签" tabindex="-1">获取MV标签 <a class="header-anchor" href="#获取mv标签" aria-label="Permalink to “获取MV标签”">​</a></h3><p>接口说明: 调用此接口, 可获取MV标签</p><p>接口地址: <code>/getMvByTag</code></p><p>调用例子: <code>/getMvByTag</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMvByTag.png" alt="获取MV标签"></p><h3 id="获取mv播放信息" tabindex="-1">获取MV播放信息 <a class="header-anchor" href="#获取mv播放信息" aria-label="Permalink to “获取MV播放信息”">​</a></h3><p>接口说明: 调用此接口, 可获取MV播放信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>vid</code>: <code>video id</code></li></ul></li></ul><p>接口地址: <code>/getMvPlay</code></p><p>调用例子: <code>/getMvPlay?vid=u00222le4ox</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMvPlay.png" alt="获取MV播放信息"></p><h3 id="获取歌手mv" tabindex="-1">获取歌手MV <a class="header-anchor" href="#获取歌手mv" aria-label="Permalink to “获取歌手MV”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手MV</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>order</code>: 当前MV类型, 默认为<code>time</code></p><ul><li><p><code>listen</code>: 歌手专辑音乐MV</p></li><li><p><code>time</code>: 粉丝上传MV视频</p></li></ul></li><li><p><code>limit</code>: 取出歌单数量, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSingerMV</code></p><p>调用例子: <code>/getSingerMV?singermid=0025NhlN2yWrP4&amp;order=all&amp;limit=5</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-default.png" alt="获取歌手MV - default"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-listen.png" alt="获取歌手MV - belong"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-time.png" alt="获取歌手MV - fans"></p><h3 id="获取歌手热门歌曲" tabindex="-1">获取歌手热门歌曲 <a class="header-anchor" href="#获取歌手热门歌曲" aria-label="Permalink to “获取歌手热门歌曲”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手热门歌曲</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 页数, 默认为0</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSingerHotsong</code></p><p>调用例子: <code>/getSingerHotsong?singermid=0025NhlN2yWrP4&amp;limit=10&amp;page=2</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerHotsong.png" alt="获取歌手热门歌曲"></p><h3 id="获取相似歌手" tabindex="-1">获取相似歌手 <a class="header-anchor" href="#获取相似歌手" aria-label="Permalink to “获取相似歌手”">​</a></h3><p>接口说明: 调用此接口, 可获取相似歌手</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSimilarSinger</code></p><p>调用例子: <code>/getSimilarSinger?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSimilarSinger.png" alt="获取相似歌手"></p><h3 id="获取歌手信息" tabindex="-1">获取歌手信息 <a class="header-anchor" href="#获取歌手信息" aria-label="Permalink to “获取歌手信息”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSingerDesc</code></p><p>调用例子: <code>/getSingerDesc?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerDesc.png" alt="获取歌手信息"></p><h3 id="获取歌手列表" tabindex="-1">获取歌手列表 <a class="header-anchor" href="#获取歌手列表" aria-label="Permalink to “获取歌手列表”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手列表</p><p>参数列表:</p><ul><li><p>可选参数</p><details><summary>area 默认是 -100</summary><pre><code>  &quot;id&quot;: -100,
+  &quot;name&quot;: &quot;全部&quot;
+  &quot;id&quot;: 200,
+  &quot;name&quot;: &quot;内地&quot;
+  
+  &quot;id&quot;: 2,
+  &quot;name&quot;: &quot;港台&quot;
+  
+  &quot;id&quot;: 5,
+  &quot;name&quot;: &quot;欧美&quot;
+  
+  &quot;id&quot;: 4,
+  &quot;name&quot;: &quot;日本&quot;
+  
+  &quot;id&quot;: 3,
+  &quot;name&quot;: &quot;韩国&quot;
+  
+  &quot;id&quot;: 6,
+  &quot;name&quot;: &quot;其他&quot;
+</code></pre></details><details><summary>genre 默认是 -100</summary><pre><code>&quot;id&quot;: -100,
+&quot;name&quot;: &quot;全部&quot;
+
+&quot;id&quot;: 1,
+&quot;name&quot;: &quot;流行&quot;
+
+&quot;id&quot;: 6,
+&quot;name&quot;: &quot;嘻哈&quot;
+
+&quot;id&quot;: 2,
+&quot;name&quot;: &quot;摇滚&quot;
+
+&quot;id&quot;: 4,
+&quot;name&quot;: &quot;电子&quot;
+
+&quot;id&quot;: 3,
+&quot;name&quot;: &quot;民谣&quot;
+
+&quot;id&quot;: 8,
+&quot;name&quot;: &quot;R&amp;B&quot;
+
+&quot;id&quot;: 10,
+&quot;name&quot;: &quot;民歌&quot;
+
+&quot;id&quot;: 9,
+&quot;name&quot;: &quot;轻音乐&quot;
+
+&quot;id&quot;: 5,
+&quot;name&quot;: &quot;爵士&quot;
+
+&quot;id&quot;: 14,
+&quot;name&quot;: &quot;古典&quot;
+
+&quot;id&quot;: 25,
+&quot;name&quot;: &quot;乡村&quot;
+
+&quot;id&quot;: 20,
+&quot;name&quot;: &quot;蓝调&quot;
+</code></pre></details><details><summary>index 默认是 -100</summary><pre><code>&quot;id&quot;: -100,
+&quot;name&quot;: &quot;热门&quot;
+
+&quot;id&quot;: 1,
+&quot;name&quot;: &quot;A&quot;
+
+&quot;id&quot;: 2,
+&quot;name&quot;: &quot;B&quot;
+
+&quot;id&quot;: 3,
+&quot;name&quot;: &quot;C&quot;
+
+&quot;id&quot;: 4,
+&quot;name&quot;: &quot;D&quot;
+
+&quot;id&quot;: 5,
+&quot;name&quot;: &quot;E&quot;
+
+&quot;id&quot;: 6,
+&quot;name&quot;: &quot;F&quot;
+
+&quot;id&quot;: 7,
+&quot;name&quot;: &quot;G&quot;
+
+&quot;id&quot;: 8,
+&quot;name&quot;: &quot;H&quot;
+
+&quot;id&quot;: 9,
+&quot;name&quot;: &quot;I&quot;
+
+&quot;id&quot;: 10,
+&quot;name&quot;: &quot;J&quot;
+
+&quot;id&quot;: 11,
+&quot;name&quot;: &quot;K&quot;
+
+&quot;id&quot;: 12,
+&quot;name&quot;: &quot;L&quot;
+
+&quot;id&quot;: 13,
+&quot;name&quot;: &quot;M&quot;
+
+&quot;id&quot;: 14,
+&quot;name&quot;: &quot;N&quot;
+
+&quot;id&quot;: 15,
+&quot;name&quot;: &quot;O&quot;
+
+&quot;id&quot;: 16,
+&quot;name&quot;: &quot;P&quot;
+
+&quot;id&quot;: 17,
+&quot;name&quot;: &quot;Q&quot;
+
+&quot;id&quot;: 18,
+&quot;name&quot;: &quot;R&quot;
+
+&quot;id&quot;: 19,
+&quot;name&quot;: &quot;S&quot;
+
+&quot;id&quot;: 20,
+&quot;name&quot;: &quot;T&quot;
+
+&quot;id&quot;: 21,
+&quot;name&quot;: &quot;U&quot;
+
+&quot;id&quot;: 22,
+&quot;name&quot;: &quot;V&quot;
+
+&quot;id&quot;: 23,
+&quot;name&quot;: &quot;W&quot;
+
+&quot;id&quot;: 24,
+&quot;name&quot;: &quot;X&quot;
+
+&quot;id&quot;: 25,
+&quot;name&quot;: &quot;Y&quot;
+
+&quot;id&quot;: 26,
+&quot;name&quot;: &quot;Z&quot;
+
+&quot;id&quot;: 27,
+&quot;name&quot;: &quot;#&quot;
+</code></pre></details><details><summary>sex 默认是 -100</summary><pre><code>&quot;id&quot;: -100,
+&quot;name&quot;: &quot;全部&quot;
+
+&quot;id&quot;: 0,
+&quot;name&quot;: &quot;男&quot;
+
+&quot;id&quot;: 1,
+&quot;name&quot;: &quot;女&quot;
+
+&quot;id&quot;: 2,
+&quot;name&quot;: &quot;组合&quot;
+</code></pre></details></li></ul><p>接口地址: <code>/getSingerList</code></p><p>调用例子: <code>/getSingerList</code> 调用例子: <code>/getSingerList?area=200&amp;sex=2&amp;index=3&amp;genre=2</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerList.png" alt="获取歌手列表"></p><h3 id="获取歌手被关注数量信息" tabindex="-1">获取歌手被关注数量信息 <a class="header-anchor" href="#获取歌手被关注数量信息" aria-label="Permalink to “获取歌手被关注数量信息”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手被关注数量信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSingerStarNum</code></p><p>调用例子: <code>/getSingerStarNum?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerStarNum.png" alt="获取歌手被关注数量信息"></p><h3 id="获取电台列表" tabindex="-1">获取电台列表 <a class="header-anchor" href="#获取电台列表" aria-label="Permalink to “获取电台列表”">​</a></h3><p>接口说明: 调用此接口, 可获取电台列表, 分类</p><p>接口地址: <code>/getRadioLists</code></p><p>调用例子: <code>/getRadioLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRadioLists.png" alt="获取电台列表"></p><h3 id="获取专辑" tabindex="-1">获取专辑 <a class="header-anchor" href="#获取专辑" aria-label="Permalink to “获取专辑”">​</a></h3><p>接口说明: 调用此接口, 可获取专辑信息(专辑列表、详情)</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>albummid</code>: 专辑<code>id</code></li></ul></li></ul><p>接口地址: <code>/getAlbumInfo</code></p><p>调用例子: <code>/getAlbumInfo?albummid=0016l2F430zMux</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getAlbumInfo.png" alt="获取专辑"></p><h3 id="获取数字专辑" tabindex="-1">获取数字专辑 <a class="header-anchor" href="#获取数字专辑" aria-label="Permalink to “获取数字专辑”">​</a></h3><p>接口说明: 调用此接口, 可获取数字专辑, 轮播图<code>banner</code>, 专辑列表等信息, 详见<a href="#api结构图">API结构图</a></p><p>接口地址: <code>/getDigitalAlbumLists</code></p><p>调用例子: <code>/getDigitalAlbumLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getDigitalAlbumLists.png" alt="获取数字专辑"></p><h3 id="获取歌曲歌词" tabindex="-1">获取歌曲歌词 <a class="header-anchor" href="#获取歌曲歌词" aria-label="Permalink to “获取歌曲歌词”">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲歌词</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>songmid</code>: 专辑<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><code>isFormat</code>: 是否格式化歌词, 默认值为 <code>false</code></li></ul></li></ul><p>接口地址: <code>/getLyric</code></p><p>调用例子: <code>/getLyric?songmid=003rJSwm3TechU</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getLyric.png" alt="获取歌曲歌词 - 未格式化"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getLyric-parse.png" alt="获取歌曲歌词 - 格式化"></p><h3 id="获取mv" tabindex="-1">获取MV <a class="header-anchor" href="#获取mv" aria-label="Permalink to “获取MV”">​</a></h3><p>接口说明: 调用此接口, 可获取MV以及其Tag信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>area_id</code>: 区域<code>id</code>, 默认值为全部(15)</li></ul></li></ul><details><summary>Area</summary><pre><code>&quot;area&quot;: [
+  {
+    &quot;id&quot;: 15,
+    &quot;name&quot;: &quot;全部&quot;
+  },
+  {
+    &quot;id&quot;: 16,
+    &quot;name&quot;: &quot;内地&quot;
+  },
+  {
+    &quot;id&quot;: 17,
+    &quot;name&quot;: &quot;港台&quot;
+  },
+  {
+    &quot;id&quot;: 18,
+    &quot;name&quot;: &quot;欧美&quot;
+  },
+  {
+    &quot;id&quot;: 19,
+    &quot;name&quot;: &quot;韩国&quot;
+  },
+  {
+    &quot;id&quot;: 20,
+    &quot;name&quot;: &quot;日本&quot;
+  }
+]
+</code></pre></details><p><code>version_id</code>: 版本<code>id</code>, 默认值为全部(7)</p><details><summary>Version</summary><pre><code>&quot;version&quot;: [
+  {
+    &quot;id&quot;: 7,
+    &quot;name&quot;: &quot;全部&quot;
+  },
+  {
+    &quot;id&quot;: 8,
+    &quot;name&quot;: &quot;MV&quot;
+  },
+  {
+    &quot;id&quot;: 9,
+    &quot;name&quot;: &quot;现场&quot;
+  },
+  {
+    &quot;id&quot;: 10,
+    &quot;name&quot;: &quot;翻唱&quot;
+  },
+  {
+    &quot;id&quot;: 11,
+    &quot;name&quot;: &quot;舞蹈&quot;
+  },
+  {
+    &quot;id&quot;: 12,
+    &quot;name&quot;: &quot;影视&quot;
+  },
+  {
+    &quot;id&quot;: 13,
+    &quot;name&quot;: &quot;综艺&quot;
+  },
+  {
+    &quot;id&quot;: 14,
+    &quot;name&quot;: &quot;儿歌&quot;
+  }
+]
+</code></pre></details><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getMv</code></p><p>调用例子: <code>/getMv</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMv.png" alt="获取MV"></p><h3 id="获取新碟信息" tabindex="-1">获取新碟信息 <a class="header-anchor" href="#获取新碟信息" aria-label="Permalink to “获取新碟信息”">​</a></h3><p>接口说明: 调用此接口, 可获取新碟信息</p><p>参数列表:</p><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getNewDisks</code></p><p>调用例子: <code>/getNewDisks</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getNewDisks.png" alt="获取新碟信息"></p><h3 id="获取歌手专辑" tabindex="-1">获取歌手专辑 <a class="header-anchor" href="#获取歌手专辑" aria-label="Permalink to “获取歌手专辑”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手专辑</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getSingerAlbum</code></p><p>调用例子: <code>/getSingerAlbum?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerAlbum.png" alt="获取歌手专辑"></p><h3 id="获取歌曲相关信息" tabindex="-1">获取歌曲相关信息 <a class="header-anchor" href="#获取歌曲相关信息" aria-label="Permalink to “获取歌曲相关信息”">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲相关信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>songmid</code>: 歌曲<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSongInfo</code></p><p>调用例子: <code>/getSongInfo?songmid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongInfo.png" alt="获取歌曲相关信息"></p><h3 id="批量获取歌曲相关信息" tabindex="-1">批量获取歌曲相关信息 <a class="header-anchor" href="#批量获取歌曲相关信息" aria-label="Permalink to “批量获取歌曲相关信息”">​</a></h3><p>接口说明: 调用此接口, 可批量获取歌曲相关信息</p><p>参数列表:</p><ul><li>必选参数</li></ul><div class="language-"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>songs: [</span></span>
+<span class="line"><span>  [songmid, songid]</span></span>
+<span class="line"><span>]</span></span></code></pre></div><p>其中 <code>songid</code>可以不传</p><p>接口地址: <code>/batchGetSongInfo</code></p><p>调用例子: <code>/batchGetSongInfo</code></p><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">  &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">songs</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> [</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">    [</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">001CLC7W2Gpz4J</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">],</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">    [</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">0025NhlN2yWrP4</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/batchGetSongInfo.png" alt="获取歌曲相关信息"></p><h3 id="获取歌曲播放链接" tabindex="-1">获取歌曲播放链接 <a class="header-anchor" href="#获取歌曲播放链接" aria-label="Permalink to “获取歌曲播放链接”">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲播放链接</p><p>参数列表:</p><ul><li><p>必选参数</p></li><li><p><code>songmid</code>: 歌曲<code>id</code>, 多个播放链接使用 <code>,</code>分隔</p></li><li><p><code>justPlayUrl</code>: 仅返回播放链接, 默认是 <code>play</code>。<code>[all | play]</code></p></li><li><p><code>quality</code>: 播放品质, 默认是 128。<code>[m4a | 128 | 320 | ape | flac]</code></p></li></ul><p>接口地址: <code>/getMusicPlay</code></p><p>调用例子:</p><p>示例截图:</p><h4 id="获取单个播放链接" tabindex="-1">获取单个播放链接 <a class="header-anchor" href="#获取单个播放链接" aria-label="Permalink to “获取单个播放链接”">​</a></h4><p>例子: <code>/getMusicPlay?songmid=0012g3Et1iFQCC</code></p><p><img src="https://raw.githubusercontent.com/RTAkland/qq-music-api/refs/heads/main/screenshot/musicPlay.png" alt="获取单个播放链接"></p><h4 id="获取多个播放链接" tabindex="-1">获取多个播放链接 <a class="header-anchor" href="#获取多个播放链接" aria-label="Permalink to “获取多个播放链接”">​</a></h4><p>例子: <code>/getMusicPlay?songmid=001yNIo41SJjuC,001wPuVc4ZiMhj&amp;resType=play</code></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/just-get-play-url.png" alt="获取多个歌曲播放链接"></p><h4 id="获取多个播放链接-1" tabindex="-1">获取多个播放链接 <a class="header-anchor" href="#获取多个播放链接-1" aria-label="Permalink to “获取多个播放链接”">​</a></h4><p>例子: <code>/getMusicPlay?songmid=0012g3Et1iFQCC,001wPuVc4ZiMhj&amp;resType=all</code></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-play-all-data.png" alt="获取接口所有数据"></p><h4 id="歌曲品质" tabindex="-1">歌曲品质 <a class="header-anchor" href="#歌曲品质" aria-label="Permalink to “歌曲品质”">​</a></h4><p>例子: <code>songmid=001yNIo41SJjuC&amp;resType=play&amp;quality=m4a</code></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/song-quality-128.png" alt="song-quality-128.png"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/song-quality-m4a.png" alt="song-quality-m4a.png"></p><h3 id="获取搜索热词" tabindex="-1">获取搜索热词 <a class="header-anchor" href="#获取搜索热词" aria-label="Permalink to “获取搜索热词”">​</a></h3><p>接口说明: 调用此接口, 可获取搜索热词</p><p>接口地址: <code>/getHotkey</code></p><p>调用例子: <code>/getHotkey</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/gethotkey.png" alt="获取搜索热词"></p><h3 id="获取关键字搜索提示" tabindex="-1">获取关键字搜索提示 <a class="header-anchor" href="#获取关键字搜索提示" aria-label="Permalink to “获取关键字搜索提示”">​</a></h3><p>接口说明: 调用此接口, 可获取获取关键字搜索提示</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>key</code>: 搜索关键字</li></ul></li></ul><p>接口地址: <code>/getSmartbox</code></p><p>调用例子: <code>/getSmartbox?key=周杰伦</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSmartbox.png" alt="获取获取关键字搜索提示"></p><h3 id="获取搜索结果" tabindex="-1">获取搜索结果 <a class="header-anchor" href="#获取搜索结果" aria-label="Permalink to “获取搜索结果”">​</a></h3><p>接口说明: 调用此接口, 可获取获取搜索结果</p><p>参数列表(部分参数待注释):</p><ul><li><p>必选参数</p><ul><li><p><code>key</code>: 搜索关键字</p></li><li><p><s><code>catZhida</code>: 默认值为1</s></p><p><s>1. <code>0</code> 表示歌曲</s></p><p><s>2. <code>2</code> 表示歌手</s></p><p><s>3. <code>3</code> 表示专辑</s></p></li><li><p><code>remoteplace</code>: 默认值为 <code>song</code></p><ol><li><p>单曲: <code>song</code></p></li><li><p>专辑: <code>album</code></p></li><li><p>MV: <code>mv</code></p></li><li><p>歌单: <code>playlist</code></p></li><li><p>用户: <code>user</code></p></li><li><p>歌词: <code>lyric</code></p></li></ol></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 <code>1</code></p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 <code>10</code></p></li></ul></li></ul><p>接口地址: <code>/getSearchByKey</code></p><p>调用例子: <code>/getSearchByKey?key=周杰伦</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSearchByKey.png" alt="获取获取搜索结果"></p><h3 id="获取首页推荐" tabindex="-1">获取首页推荐 <a class="header-anchor" href="#获取首页推荐" aria-label="Permalink to “获取首页推荐”">​</a></h3><p>接口说明: 调用此接口, 可获取首页推荐</p><p>接口地址: <code>/getRecommend</code></p><p>调用例子: <code>/getRecommend</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRecommend.png" alt="获取首页推荐"></p><h3 id="获取排行榜单列表" tabindex="-1">获取排行榜单列表 <a class="header-anchor" href="#获取排行榜单列表" aria-label="Permalink to “获取排行榜单列表”">​</a></h3><p>接口说明: 调用此接口, 可获取排行榜单列表</p><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 <code>1</code></p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 <code>10</code></p></li></ul></li></ul><p>接口地址: <code>/getTopLists</code></p><p>调用例子: <code>/getTopLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getTopLists.png" alt="获取排行榜单列表"></p><h3 id="获取排行榜单详情" tabindex="-1">获取排行榜单详情 <a class="header-anchor" href="#获取排行榜单详情" aria-label="Permalink to “获取排行榜单详情”">​</a></h3><p>接口说明: 调用此接口, 可获取排行榜单详情</p><ul><li><p>可选参数</p><ul><li><p><code>topId</code>: 榜单<code>id</code></p></li><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 10</p></li></ul></li></ul><p>接口地址: <code>/getRanks</code></p><p>调用例子: <code>/getRanks</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRanks.png" alt="获取排行榜单详情"></p><h3 id="获取评论信息-cmd代表的意思没太弄明白" tabindex="-1">获取评论信息(cmd代表的意思没太弄明白) <a class="header-anchor" href="#获取评论信息-cmd代表的意思没太弄明白" aria-label="Permalink to “获取评论信息(cmd代表的意思没太弄明白)”">​</a></h3><p>接口说明: 调用此接口, 可获取评论信息</p><ul><li><p>必选参数</p><ul><li><code>id</code>: 专辑或者歌单请求结果的<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>rootcommentid</code>: 榜单<code>id</code></p></li><li><p><code>cid</code>:</p></li><li><p><code>pagenum</code>: 当前页数, 默认为 <code>0</code></p></li><li><p><code>pagesize</code>: 取出评论数量, 默认为 <code>25</code></p></li><li><p><code>cmd</code>:</p></li><li><p><code>reqtype</code>:</p></li><li><p><code>biztype</code>:</p></li></ul></li></ul><p>接口地址: <code>/getComments</code></p><p>调用例子: <code>/getComments?id=8220&amp;rootcommentid=album_8220_1003310416_1558068713</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getComments-id.png" alt="获取评论信息 - id获取"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getComments.png" alt="获取评论信息"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getComments-param.png" alt="获取评论信息 - 带params"></p><h3 id="获取歌曲-专辑-图片" tabindex="-1">获取歌曲 + 专辑 图片 <a class="header-anchor" href="#获取歌曲-专辑-图片" aria-label="Permalink to “获取歌曲 + 专辑 图片”">​</a></h3><p>接口说明: 调用此接口, 可获取票务信息</p><ul><li><p>必选参数</p><ul><li><code>id</code>: 专辑或者歌单请求结果的<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>size</code>: 图片大小, 默认 <code>300x300</code></p></li><li><p><code>maxAge</code>: 图片过期时间, 默认 <code>12 mins = 2592000ms</code></p></li></ul></li></ul><p>接口地址: <code>/getImageUrl</code></p><p>调用例子: <code>/getImageUrl?id=000MkMni19ClKG</code> or <code>/getImageUrl?id=000MkMni19ClKG&amp;size=500x500</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-song-id.png" alt="获取歌曲id"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-song-image.png" alt="获取歌曲图片地址"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/song-image.png" alt="歌曲图片地址"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-song-album-id.png" alt="获取专辑id"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-album-image.png" alt="获取歌曲专辑地址"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/album-image.png" alt="歌曲专辑地址"></p><h3 id="获取票务信息" tabindex="-1">获取票务信息 <a class="header-anchor" href="#获取票务信息" aria-label="Permalink to “获取票务信息”">​</a></h3><p>接口说明: 调用此接口, 可获取票务信息</p><p>接口地址: <code>/getTicketInfo</code></p><p>调用例子: <code>/getTicketInfo</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getTicketInfo.png" alt="获取票务信息"></p>`,300)])])}const g=o(n,[["render",u]]);export{l as __pageData,g as default};

package/docs-dist/assets/README.md.CHbArqA7.lean.js

@@ -0,0 +1 @@
+import{c as o,S as e,j as a,m as i}from"./chunks/framework.BUY3a635.js";const l=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"README.md","filePath":"README.md","lastUpdated":1779031768000}'),n={name:"README.md"};function u(s,t,p,c,d,q){return e(),a("div",null,[...t[0]||(t[0]=[i("",300)])])}const g=o(n,[["render",u]]);export{l as __pageData,g as default};

package/docs-dist/assets/TEST_USER_PLAYLISTS.md.BfBxYbaM.js

@@ -0,0 +1,16 @@
+import{c as s,S as a,j as e,m as l}from"./chunks/framework.BUY3a635.js";const c=JSON.parse('{"title":"用户歌单接口测试指南","description":"","frontmatter":{},"headers":[],"relativePath":"TEST_USER_PLAYLISTS.md","filePath":"TEST_USER_PLAYLISTS.md","lastUpdated":1779031768000}'),t={name:"TEST_USER_PLAYLISTS.md"};function h(n,i,d,r,o,k){return a(),e("div",null,[...i[0]||(i[0]=[l(`<h1 id="用户歌单接口测试指南" tabindex="-1">用户歌单接口测试指南 <a class="header-anchor" href="#用户歌单接口测试指南" aria-label="Permalink to “用户歌单接口测试指南”">​</a></h1><h2 id="接口说明" tabindex="-1">接口说明 <a class="header-anchor" href="#接口说明" aria-label="Permalink to “接口说明”">​</a></h2><p><strong>接口地址</strong>: <code>GET /user/getUserPlaylists</code></p><p><strong>功能</strong>: 获取 QQ 音乐用户创建的歌单列表</p><p><strong>参数</strong>:</p><ul><li><code>uin</code>（必填）：QQ 号码</li><li><code>offset</code>（可选）：偏移量，默认 <code>0</code></li><li><code>limit</code>（可选）：返回数量，默认 <code>30</code></li></ul><h2 id="当前状态" tabindex="-1">当前状态 <a class="header-anchor" href="#当前状态" aria-label="Permalink to “当前状态”">​</a></h2><p><strong>当前状态</strong>: ⚠️ 持续验证中</p><p>截至当前代码版本，用户歌单接口仍在持续排查与验证中。文档与测试说明会跟随实现更新，但不建议将该接口视为已经完全稳定。</p><h2 id="现状说明" tabindex="-1">现状说明 <a class="header-anchor" href="#现状说明" aria-label="Permalink to “现状说明”">​</a></h2><h3 id="_1-接口依赖-cookie" tabindex="-1">1. 接口依赖 Cookie <a class="header-anchor" href="#_1-接口依赖-cookie" aria-label="Permalink to “1. 接口依赖 Cookie”">​</a></h3><p>该接口仍依赖有效的 QQ 音乐 Cookie。若 Cookie 失效，通常会直接导致上游请求失败。</p><h3 id="_2-上游结构可能变化" tabindex="-1">2. 上游结构可能变化 <a class="header-anchor" href="#_2-上游结构可能变化" aria-label="Permalink to “2. 上游结构可能变化”">​</a></h3><p>项目当前会尽量从上游响应中提取并标准化出 <code>playlists</code> 字段，但上游字段结构仍可能发生变化。</p><h3 id="_3-分页语义仍需持续验证" tabindex="-1">3. 分页语义仍需持续验证 <a class="header-anchor" href="#_3-分页语义仍需持续验证" aria-label="Permalink to “3. 分页语义仍需持续验证”">​</a></h3><p>当前接口对外暴露 <code>offset</code> 与 <code>limit</code> 参数，但由于上游分页能力和字段结构并不稳定，分页结果仍建议按实际返回数据做校验。</p><h2 id="已尝试与观察到的上游接口" tabindex="-1">已尝试与观察到的上游接口 <a class="header-anchor" href="#已尝试与观察到的上游接口" aria-label="Permalink to “已尝试与观察到的上游接口”">​</a></h2><h3 id="_1-用户主页-歌单相关接口" tabindex="-1">1. 用户主页/歌单相关接口 <a class="header-anchor" href="#_1-用户主页-歌单相关接口" aria-label="Permalink to “1. 用户主页/歌单相关接口”">​</a></h3><p>当前排查过程中，曾观察到以下可用路径或相近能力：</p><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>https://c6.y.qq.com/rsc/fcgi-bin/fcg_get_profile_homepage.fcg</span></span>
+<span class="line"><span>https://u.y.qq.com/cgi-bin/musicu.fcg</span></span></code></pre></div><h3 id="_2-公开能力接口" tabindex="-1">2. 公开能力接口 <a class="header-anchor" href="#_2-公开能力接口" aria-label="Permalink to “2. 公开能力接口”">​</a></h3><p>以下接口更适合作为公开能力的替代方案或辅助排查手段：</p><h4 id="获取热门歌单" tabindex="-1">获取热门歌单 <a class="header-anchor" href="#获取热门歌单" aria-label="Permalink to “获取热门歌单”">​</a></h4><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>GET https://c.y.qq.com/splcloud/fcgi-bin/fcg_get_diss_by_tag.fcg</span></span></code></pre></div><h4 id="获取歌单详情" tabindex="-1">获取歌单详情 <a class="header-anchor" href="#获取歌单详情" aria-label="Permalink to “获取歌单详情”">​</a></h4><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>GET https://c.y.qq.com/qzone/fcg-bin/fcg_ucc_getcdinfo_byids_cp.fcg</span></span></code></pre></div><h4 id="搜索歌曲" tabindex="-1">搜索歌曲 <a class="header-anchor" href="#搜索歌曲" aria-label="Permalink to “搜索歌曲”">​</a></h4><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>GET https://c.y.qq.com/soso/fcgi-bin/client_search_cp</span></span></code></pre></div><h4 id="获取歌曲播放链接" tabindex="-1">获取歌曲播放链接 <a class="header-anchor" href="#获取歌曲播放链接" aria-label="Permalink to “获取歌曲播放链接”">​</a></h4><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>GET https://u.y.qq.com/cgi-bin/musicu.fcg</span></span></code></pre></div><h2 id="测试前准备" tabindex="-1">测试前准备 <a class="header-anchor" href="#测试前准备" aria-label="Permalink to “测试前准备”">​</a></h2><h3 id="_1-登录-qq-音乐" tabindex="-1">1. 登录 QQ 音乐 <a class="header-anchor" href="#_1-登录-qq-音乐" aria-label="Permalink to “1. 登录 QQ 音乐”">​</a></h3><ul><li>访问 <code>https://y.qq.com</code></li><li>使用 QQ 扫码或账号密码登录</li></ul><h3 id="_2-获取-cookie" tabindex="-1">2. 获取 Cookie <a class="header-anchor" href="#_2-获取-cookie" aria-label="Permalink to “2. 获取 Cookie”">​</a></h3><ul><li>打开浏览器开发者工具（F12）</li><li>进入 <code>Network</code> 标签</li><li>刷新页面</li><li>找到任意请求，查看 <code>Request Headers</code> 中的 <code>Cookie</code></li></ul><h3 id="_3-配置项目-cookie" tabindex="-1">3. 配置项目 Cookie <a class="header-anchor" href="#_3-配置项目-cookie" aria-label="Permalink to “3. 配置项目 Cookie”">​</a></h3><p>将 Cookie 配置到项目全局登录态中，并重启服务。</p><h2 id="测试方法" tabindex="-1">测试方法 <a class="header-anchor" href="#测试方法" aria-label="Permalink to “测试方法”">​</a></h2><h3 id="方法-1-浏览器直接访问" tabindex="-1">方法 1：浏览器直接访问 <a class="header-anchor" href="#方法-1-浏览器直接访问" aria-label="Permalink to “方法 1：浏览器直接访问”">​</a></h3><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>http://localhost:3200/user/getUserPlaylists?uin=你的QQ号</span></span></code></pre></div><p>示例：</p><div class="language-text"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>http://localhost:3200/user/getUserPlaylists?uin=123456789&amp;offset=0&amp;limit=30</span></span></code></pre></div><h3 id="方法-2-使用-curl" tabindex="-1">方法 2：使用 curl <a class="header-anchor" href="#方法-2-使用-curl" aria-label="Permalink to “方法 2：使用 curl”">​</a></h3><div class="language-bash"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#59873A;--shiki-dark:#80A665;">curl</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">http://localhost:3200/user/getUserPlaylists?uin=123456789&amp;offset=0&amp;limit=30</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span></code></pre></div><h3 id="方法-3-使用-postman-或其他-api-工具" tabindex="-1">方法 3：使用 Postman 或其他 API 工具 <a class="header-anchor" href="#方法-3-使用-postman-或其他-api-工具" aria-label="Permalink to “方法 3：使用 Postman 或其他 API 工具”">​</a></h3><ul><li>URL：<code>http://localhost:3200/user/getUserPlaylists</code></li><li>Method：<code>GET</code></li><li>Query Parameters： <ul><li><code>uin</code>: <code>123456789</code></li><li><code>offset</code>: <code>0</code></li><li><code>limit</code>: <code>30</code></li></ul></li></ul><h2 id="响应示例" tabindex="-1">响应示例 <a class="header-anchor" href="#响应示例" aria-label="Permalink to “响应示例”">​</a></h2><h3 id="成功响应" tabindex="-1">成功响应 <a class="header-anchor" href="#成功响应" aria-label="Permalink to “成功响应”">​</a></h3><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">	&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">code</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 0</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">	&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">data</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> {</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">		&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">playlists</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> [</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">			{</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">				&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">dissid</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">123456</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">				&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">dissname</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">我喜欢的音乐</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">			}</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">		]</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">	}</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><h3 id="错误响应" tabindex="-1">错误响应 <a class="header-anchor" href="#错误响应" aria-label="Permalink to “错误响应”">​</a></h3><p><strong>缺少 uin 参数</strong>:</p><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">	&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">error</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">缺少 uin 参数</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><p><strong>Cookie 无效或上游失败</strong>:</p><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
+<span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">	&quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">error</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;"> &quot;</span><span style="--shiki-light:#B56959;--shiki-dark:#C98A7D;">Request failed with status code 404</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span>
+<span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><h2 id="注意事项" tabindex="-1">注意事项 <a class="header-anchor" href="#注意事项" aria-label="Permalink to “注意事项”">​</a></h2><ol><li>此接口需要有效的 QQ 音乐 Cookie 才能正常工作</li><li>如果返回 <code>404</code> 或 <code>502</code>，优先检查 Cookie 是否过期，以及上游接口是否变化</li><li>当前接口对外只保证 <code>playlists</code> 标准化字段，不保证透出完整上游原始结构</li><li>若你需要稳定能力，优先考虑公开歌单类接口，例如歌单详情或歌单分类接口</li></ol><h2 id="常见问题" tabindex="-1">常见问题 <a class="header-anchor" href="#常见问题" aria-label="Permalink to “常见问题”">​</a></h2><h3 id="q-返回-404-错误" tabindex="-1">Q：返回 404 错误 <a class="header-anchor" href="#q-返回-404-错误" aria-label="Permalink to “Q：返回 404 错误”">​</a></h3><p><strong>A</strong>：这通常是因为：</p><ol><li>没有配置有效的 Cookie</li><li>QQ 音乐上游接口已调整</li><li>请求参数不正确</li></ol><h3 id="q-如何获取自己的-qq-号" tabindex="-1">Q：如何获取自己的 QQ 号？ <a class="header-anchor" href="#q-如何获取自己的-qq-号" aria-label="Permalink to “Q：如何获取自己的 QQ 号？”">​</a></h3><p><strong>A</strong>：</p><ul><li>登录 QQ 音乐后访问个人主页</li><li>URL 中 <code>uin=</code> 后面的数字就是你的 QQ 号</li><li>也可以在浏览器开发者工具 Console 中查看当前用户信息</li></ul><h3 id="q-cookie-有效期多久" tabindex="-1">Q：Cookie 有效期多久？ <a class="header-anchor" href="#q-cookie-有效期多久" aria-label="Permalink to “Q：Cookie 有效期多久？”">​</a></h3><p><strong>A</strong>：Cookie 通常可持续一段时间，但登录态失效后需要重新获取并配置。</p><h2 id="替代方案" tabindex="-1">替代方案 <a class="header-anchor" href="#替代方案" aria-label="Permalink to “替代方案”">​</a></h2><p>如果此接口当前不可用，可以考虑：</p><ol><li>使用公开歌单接口</li><li>通过歌单 ID 直接获取歌单详情：<code>/getSongListDetail?disstid=xxx</code></li><li>查看 <a href="./api/user.html"><code>docs/api/user.md</code></a> 与 <a href="./api/playlist.html"><code>docs/api/playlist.md</code></a> 获取其他能力说明</li></ol>`,68)])])}const g=s(t,[["render",h]]);export{c as __pageData,g as default};

package/docs-dist/assets/TEST_USER_PLAYLISTS.md.BfBxYbaM.lean.js

@@ -0,0 +1 @@
+import{c as s,S as a,j as e,m as l}from"./chunks/framework.BUY3a635.js";const c=JSON.parse('{"title":"用户歌单接口测试指南","description":"","frontmatter":{},"headers":[],"relativePath":"TEST_USER_PLAYLISTS.md","filePath":"TEST_USER_PLAYLISTS.md","lastUpdated":1779031768000}'),t={name:"TEST_USER_PLAYLISTS.md"};function h(n,i,d,r,o,k){return a(),e("div",null,[...i[0]||(i[0]=[l("",68)])])}const g=s(t,[["render",h]]);export{c as __pageData,g as default};