@sansenjian/qq-music-api 2.2.7 → 2.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CHANGELOG.md +14 -1
  2. package/README.md +2 -0
  3. package/dist/app.js +24 -5
  4. package/dist/config/service-config.js +37 -0
  5. package/dist/jest.config.js +14 -2
  6. package/dist/middlewares/fallback-middleware.js +29 -0
  7. package/dist/module/apis/music/getMusicPlay.js +187 -0
  8. package/dist/module/apis/u_common.js +8 -2
  9. package/dist/module/apis/user/getUserPlaylists.js +5 -5
  10. package/dist/module/index.js +3 -1
  11. package/dist/package.json +4 -1
  12. package/dist/routers/context/batchGetSongInfo.js +11 -16
  13. package/dist/routers/context/batchGetSongLists.js +18 -20
  14. package/dist/routers/context/getAlbumInfo.js +10 -17
  15. package/dist/routers/context/getComments.js +12 -19
  16. package/dist/routers/context/getDailyRecommend.js +5 -17
  17. package/dist/routers/context/getHotkey.js +7 -8
  18. package/dist/routers/context/getMusicPlay.js +23 -81
  19. package/dist/routers/context/getMv.js +16 -22
  20. package/dist/routers/context/getMvPlay.js +48 -49
  21. package/dist/routers/context/getPersonalRecommend.js +13 -25
  22. package/dist/routers/context/getPlaylistTags.js +20 -26
  23. package/dist/routers/context/getRanks.js +9 -16
  24. package/dist/routers/context/getSingerAlbum.js +16 -22
  25. package/dist/routers/context/getSingerHotsong.js +16 -22
  26. package/dist/routers/context/getSingerList.js +9 -21
  27. package/dist/routers/context/getSongInfo.js +9 -16
  28. package/dist/routers/context/getSongListCategories.js +6 -7
  29. package/dist/routers/context/getSongListDetail.js +6 -8
  30. package/dist/routers/context/getUserAvatar.js +20 -33
  31. package/dist/routers/context/getUserPlaylists.js +6 -3
  32. package/dist/routers/context/index.js +94 -103
  33. package/dist/routers/util.js +31 -0
  34. package/dist/scripts/run-tests-with-flags.js +139 -0
  35. package/dist/util/cookie.js +15 -7
  36. package/dist/util/cookieResolver.js +66 -0
  37. package/dist/util/request.js +15 -6
  38. package/docs-dist/404.html +2 -2
  39. package/docs-dist/CHANGELOG-ARCHITECTURE.html +6 -6
  40. package/docs-dist/COOKIE_CONFIG_GUIDE.html +6 -6
  41. package/docs-dist/FALLBACK_MODE_GUIDE.html +101 -0
  42. package/docs-dist/README.html +6 -6
  43. package/docs-dist/TEST_USER_PLAYLISTS.html +6 -6
  44. package/docs-dist/USER_AVATAR_GUIDE.html +6 -6
  45. package/docs-dist/api/comments.html +6 -6
  46. package/docs-dist/api/index.html +6 -6
  47. package/docs-dist/api/music.html +6 -6
  48. package/docs-dist/api/other.html +6 -6
  49. package/docs-dist/api/playlist.html +6 -6
  50. package/docs-dist/api/rank.html +6 -6
  51. package/docs-dist/api/search.html +6 -6
  52. package/docs-dist/api/singer.html +6 -6
  53. package/docs-dist/api/user.html +6 -6
  54. package/docs-dist/assets/{CHANGELOG-ARCHITECTURE.md.BOe0ZtyR.js → CHANGELOG-ARCHITECTURE.md.r40JGJZK.js} +1 -1
  55. package/docs-dist/assets/{CHANGELOG-ARCHITECTURE.md.BOe0ZtyR.lean.js → CHANGELOG-ARCHITECTURE.md.r40JGJZK.lean.js} +1 -1
  56. package/docs-dist/assets/{COOKIE_CONFIG_GUIDE.md.D68AwXR2.js → COOKIE_CONFIG_GUIDE.md.BVXl7WHu.js} +1 -1
  57. package/docs-dist/assets/{COOKIE_CONFIG_GUIDE.md.D68AwXR2.lean.js → COOKIE_CONFIG_GUIDE.md.BVXl7WHu.lean.js} +1 -1
  58. package/docs-dist/assets/FALLBACK_MODE_GUIDE.md.BBdcIdh_.js +75 -0
  59. package/docs-dist/assets/FALLBACK_MODE_GUIDE.md.BBdcIdh_.lean.js +1 -0
  60. package/docs-dist/assets/{README.md.ZJQGJ1Gb.js → README.md.D6Tw0nRd.js} +1 -1
  61. package/docs-dist/assets/{README.md.ZJQGJ1Gb.lean.js → README.md.D6Tw0nRd.lean.js} +1 -1
  62. package/docs-dist/assets/{TEST_USER_PLAYLISTS.md.C02575X2.js → TEST_USER_PLAYLISTS.md.DSt20Igj.js} +1 -1
  63. package/docs-dist/assets/{TEST_USER_PLAYLISTS.md.C02575X2.lean.js → TEST_USER_PLAYLISTS.md.DSt20Igj.lean.js} +1 -1
  64. package/docs-dist/assets/{USER_AVATAR_GUIDE.md.BOqjn5Cm.js → USER_AVATAR_GUIDE.md.CVHPs2Dn.js} +1 -1
  65. package/docs-dist/assets/{USER_AVATAR_GUIDE.md.BOqjn5Cm.lean.js → USER_AVATAR_GUIDE.md.CVHPs2Dn.lean.js} +1 -1
  66. package/docs-dist/assets/{api_comments.md.DADvndEA.js → api_comments.md.79Q_C8Qp.js} +1 -1
  67. package/docs-dist/assets/{api_comments.md.DADvndEA.lean.js → api_comments.md.79Q_C8Qp.lean.js} +1 -1
  68. package/docs-dist/assets/{api_index.md.D5IASxxG.js → api_index.md.CU3By8tw.js} +1 -1
  69. package/docs-dist/assets/{api_index.md.D5IASxxG.lean.js → api_index.md.CU3By8tw.lean.js} +1 -1
  70. package/docs-dist/assets/{api_music.md.BgB8NmZq.js → api_music.md.B1AzLePX.js} +1 -1
  71. package/docs-dist/assets/{api_music.md.BgB8NmZq.lean.js → api_music.md.B1AzLePX.lean.js} +1 -1
  72. package/docs-dist/assets/{api_other.md.BkRWXX2z.js → api_other.md.DCg4bzA7.js} +1 -1
  73. package/docs-dist/assets/{api_other.md.BkRWXX2z.lean.js → api_other.md.DCg4bzA7.lean.js} +1 -1
  74. package/docs-dist/assets/{api_playlist.md.Dc0hTrZ4.js → api_playlist.md.8ACJ3QqD.js} +1 -1
  75. package/docs-dist/assets/{api_playlist.md.Dc0hTrZ4.lean.js → api_playlist.md.8ACJ3QqD.lean.js} +1 -1
  76. package/docs-dist/assets/{api_rank.md.DRisCFyT.js → api_rank.md.B8IP2ZRy.js} +1 -1
  77. package/docs-dist/assets/{api_rank.md.DRisCFyT.lean.js → api_rank.md.B8IP2ZRy.lean.js} +1 -1
  78. package/docs-dist/assets/{api_search.md.DNnMUZK0.js → api_search.md.DO9J6nvp.js} +1 -1
  79. package/docs-dist/assets/{api_search.md.DNnMUZK0.lean.js → api_search.md.DO9J6nvp.lean.js} +1 -1
  80. package/docs-dist/assets/{api_singer.md.DCmuxQkk.js → api_singer.md.CcL32xuN.js} +1 -1
  81. package/docs-dist/assets/{api_singer.md.DCmuxQkk.lean.js → api_singer.md.CcL32xuN.lean.js} +1 -1
  82. package/docs-dist/assets/{api_user.md.Cjm9GG3z.js → api_user.md.Cb7Ky3Sn.js} +1 -1
  83. package/docs-dist/assets/{api_user.md.Cjm9GG3z.lean.js → api_user.md.Cb7Ky3Sn.lean.js} +1 -1
  84. package/docs-dist/assets/{app.Dx_1wB58.js → app.CSainqD9.js} +1 -1
  85. package/docs-dist/assets/chunks/@localSearchIndexroot.BKleDIv-.js +1 -0
  86. package/docs-dist/assets/chunks/{VPLocalSearchBox.DwKWtsdX.js → VPLocalSearchBox.BUBaq7tw.js} +1 -1
  87. package/docs-dist/assets/chunks/framework.aJbMEiY9.js +19 -0
  88. package/docs-dist/assets/chunks/{theme.pGVgJ9Cx.js → theme.CzMhU0Ps.js} +2 -2
  89. package/docs-dist/assets/{guide_architecture.md.DGtNyuMH.js → guide_architecture.md.CzgqynmB.js} +1 -1
  90. package/docs-dist/assets/{guide_architecture.md.DGtNyuMH.lean.js → guide_architecture.md.CzgqynmB.lean.js} +1 -1
  91. package/docs-dist/assets/{guide_authentication.md.mtI5LfCw.js → guide_authentication.md.a8yTA8Xe.js} +1 -1
  92. package/docs-dist/assets/{guide_authentication.md.mtI5LfCw.lean.js → guide_authentication.md.a8yTA8Xe.lean.js} +1 -1
  93. package/docs-dist/assets/{guide_index.md.B-0SG46T.js → guide_index.md.BgUUL6fI.js} +1 -1
  94. package/docs-dist/assets/{guide_index.md.B-0SG46T.lean.js → guide_index.md.BgUUL6fI.lean.js} +1 -1
  95. package/docs-dist/assets/{guide_installation.md.k-KpAfxv.js → guide_installation.md.BCZ4jBl_.js} +1 -1
  96. package/docs-dist/assets/guide_installation.md.BCZ4jBl_.lean.js +1 -0
  97. package/docs-dist/assets/{guide_quickstart.md.Bff_KFOD.js → guide_quickstart.md.9-4dA6wS.js} +1 -1
  98. package/docs-dist/assets/guide_quickstart.md.9-4dA6wS.lean.js +1 -0
  99. package/docs-dist/assets/{index.md.xrs-uIyo.js → index.md.z0hAJioN.js} +1 -1
  100. package/docs-dist/assets/{index.md.xrs-uIyo.lean.js → index.md.z0hAJioN.lean.js} +1 -1
  101. package/docs-dist/assets/{reference_response-format.md.DKYTK6uJ.js → reference_response-format.md.VvQTLDZr.js} +1 -1
  102. package/docs-dist/assets/{reference_response-format.md.DKYTK6uJ.lean.js → reference_response-format.md.VvQTLDZr.lean.js} +1 -1
  103. package/docs-dist/guide/architecture.html +6 -6
  104. package/docs-dist/guide/authentication.html +6 -6
  105. package/docs-dist/guide/index.html +6 -6
  106. package/docs-dist/guide/installation.html +6 -6
  107. package/docs-dist/guide/quickstart.html +6 -6
  108. package/docs-dist/hashmap.json +1 -1
  109. package/docs-dist/index.html +5 -5
  110. package/docs-dist/reference/response-format.html +6 -6
  111. package/docs-dist/version.json +3 -3
  112. package/package.json +4 -1
  113. package/docs-dist/assets/chunks/@localSearchIndexroot.CMY5EIwU.js +0 -1
  114. package/docs-dist/assets/chunks/framework.o40iizuP.js +0 -19
  115. package/docs-dist/assets/guide_installation.md.k-KpAfxv.lean.js +0 -1
  116. package/docs-dist/assets/guide_quickstart.md.Bff_KFOD.lean.js +0 -1
package/docs-dist/README.html CHANGED
@@ -9,11 +9,11 @@
9
9
  <link rel="preload stylesheet" href="/qq-music-api/assets/style.DM4qKDd4.css" as="style">
10
10
  <link rel="preload stylesheet" href="/qq-music-api/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/qq-music-api/assets/app.Dx_1wB58.js"></script>
12
+ <script type="module" src="/qq-music-api/assets/app.CSainqD9.js"></script>
13
13
  <link rel="preload" href="/qq-music-api/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.pGVgJ9Cx.js">
15
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.o40iizuP.js">
16
- <link rel="modulepreload" href="/qq-music-api/assets/README.md.ZJQGJ1Gb.lean.js">
14
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.CzMhU0Ps.js">
15
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.aJbMEiY9.js">
16
+ <link rel="modulepreload" href="/qq-music-api/assets/README.md.D6Tw0nRd.lean.js">
17
17
  <link rel="icon" href="/logo.svg">
18
18
  <meta name="theme-color" content="#12b7f5">
19
19
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -440,8 +440,8 @@ sortId: 5, sortName: none
440
440
  <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>
441
441
  <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>
442
442
  <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> ]</span></span>
443
- <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 &quot;获取歌曲播放链接&quot;">​</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 &quot;获取单个播放链接&quot;">​</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 &quot;获取多个播放链接&quot;">​</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 &quot;获取多个播放链接&quot;">​</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 &quot;歌曲品质&quot;">​</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 &quot;获取搜索热词&quot;">​</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 &quot;获取关键字搜索提示&quot;">​</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 &quot;获取搜索结果&quot;">​</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 &quot;获取首页推荐&quot;">​</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 &quot;获取排行榜单列表&quot;">​</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 &quot;获取排行榜单详情&quot;">​</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 &quot;获取评论信息(cmd代表的意思没太弄明白)&quot;">​</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 &quot;获取歌曲 + 专辑 图片&quot;">​</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 &quot;获取票务信息&quot;">​</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></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/README.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-08T11:24:20.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
444
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"DADvndEA\",\"api_index.md\":\"D5IASxxG\",\"api_music.md\":\"BgB8NmZq\",\"api_other.md\":\"BkRWXX2z\",\"api_playlist.md\":\"Dc0hTrZ4\",\"api_rank.md\":\"DRisCFyT\",\"api_search.md\":\"DNnMUZK0\",\"api_singer.md\":\"DCmuxQkk\",\"api_user.md\":\"Cjm9GG3z\",\"changelog-architecture.md\":\"BOe0ZtyR\",\"cookie_config_guide.md\":\"D68AwXR2\",\"guide_architecture.md\":\"DGtNyuMH\",\"guide_authentication.md\":\"mtI5LfCw\",\"guide_index.md\":\"B-0SG46T\",\"guide_installation.md\":\"k-KpAfxv\",\"guide_quickstart.md\":\"Bff_KFOD\",\"index.md\":\"xrs-uIyo\",\"readme.md\":\"ZJQGJ1Gb\",\"reference_response-format.md\":\"DKYTK6uJ\",\"test_user_playlists.md\":\"C02575X2\",\"user_avatar_guide.md\":\"BOqjn5Cm\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
443
+ <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 &quot;获取歌曲播放链接&quot;">​</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 &quot;获取单个播放链接&quot;">​</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 &quot;获取多个播放链接&quot;">​</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 &quot;获取多个播放链接&quot;">​</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 &quot;歌曲品质&quot;">​</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 &quot;获取搜索热词&quot;">​</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 &quot;获取关键字搜索提示&quot;">​</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 &quot;获取搜索结果&quot;">​</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 &quot;获取首页推荐&quot;">​</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 &quot;获取排行榜单列表&quot;">​</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 &quot;获取排行榜单详情&quot;">​</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 &quot;获取评论信息(cmd代表的意思没太弄明白)&quot;">​</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 &quot;获取歌曲 + 专辑 图片&quot;">​</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 &quot;获取票务信息&quot;">​</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></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/README.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-14T14:49:32.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
444
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"79Q_C8Qp\",\"api_index.md\":\"CU3By8tw\",\"api_music.md\":\"B1AzLePX\",\"api_other.md\":\"DCg4bzA7\",\"api_playlist.md\":\"8ACJ3QqD\",\"api_rank.md\":\"B8IP2ZRy\",\"api_search.md\":\"DO9J6nvp\",\"api_singer.md\":\"CcL32xuN\",\"api_user.md\":\"Cb7Ky3Sn\",\"changelog-architecture.md\":\"r40JGJZK\",\"cookie_config_guide.md\":\"BVXl7WHu\",\"fallback_mode_guide.md\":\"BBdcIdh_\",\"guide_architecture.md\":\"CzgqynmB\",\"guide_authentication.md\":\"a8yTA8Xe\",\"guide_index.md\":\"BgUUL6fI\",\"guide_installation.md\":\"BCZ4jBl_\",\"guide_quickstart.md\":\"9-4dA6wS\",\"index.md\":\"z0hAJioN\",\"readme.md\":\"D6Tw0nRd\",\"reference_response-format.md\":\"VvQTLDZr\",\"test_user_playlists.md\":\"DSt20Igj\",\"user_avatar_guide.md\":\"CVHPs2Dn\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
445
445
 
446
446
  </body>
447
447
  </html>
package/docs-dist/TEST_USER_PLAYLISTS.html CHANGED
@@ -9,11 +9,11 @@
9
9
  <link rel="preload stylesheet" href="/qq-music-api/assets/style.DM4qKDd4.css" as="style">
10
10
  <link rel="preload stylesheet" href="/qq-music-api/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/qq-music-api/assets/app.Dx_1wB58.js"></script>
12
+ <script type="module" src="/qq-music-api/assets/app.CSainqD9.js"></script>
13
13
  <link rel="preload" href="/qq-music-api/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.pGVgJ9Cx.js">
15
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.o40iizuP.js">
16
- <link rel="modulepreload" href="/qq-music-api/assets/TEST_USER_PLAYLISTS.md.C02575X2.lean.js">
14
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.CzMhU0Ps.js">
15
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.aJbMEiY9.js">
16
+ <link rel="modulepreload" href="/qq-music-api/assets/TEST_USER_PLAYLISTS.md.DSt20Igj.lean.js">
17
17
  <link rel="icon" href="/logo.svg">
18
18
  <meta name="theme-color" content="#12b7f5">
19
19
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -35,8 +35,8 @@
35
35
  <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>
36
36
  <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 vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
37
37
  <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>
38
- <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 &quot;注意事项&quot;">​</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 &quot;常见问题&quot;">​</a></h2><h3 id="q-返回-404-错误" tabindex="-1">Q：返回 404 错误 <a class="header-anchor" href="#q-返回-404-错误" aria-label="Permalink to &quot;Q：返回 404 错误&quot;">​</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 &quot;Q：如何获取自己的 QQ 号？&quot;">​</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 &quot;Q：Cookie 有效期多久？&quot;">​</a></h3><p><strong>A</strong>：Cookie 通常可持续一段时间，但登录态失效后需要重新获取并配置。</p><h2 id="替代方案" tabindex="-1">替代方案 <a class="header-anchor" href="#替代方案" aria-label="Permalink to &quot;替代方案&quot;">​</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></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/TEST_USER_PLAYLISTS.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-08T11:24:20.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
39
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"DADvndEA\",\"api_index.md\":\"D5IASxxG\",\"api_music.md\":\"BgB8NmZq\",\"api_other.md\":\"BkRWXX2z\",\"api_playlist.md\":\"Dc0hTrZ4\",\"api_rank.md\":\"DRisCFyT\",\"api_search.md\":\"DNnMUZK0\",\"api_singer.md\":\"DCmuxQkk\",\"api_user.md\":\"Cjm9GG3z\",\"changelog-architecture.md\":\"BOe0ZtyR\",\"cookie_config_guide.md\":\"D68AwXR2\",\"guide_architecture.md\":\"DGtNyuMH\",\"guide_authentication.md\":\"mtI5LfCw\",\"guide_index.md\":\"B-0SG46T\",\"guide_installation.md\":\"k-KpAfxv\",\"guide_quickstart.md\":\"Bff_KFOD\",\"index.md\":\"xrs-uIyo\",\"readme.md\":\"ZJQGJ1Gb\",\"reference_response-format.md\":\"DKYTK6uJ\",\"test_user_playlists.md\":\"C02575X2\",\"user_avatar_guide.md\":\"BOqjn5Cm\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
38
+ <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 &quot;注意事项&quot;">​</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 &quot;常见问题&quot;">​</a></h2><h3 id="q-返回-404-错误" tabindex="-1">Q：返回 404 错误 <a class="header-anchor" href="#q-返回-404-错误" aria-label="Permalink to &quot;Q：返回 404 错误&quot;">​</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 &quot;Q：如何获取自己的 QQ 号？&quot;">​</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 &quot;Q：Cookie 有效期多久？&quot;">​</a></h3><p><strong>A</strong>：Cookie 通常可持续一段时间，但登录态失效后需要重新获取并配置。</p><h2 id="替代方案" tabindex="-1">替代方案 <a class="header-anchor" href="#替代方案" aria-label="Permalink to &quot;替代方案&quot;">​</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></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/TEST_USER_PLAYLISTS.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-14T14:49:32.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
39
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"79Q_C8Qp\",\"api_index.md\":\"CU3By8tw\",\"api_music.md\":\"B1AzLePX\",\"api_other.md\":\"DCg4bzA7\",\"api_playlist.md\":\"8ACJ3QqD\",\"api_rank.md\":\"B8IP2ZRy\",\"api_search.md\":\"DO9J6nvp\",\"api_singer.md\":\"CcL32xuN\",\"api_user.md\":\"Cb7Ky3Sn\",\"changelog-architecture.md\":\"r40JGJZK\",\"cookie_config_guide.md\":\"BVXl7WHu\",\"fallback_mode_guide.md\":\"BBdcIdh_\",\"guide_architecture.md\":\"CzgqynmB\",\"guide_authentication.md\":\"a8yTA8Xe\",\"guide_index.md\":\"BgUUL6fI\",\"guide_installation.md\":\"BCZ4jBl_\",\"guide_quickstart.md\":\"9-4dA6wS\",\"index.md\":\"z0hAJioN\",\"readme.md\":\"D6Tw0nRd\",\"reference_response-format.md\":\"VvQTLDZr\",\"test_user_playlists.md\":\"DSt20Igj\",\"user_avatar_guide.md\":\"CVHPs2Dn\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
40
40
 
41
41
  </body>
42
42
  </html>
package/docs-dist/USER_AVATAR_GUIDE.html CHANGED
@@ -9,11 +9,11 @@
9
9
  <link rel="preload stylesheet" href="/qq-music-api/assets/style.DM4qKDd4.css" as="style">
10
10
  <link rel="preload stylesheet" href="/qq-music-api/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/qq-music-api/assets/app.Dx_1wB58.js"></script>
12
+ <script type="module" src="/qq-music-api/assets/app.CSainqD9.js"></script>
13
13
  <link rel="preload" href="/qq-music-api/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.pGVgJ9Cx.js">
15
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.o40iizuP.js">
16
- <link rel="modulepreload" href="/qq-music-api/assets/USER_AVATAR_GUIDE.md.BOqjn5Cm.lean.js">
14
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.CzMhU0Ps.js">
15
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.aJbMEiY9.js">
16
+ <link rel="modulepreload" href="/qq-music-api/assets/USER_AVATAR_GUIDE.md.CVHPs2Dn.lean.js">
17
17
  <link rel="icon" href="/logo.svg">
18
18
  <meta name="theme-color" content="#12b7f5">
19
19
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -93,8 +93,8 @@
93
93
  <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> });</span></span>
94
94
  <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> &lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">script</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
95
95
  <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">body</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span>
96
- <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">html</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><h2 id="相关接口" tabindex="-1">相关接口 <a class="header-anchor" href="#相关接口" aria-label="Permalink to &quot;相关接口&quot;">​</a></h2><ul><li><code>/user/getUserPlaylists</code> - 获取用户歌单</li><li><code>/user/getCookie</code> - 获取 Cookie 信息</li><li><code>/getQQLoginQr</code> - 获取 QQ 登录二维码</li></ul></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/USER_AVATAR_GUIDE.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-08T11:24:20.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
97
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"DADvndEA\",\"api_index.md\":\"D5IASxxG\",\"api_music.md\":\"BgB8NmZq\",\"api_other.md\":\"BkRWXX2z\",\"api_playlist.md\":\"Dc0hTrZ4\",\"api_rank.md\":\"DRisCFyT\",\"api_search.md\":\"DNnMUZK0\",\"api_singer.md\":\"DCmuxQkk\",\"api_user.md\":\"Cjm9GG3z\",\"changelog-architecture.md\":\"BOe0ZtyR\",\"cookie_config_guide.md\":\"D68AwXR2\",\"guide_architecture.md\":\"DGtNyuMH\",\"guide_authentication.md\":\"mtI5LfCw\",\"guide_index.md\":\"B-0SG46T\",\"guide_installation.md\":\"k-KpAfxv\",\"guide_quickstart.md\":\"Bff_KFOD\",\"index.md\":\"xrs-uIyo\",\"readme.md\":\"ZJQGJ1Gb\",\"reference_response-format.md\":\"DKYTK6uJ\",\"test_user_playlists.md\":\"C02575X2\",\"user_avatar_guide.md\":\"BOqjn5Cm\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
96
+ <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">&lt;/</span><span style="--shiki-light:#1E754F;--shiki-dark:#4D9375;">html</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">&gt;</span></span></code></pre></div><h2 id="相关接口" tabindex="-1">相关接口 <a class="header-anchor" href="#相关接口" aria-label="Permalink to &quot;相关接口&quot;">​</a></h2><ul><li><code>/user/getUserPlaylists</code> - 获取用户歌单</li><li><code>/user/getCookie</code> - 获取 Cookie 信息</li><li><code>/getQQLoginQr</code> - 获取 QQ 登录二维码</li></ul></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/USER_AVATAR_GUIDE.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-14T14:49:32.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><!----></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
97
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"79Q_C8Qp\",\"api_index.md\":\"CU3By8tw\",\"api_music.md\":\"B1AzLePX\",\"api_other.md\":\"DCg4bzA7\",\"api_playlist.md\":\"8ACJ3QqD\",\"api_rank.md\":\"B8IP2ZRy\",\"api_search.md\":\"DO9J6nvp\",\"api_singer.md\":\"CcL32xuN\",\"api_user.md\":\"Cb7Ky3Sn\",\"changelog-architecture.md\":\"r40JGJZK\",\"cookie_config_guide.md\":\"BVXl7WHu\",\"fallback_mode_guide.md\":\"BBdcIdh_\",\"guide_architecture.md\":\"CzgqynmB\",\"guide_authentication.md\":\"a8yTA8Xe\",\"guide_index.md\":\"BgUUL6fI\",\"guide_installation.md\":\"BCZ4jBl_\",\"guide_quickstart.md\":\"9-4dA6wS\",\"index.md\":\"z0hAJioN\",\"readme.md\":\"D6Tw0nRd\",\"reference_response-format.md\":\"VvQTLDZr\",\"test_user_playlists.md\":\"DSt20Igj\",\"user_avatar_guide.md\":\"CVHPs2Dn\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
98
98
 
99
99
  </body>
100
100
  </html>
package/docs-dist/api/comments.html CHANGED
@@ -9,11 +9,11 @@
9
9
  <link rel="preload stylesheet" href="/qq-music-api/assets/style.DM4qKDd4.css" as="style">
10
10
  <link rel="preload stylesheet" href="/qq-music-api/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/qq-music-api/assets/app.Dx_1wB58.js"></script>
12
+ <script type="module" src="/qq-music-api/assets/app.CSainqD9.js"></script>
13
13
  <link rel="preload" href="/qq-music-api/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.pGVgJ9Cx.js">
15
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.o40iizuP.js">
16
- <link rel="modulepreload" href="/qq-music-api/assets/api_comments.md.DADvndEA.lean.js">
14
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.CzMhU0Ps.js">
15
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.aJbMEiY9.js">
16
+ <link rel="modulepreload" href="/qq-music-api/assets/api_comments.md.79Q_C8Qp.lean.js">
17
17
  <link rel="icon" href="/logo.svg">
18
18
  <meta name="theme-color" content="#12b7f5">
19
19
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
@@ -41,8 +41,8 @@
41
41
  <span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;"> &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">total</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;"> 1000</span></span>
42
42
  <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> }</span></span>
43
43
  <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;"> }</span></span>
44
- <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 &quot;评论类型&quot;">​</a></h2><ul><li><strong>biztype=1</strong>: 歌曲评论</li><li><strong>biztype=2</strong>: 专辑评论</li><li><strong>biztype=3</strong>: 歌单评论</li><li><strong>biztype=4</strong>: MV 评论</li></ul><h2 id="排序方式" tabindex="-1">排序方式 <a class="header-anchor" href="#排序方式" aria-label="Permalink to &quot;排序方式&quot;">​</a></h2><ul><li><strong>reqtype=1</strong>: 推荐排序</li><li><strong>reqtype=2</strong>: 时间排序（最新）</li><li><strong>reqtype=3</strong>: 热度排序（点赞最多）</li></ul><h2 id="相关接口" tabindex="-1">相关接口 <a class="header-anchor" href="#相关接口" aria-label="Permalink to &quot;相关接口&quot;">​</a></h2><ul><li><a href="/qq-music-api/api/music.html">音乐相关 API</a></li><li><a href="/qq-music-api/api/music.html">专辑相关 API</a></li></ul></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/api/comments.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-08T11:24:20.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><a class="VPLink link pager-link prev" href="/qq-music-api/api/search.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Previous page</span><span class="title" data-v-e257564d>搜索</span><!--]--></a></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/api/other.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>其他接口</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
45
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"DADvndEA\",\"api_index.md\":\"D5IASxxG\",\"api_music.md\":\"BgB8NmZq\",\"api_other.md\":\"BkRWXX2z\",\"api_playlist.md\":\"Dc0hTrZ4\",\"api_rank.md\":\"DRisCFyT\",\"api_search.md\":\"DNnMUZK0\",\"api_singer.md\":\"DCmuxQkk\",\"api_user.md\":\"Cjm9GG3z\",\"changelog-architecture.md\":\"BOe0ZtyR\",\"cookie_config_guide.md\":\"D68AwXR2\",\"guide_architecture.md\":\"DGtNyuMH\",\"guide_authentication.md\":\"mtI5LfCw\",\"guide_index.md\":\"B-0SG46T\",\"guide_installation.md\":\"k-KpAfxv\",\"guide_quickstart.md\":\"Bff_KFOD\",\"index.md\":\"xrs-uIyo\",\"readme.md\":\"ZJQGJ1Gb\",\"reference_response-format.md\":\"DKYTK6uJ\",\"test_user_playlists.md\":\"C02575X2\",\"user_avatar_guide.md\":\"BOqjn5Cm\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
44
+ <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 &quot;评论类型&quot;">​</a></h2><ul><li><strong>biztype=1</strong>: 歌曲评论</li><li><strong>biztype=2</strong>: 专辑评论</li><li><strong>biztype=3</strong>: 歌单评论</li><li><strong>biztype=4</strong>: MV 评论</li></ul><h2 id="排序方式" tabindex="-1">排序方式 <a class="header-anchor" href="#排序方式" aria-label="Permalink to &quot;排序方式&quot;">​</a></h2><ul><li><strong>reqtype=1</strong>: 推荐排序</li><li><strong>reqtype=2</strong>: 时间排序（最新）</li><li><strong>reqtype=3</strong>: 热度排序（点赞最多）</li></ul><h2 id="相关接口" tabindex="-1">相关接口 <a class="header-anchor" href="#相关接口" aria-label="Permalink to &quot;相关接口&quot;">​</a></h2><ul><li><a href="/qq-music-api/api/music.html">音乐相关 API</a></li><li><a href="/qq-music-api/api/music.html">专辑相关 API</a></li></ul></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/api/comments.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-14T14:49:32.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><a class="VPLink link pager-link prev" href="/qq-music-api/api/search.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Previous page</span><span class="title" data-v-e257564d>搜索</span><!--]--></a></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/api/other.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>其他接口</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
45
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"79Q_C8Qp\",\"api_index.md\":\"CU3By8tw\",\"api_music.md\":\"B1AzLePX\",\"api_other.md\":\"DCg4bzA7\",\"api_playlist.md\":\"8ACJ3QqD\",\"api_rank.md\":\"B8IP2ZRy\",\"api_search.md\":\"DO9J6nvp\",\"api_singer.md\":\"CcL32xuN\",\"api_user.md\":\"Cb7Ky3Sn\",\"changelog-architecture.md\":\"r40JGJZK\",\"cookie_config_guide.md\":\"BVXl7WHu\",\"fallback_mode_guide.md\":\"BBdcIdh_\",\"guide_architecture.md\":\"CzgqynmB\",\"guide_authentication.md\":\"a8yTA8Xe\",\"guide_index.md\":\"BgUUL6fI\",\"guide_installation.md\":\"BCZ4jBl_\",\"guide_quickstart.md\":\"9-4dA6wS\",\"index.md\":\"z0hAJioN\",\"readme.md\":\"D6Tw0nRd\",\"reference_response-format.md\":\"VvQTLDZr\",\"test_user_playlists.md\":\"DSt20Igj\",\"user_avatar_guide.md\":\"CVHPs2Dn\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
46
46
 
47
47
  </body>
48
48
  </html>
package/docs-dist/api/index.html CHANGED
@@ -9,19 +9,19 @@
9
9
  <link rel="preload stylesheet" href="/qq-music-api/assets/style.DM4qKDd4.css" as="style">
10
10
  <link rel="preload stylesheet" href="/qq-music-api/vp-icons.css" as="style">
11
11
 
12
- <script type="module" src="/qq-music-api/assets/app.Dx_1wB58.js"></script>
12
+ <script type="module" src="/qq-music-api/assets/app.CSainqD9.js"></script>
13
13
  <link rel="preload" href="/qq-music-api/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
14
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.pGVgJ9Cx.js">
15
- <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.o40iizuP.js">
16
- <link rel="modulepreload" href="/qq-music-api/assets/api_index.md.D5IASxxG.lean.js">
14
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.CzMhU0Ps.js">
15
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.aJbMEiY9.js">
16
+ <link rel="modulepreload" href="/qq-music-api/assets/api_index.md.CU3By8tw.lean.js">
17
17
  <link rel="icon" href="/logo.svg">
18
18
  <meta name="theme-color" content="#12b7f5">
19
19
  <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
20
20
  <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
21
21
  </head>
22
22
  <body>
23
- <div id="app"><div class="Layout" data-v-5d98c3a5><!--[--><!--]--><!--[--><span tabindex="-1" data-v-0b0ada53></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-0b0ada53>Skip to content</a><!--]--><!----><header class="VPNav" data-v-5d98c3a5 data-v-ae24b3ad><div class="VPNavBar" data-v-ae24b3ad data-v-6aa21345><div class="wrapper" data-v-6aa21345><div class="container" data-v-6aa21345><div class="title" data-v-6aa21345><div class="VPNavBarTitle has-sidebar" data-v-6aa21345 data-v-1168a8e4><a class="title" href="/qq-music-api/" data-v-1168a8e4><!--[--><!--]--><!--[--><img class="VPImage logo" src="/qq-music-api/logo.svg" alt data-v-8426fc1a><!--]--><span data-v-1168a8e4>QQ Music API</span><!--[--><!--]--></a></div></div><div class="content" data-v-6aa21345><div class="content-body" data-v-6aa21345><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6aa21345><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6aa21345 data-v-dc692963><span id="main-nav-aria-label" class="visually-hidden" data-v-dc692963> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/guide/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>使用指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/qq-music-api/api/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>API 文档</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/api/user.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>用户能力</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/guide/architecture.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>架构说明</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6aa21345 data-v-6c893767><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6c893767 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-6aa21345 data-v-0394ad82 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://github.com/sansenjian/qq-music-api" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-6aa21345 data-v-bb2aa2f0 data-v-cf11d7a2><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-cf11d7a2><span class="vpi-more-horizontal icon" data-v-cf11d7a2></span></button><div class="menu" data-v-cf11d7a2><div class="VPMenu" data-v-cf11d7a2 data-v-b98bc113><!----><!--[--><!--[--><!----><div class="group" data-v-bb2aa2f0><div class="item appearance" data-v-bb2aa2f0><p class="label" data-v-bb2aa2f0>Appearance</p><div class="appearance-action" data-v-bb2aa2f0><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bb2aa2f0 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div></div></div><div class="group" data-v-bb2aa2f0><div class="item social-links" data-v-bb2aa2f0><div class="VPSocialLinks social-links-list" data-v-bb2aa2f0 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://github.com/sansenjian/qq-music-api" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6aa21345 data-v-e5dd9c1c><span class="container" data-v-e5dd9c1c><span class="top" data-v-e5dd9c1c></span><span class="middle" data-v-e5dd9c1c></span><span class="bottom" data-v-e5dd9c1c></span></span></button></div></div></div></div><div class="divider" data-v-6aa21345><div class="divider-line" data-v-6aa21345></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-5d98c3a5 data-v-a6f0e41e><div class="container" data-v-a6f0e41e><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-a6f0e41e><span class="vpi-align-left menu-icon" data-v-a6f0e41e></span><span class="menu-text" data-v-a6f0e41e>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-a6f0e41e data-v-8a42e2b4><button data-v-8a42e2b4>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-5d98c3a5 data-v-319d5ca6><div class="curtain" data-v-319d5ca6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-319d5ca6><span class="visually-hidden" id="sidebar-aria-label" data-v-319d5ca6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>开始使用</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>首页</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>使用指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/installation.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>安装指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/quickstart.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>快速开始</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>认证与用户</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/authentication.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>认证与登录</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/user.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>用户接口</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0 has-active" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>API 文档</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>API 总览</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/music.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>音乐相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/singer.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>歌手相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/playlist.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>歌单相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/rank.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>排行榜</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/search.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>搜索</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/comments.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>评论</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/other.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>其他接口</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>开发与维护</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/reference/response-format.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>响应格式</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/architecture.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>代码架构</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-5d98c3a5 data-v-1428d186><div class="VPDoc has-sidebar has-aside" data-v-1428d186 data-v-39a288b8><!--[--><!--]--><div class="container" data-v-39a288b8><div class="aside" data-v-39a288b8><div class="aside-curtain" data-v-39a288b8></div><div class="aside-container" data-v-39a288b8><div class="aside-content" data-v-39a288b8><div class="VPDocAside" data-v-39a288b8 data-v-3f215769><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-3f215769 data-v-a5bbad30><div class="content" data-v-a5bbad30><div class="outline-marker" data-v-a5bbad30></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-a5bbad30>On this page</div><ul class="VPDocOutlineItem root" data-v-a5bbad30 data-v-b933a997><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-3f215769></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-39a288b8><div class="content-container" data-v-39a288b8><!--[--><!--]--><main class="main" data-v-39a288b8><div style="position:relative;" class="vp-doc _qq-music-api_api_" data-v-39a288b8><div><h1 id="api-文档" tabindex="-1">API 文档 <a class="header-anchor" href="#api-文档" aria-label="Permalink to &quot;API 文档&quot;">​</a></h1><p>本章节提供完整的 API 接口文档，包含所有可用接口的说明、参数与调用示例。</p><h2 id="推荐阅读路径" tabindex="-1">推荐阅读路径 <a class="header-anchor" href="#推荐阅读路径" aria-label="Permalink to &quot;推荐阅读路径&quot;">​</a></h2><ul><li>新用户入口：<a href="/qq-music-api/guide/">使用指南</a></li><li>登录态相关：<a href="/qq-music-api/guide/authentication.html">认证与登录</a></li><li>用户能力入口：<a href="/qq-music-api/api/user.html">用户接口</a></li><li>响应结构说明：<a href="/qq-music-api/reference/response-format.html">响应格式</a></li></ul><h2 id="接口列表" tabindex="-1">接口列表 <a class="header-anchor" href="#接口列表" aria-label="Permalink to &quot;接口列表&quot;">​</a></h2><ul><li><strong><a href="/qq-music-api/api/music.html">音乐相关</a></strong> - 获取歌曲播放链接、歌词、专辑信息等</li><li><strong><a href="/qq-music-api/api/singer.html">歌手相关</a></strong> - 歌手列表、歌手详情、热门歌曲、MV 等</li><li><strong><a href="/qq-music-api/api/playlist.html">歌单相关</a></strong> - 歌单分类、歌单详情、新歌专辑等</li><li><strong><a href="/qq-music-api/api/rank.html">排行榜</a></strong> - 各种音乐排行榜、榜单详情</li><li><strong><a href="/qq-music-api/api/search.html">搜索</a></strong> - 歌曲、歌手、专辑、歌单搜索</li><li><strong><a href="/qq-music-api/api/comments.html">评论</a></strong> - 获取歌曲、专辑等评论数据</li><li><strong><a href="/qq-music-api/api/user.html">用户接口</a></strong> - 用户歌单、用户头像、扫码登录等能力</li><li><strong><a href="/qq-music-api/api/other.html">其他接口</a></strong> - MV、图片、数字专辑、电台、推荐、票务等接口</li></ul><h2 id="使用说明" tabindex="-1">使用说明 <a class="header-anchor" href="#使用说明" aria-label="Permalink to &quot;使用说明&quot;">​</a></h2><p>所有接口均支持 <code>GET</code> 请求，部分接口支持 <code>POST</code> 请求。具体请求方式请参考各接口文档。</p><h3 id="基础-url" tabindex="-1">基础 URL <a class="header-anchor" href="#基础-url" aria-label="Permalink to &quot;基础 URL&quot;">​</a></h3><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>http://localhost:3200</span></span></code></pre></div><h3 id="请求示例" tabindex="-1">请求示例 <a class="header-anchor" href="#请求示例" aria-label="Permalink to &quot;请求示例&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><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/getRanks</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span></code></pre></div></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/api/index.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-08T11:24:20.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><a class="VPLink link pager-link prev" href="/qq-music-api/api/user.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Previous page</span><span class="title" data-v-e257564d>用户接口</span><!--]--></a></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/api/music.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>音乐相关</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
24
- <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"DADvndEA\",\"api_index.md\":\"D5IASxxG\",\"api_music.md\":\"BgB8NmZq\",\"api_other.md\":\"BkRWXX2z\",\"api_playlist.md\":\"Dc0hTrZ4\",\"api_rank.md\":\"DRisCFyT\",\"api_search.md\":\"DNnMUZK0\",\"api_singer.md\":\"DCmuxQkk\",\"api_user.md\":\"Cjm9GG3z\",\"changelog-architecture.md\":\"BOe0ZtyR\",\"cookie_config_guide.md\":\"D68AwXR2\",\"guide_architecture.md\":\"DGtNyuMH\",\"guide_authentication.md\":\"mtI5LfCw\",\"guide_index.md\":\"B-0SG46T\",\"guide_installation.md\":\"k-KpAfxv\",\"guide_quickstart.md\":\"Bff_KFOD\",\"index.md\":\"xrs-uIyo\",\"readme.md\":\"ZJQGJ1Gb\",\"reference_response-format.md\":\"DKYTK6uJ\",\"test_user_playlists.md\":\"C02575X2\",\"user_avatar_guide.md\":\"BOqjn5Cm\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
23
+ <div id="app"><div class="Layout" data-v-5d98c3a5><!--[--><!--]--><!--[--><span tabindex="-1" data-v-0b0ada53></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-0b0ada53>Skip to content</a><!--]--><!----><header class="VPNav" data-v-5d98c3a5 data-v-ae24b3ad><div class="VPNavBar" data-v-ae24b3ad data-v-6aa21345><div class="wrapper" data-v-6aa21345><div class="container" data-v-6aa21345><div class="title" data-v-6aa21345><div class="VPNavBarTitle has-sidebar" data-v-6aa21345 data-v-1168a8e4><a class="title" href="/qq-music-api/" data-v-1168a8e4><!--[--><!--]--><!--[--><img class="VPImage logo" src="/qq-music-api/logo.svg" alt data-v-8426fc1a><!--]--><span data-v-1168a8e4>QQ Music API</span><!--[--><!--]--></a></div></div><div class="content" data-v-6aa21345><div class="content-body" data-v-6aa21345><!--[--><!--]--><div class="VPNavBarSearch search" data-v-6aa21345><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-6aa21345 data-v-dc692963><span id="main-nav-aria-label" class="visually-hidden" data-v-dc692963> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/guide/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>使用指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/qq-music-api/api/" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>API 文档</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/api/user.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>用户能力</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/guide/architecture.html" tabindex="0" data-v-dc692963 data-v-e56f3d57><!--[--><span data-v-e56f3d57>架构说明</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-6aa21345 data-v-6c893767><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-6c893767 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-6aa21345 data-v-0394ad82 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://github.com/sansenjian/qq-music-api" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-6aa21345 data-v-bb2aa2f0 data-v-cf11d7a2><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-cf11d7a2><span class="vpi-more-horizontal icon" data-v-cf11d7a2></span></button><div class="menu" data-v-cf11d7a2><div class="VPMenu" data-v-cf11d7a2 data-v-b98bc113><!----><!--[--><!--[--><!----><div class="group" data-v-bb2aa2f0><div class="item appearance" data-v-bb2aa2f0><p class="label" data-v-bb2aa2f0>Appearance</p><div class="appearance-action" data-v-bb2aa2f0><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-bb2aa2f0 data-v-5337faa4 data-v-1d5665e3><span class="check" data-v-1d5665e3><span class="icon" data-v-1d5665e3><!--[--><span class="vpi-sun sun" data-v-5337faa4></span><span class="vpi-moon moon" data-v-5337faa4></span><!--]--></span></span></button></div></div></div><div class="group" data-v-bb2aa2f0><div class="item social-links" data-v-bb2aa2f0><div class="VPSocialLinks social-links-list" data-v-bb2aa2f0 data-v-7bc22406><!--[--><a class="VPSocialLink no-icon" href="https://github.com/sansenjian/qq-music-api" aria-label="github" target="_blank" rel="noopener" data-v-7bc22406 data-v-bd121fe5><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-6aa21345 data-v-e5dd9c1c><span class="container" data-v-e5dd9c1c><span class="top" data-v-e5dd9c1c></span><span class="middle" data-v-e5dd9c1c></span><span class="bottom" data-v-e5dd9c1c></span></span></button></div></div></div></div><div class="divider" data-v-6aa21345><div class="divider-line" data-v-6aa21345></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-5d98c3a5 data-v-a6f0e41e><div class="container" data-v-a6f0e41e><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-a6f0e41e><span class="vpi-align-left menu-icon" data-v-a6f0e41e></span><span class="menu-text" data-v-a6f0e41e>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-a6f0e41e data-v-8a42e2b4><button data-v-8a42e2b4>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-5d98c3a5 data-v-319d5ca6><div class="curtain" data-v-319d5ca6></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-319d5ca6><span class="visually-hidden" id="sidebar-aria-label" data-v-319d5ca6> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>开始使用</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>首页</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>使用指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/installation.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>安装指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/quickstart.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>快速开始</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>认证与用户</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/authentication.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>认证与登录</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/user.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>用户接口</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0 has-active" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>API 文档</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>API 总览</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/music.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>音乐相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/singer.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>歌手相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/playlist.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>歌单相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/rank.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>排行榜</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/search.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>搜索</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/comments.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>评论</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/api/other.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>其他接口</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-c40bc020><section class="VPSidebarItem level-0" data-v-c40bc020 data-v-b3fd67f8><div class="item" role="button" tabindex="0" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><h2 class="text" data-v-b3fd67f8>开发与维护</h2><!----></div><div class="items" data-v-b3fd67f8><!--[--><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/reference/response-format.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>响应格式</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-b3fd67f8 data-v-b3fd67f8><div class="item" data-v-b3fd67f8><div class="indicator" data-v-b3fd67f8></div><a class="VPLink link link" href="/qq-music-api/guide/architecture.html" data-v-b3fd67f8><!--[--><p class="text" data-v-b3fd67f8>代码架构</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-5d98c3a5 data-v-1428d186><div class="VPDoc has-sidebar has-aside" data-v-1428d186 data-v-39a288b8><!--[--><!--]--><div class="container" data-v-39a288b8><div class="aside" data-v-39a288b8><div class="aside-curtain" data-v-39a288b8></div><div class="aside-container" data-v-39a288b8><div class="aside-content" data-v-39a288b8><div class="VPDocAside" data-v-39a288b8 data-v-3f215769><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-3f215769 data-v-a5bbad30><div class="content" data-v-a5bbad30><div class="outline-marker" data-v-a5bbad30></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-a5bbad30>On this page</div><ul class="VPDocOutlineItem root" data-v-a5bbad30 data-v-b933a997><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-3f215769></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-39a288b8><div class="content-container" data-v-39a288b8><!--[--><!--]--><main class="main" data-v-39a288b8><div style="position:relative;" class="vp-doc _qq-music-api_api_" data-v-39a288b8><div><h1 id="api-文档" tabindex="-1">API 文档 <a class="header-anchor" href="#api-文档" aria-label="Permalink to &quot;API 文档&quot;">​</a></h1><p>本章节提供完整的 API 接口文档，包含所有可用接口的说明、参数与调用示例。</p><h2 id="推荐阅读路径" tabindex="-1">推荐阅读路径 <a class="header-anchor" href="#推荐阅读路径" aria-label="Permalink to &quot;推荐阅读路径&quot;">​</a></h2><ul><li>新用户入口：<a href="/qq-music-api/guide/">使用指南</a></li><li>登录态相关：<a href="/qq-music-api/guide/authentication.html">认证与登录</a></li><li>用户能力入口：<a href="/qq-music-api/api/user.html">用户接口</a></li><li>响应结构说明：<a href="/qq-music-api/reference/response-format.html">响应格式</a></li></ul><h2 id="接口列表" tabindex="-1">接口列表 <a class="header-anchor" href="#接口列表" aria-label="Permalink to &quot;接口列表&quot;">​</a></h2><ul><li><strong><a href="/qq-music-api/api/music.html">音乐相关</a></strong> - 获取歌曲播放链接、歌词、专辑信息等</li><li><strong><a href="/qq-music-api/api/singer.html">歌手相关</a></strong> - 歌手列表、歌手详情、热门歌曲、MV 等</li><li><strong><a href="/qq-music-api/api/playlist.html">歌单相关</a></strong> - 歌单分类、歌单详情、新歌专辑等</li><li><strong><a href="/qq-music-api/api/rank.html">排行榜</a></strong> - 各种音乐排行榜、榜单详情</li><li><strong><a href="/qq-music-api/api/search.html">搜索</a></strong> - 歌曲、歌手、专辑、歌单搜索</li><li><strong><a href="/qq-music-api/api/comments.html">评论</a></strong> - 获取歌曲、专辑等评论数据</li><li><strong><a href="/qq-music-api/api/user.html">用户接口</a></strong> - 用户歌单、用户头像、扫码登录等能力</li><li><strong><a href="/qq-music-api/api/other.html">其他接口</a></strong> - MV、图片、数字专辑、电台、推荐、票务等接口</li></ul><h2 id="使用说明" tabindex="-1">使用说明 <a class="header-anchor" href="#使用说明" aria-label="Permalink to &quot;使用说明&quot;">​</a></h2><p>所有接口均支持 <code>GET</code> 请求，部分接口支持 <code>POST</code> 请求。具体请求方式请参考各接口文档。</p><h3 id="基础-url" tabindex="-1">基础 URL <a class="header-anchor" href="#基础-url" aria-label="Permalink to &quot;基础 URL&quot;">​</a></h3><div class="language-text vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">text</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>http://localhost:3200</span></span></code></pre></div><h3 id="请求示例" tabindex="-1">请求示例 <a class="header-anchor" href="#请求示例" aria-label="Permalink to &quot;请求示例&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><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/getRanks</span><span style="--shiki-light:#B5695977;--shiki-dark:#C98A7D77;">&quot;</span></span></code></pre></div></div></div></main><footer class="VPDocFooter" data-v-39a288b8 data-v-e257564d><!--[--><!--]--><div class="edit-info" data-v-e257564d><div class="edit-link" data-v-e257564d><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/sansenjian/qq-music-api/edit/main/docs/api/index.md" target="_blank" rel="noreferrer" data-v-e257564d><!--[--><span class="vpi-square-pen edit-link-icon" data-v-e257564d></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-e257564d><p class="VPLastUpdated" data-v-e257564d data-v-e98dd255>Last updated: <time datetime="2026-03-14T14:49:32.000Z" data-v-e98dd255></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-e257564d><span class="visually-hidden" id="doc-footer-aria-label" data-v-e257564d>Pager</span><div class="pager" data-v-e257564d><a class="VPLink link pager-link prev" href="/qq-music-api/api/user.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Previous page</span><span class="title" data-v-e257564d>用户接口</span><!--]--></a></div><div class="pager" data-v-e257564d><a class="VPLink link pager-link next" href="/qq-music-api/api/music.html" data-v-e257564d><!--[--><span class="desc" data-v-e257564d>Next page</span><span class="title" data-v-e257564d>音乐相关</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-5d98c3a5 data-v-e315a0ad><div class="container" data-v-e315a0ad><p class="message" data-v-e315a0ad>基于 MIT 许可发布</p><p class="copyright" data-v-e315a0ad>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
24
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"79Q_C8Qp\",\"api_index.md\":\"CU3By8tw\",\"api_music.md\":\"B1AzLePX\",\"api_other.md\":\"DCg4bzA7\",\"api_playlist.md\":\"8ACJ3QqD\",\"api_rank.md\":\"B8IP2ZRy\",\"api_search.md\":\"DO9J6nvp\",\"api_singer.md\":\"CcL32xuN\",\"api_user.md\":\"Cb7Ky3Sn\",\"changelog-architecture.md\":\"r40JGJZK\",\"cookie_config_guide.md\":\"BVXl7WHu\",\"fallback_mode_guide.md\":\"BBdcIdh_\",\"guide_architecture.md\":\"CzgqynmB\",\"guide_authentication.md\":\"a8yTA8Xe\",\"guide_index.md\":\"BgUUL6fI\",\"guide_installation.md\":\"BCZ4jBl_\",\"guide_quickstart.md\":\"9-4dA6wS\",\"index.md\":\"z0hAJioN\",\"readme.md\":\"D6Tw0nRd\",\"reference_response-format.md\":\"VvQTLDZr\",\"test_user_playlists.md\":\"DSt20Igj\",\"user_avatar_guide.md\":\"CVHPs2Dn\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"QQ Music API\",\"description\":\"QQ 音乐 API 接口文档\",\"base\":\"/qq-music-api/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":\"/logo.svg\",\"nav\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"API 文档\",\"link\":\"/api/\"},{\"text\":\"用户能力\",\"link\":\"/api/user\"},{\"text\":\"架构说明\",\"link\":\"/guide/architecture\"}],\"sidebar\":[{\"text\":\"开始使用\",\"items\":[{\"text\":\"首页\",\"link\":\"/\"},{\"text\":\"使用指南\",\"link\":\"/guide/\"},{\"text\":\"安装指南\",\"link\":\"/guide/installation\"},{\"text\":\"快速开始\",\"link\":\"/guide/quickstart\"}]},{\"text\":\"认证与用户\",\"items\":[{\"text\":\"认证与登录\",\"link\":\"/guide/authentication\"},{\"text\":\"用户接口\",\"link\":\"/api/user\"}]},{\"text\":\"API 文档\",\"items\":[{\"text\":\"API 总览\",\"link\":\"/api/\"},{\"text\":\"音乐相关\",\"link\":\"/api/music\"},{\"text\":\"歌手相关\",\"link\":\"/api/singer\"},{\"text\":\"歌单相关\",\"link\":\"/api/playlist\"},{\"text\":\"排行榜\",\"link\":\"/api/rank\"},{\"text\":\"搜索\",\"link\":\"/api/search\"},{\"text\":\"评论\",\"link\":\"/api/comments\"},{\"text\":\"其他接口\",\"link\":\"/api/other\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"search\":{\"provider\":\"local\",\"options\":{\"locales\":{\"root\":{\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"navigateText\":\"切换\"}}}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
25
25
 
26
26
  </body>
27
27
  </html>