@sansenjian/qq-music-api 2.2.10 → 2.3.1

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 (169) hide show
  1. package/CHANGELOG.md +19 -1
  2. package/README.md +10 -11
  3. package/dist/app.js +0 -1
  4. package/dist/koaApp.js +5 -1
  5. package/dist/module/apis/downloadQQMusic.js +2 -1
  6. package/dist/module/apis/music/getMusicPlay.js +3 -2
  7. package/dist/package.json +20 -16
  8. package/dist/routers/context/getNewDisks.js +4 -0
  9. package/dist/routers/context/getRecommend.js +4 -0
  10. package/dist/routers/context/getTicketInfo.js +4 -0
  11. package/dist/util/cookieResolver.js +10 -4
  12. package/docs-dist/404.html +6 -6
  13. package/docs-dist/CHANGELOG-ARCHITECTURE.html +14 -14
  14. package/docs-dist/COOKIE_CONFIG_GUIDE.html +13 -13
  15. package/docs-dist/DEGRADE_EXAMPLES.html +109 -0
  16. package/docs-dist/FALLBACK_MODE_GUIDE.html +21 -21
  17. package/docs-dist/QUICK_START.html +62 -0
  18. package/docs-dist/README.html +17 -17
  19. package/docs-dist/TEST_USER_PLAYLISTS.html +14 -14
  20. package/docs-dist/USER_AVATAR_GUIDE.html +16 -16
  21. package/docs-dist/api/comments.html +12 -12
  22. package/docs-dist/api/index.html +10 -10
  23. package/docs-dist/api/music.html +15 -13
  24. package/docs-dist/api/other.html +13 -13
  25. package/docs-dist/api/playground.html +27 -0
  26. package/docs-dist/api/playlist.html +15 -15
  27. package/docs-dist/api/rank.html +12 -12
  28. package/docs-dist/api/search.html +13 -13
  29. package/docs-dist/api/singer.html +12 -12
  30. package/docs-dist/api/user.html +16 -16
  31. package/docs-dist/assets/{CHANGELOG-ARCHITECTURE.md.DV9Xr7ve.js → CHANGELOG-ARCHITECTURE.md.CYHmaBdY.js} +5 -5
  32. package/docs-dist/assets/CHANGELOG-ARCHITECTURE.md.CYHmaBdY.lean.js +1 -0
  33. package/docs-dist/assets/COOKIE_CONFIG_GUIDE.md.Nvywo7CW.js +13 -0
  34. package/docs-dist/assets/COOKIE_CONFIG_GUIDE.md.Nvywo7CW.lean.js +1 -0
  35. package/docs-dist/assets/DEGRADE_EXAMPLES.md.Cz2J-qwE.js +83 -0
  36. package/docs-dist/assets/DEGRADE_EXAMPLES.md.Cz2J-qwE.lean.js +1 -0
  37. package/docs-dist/assets/{FALLBACK_MODE_GUIDE.md.0wqXqYxw.js → FALLBACK_MODE_GUIDE.md.wKA9yqoI.js} +12 -12
  38. package/docs-dist/assets/FALLBACK_MODE_GUIDE.md.wKA9yqoI.lean.js +1 -0
  39. package/docs-dist/assets/QUICK_START.md.D5KfDgbs.js +36 -0
  40. package/docs-dist/assets/QUICK_START.md.D5KfDgbs.lean.js +1 -0
  41. package/docs-dist/assets/README.md.CHbArqA7.js +421 -0
  42. package/docs-dist/assets/README.md.CHbArqA7.lean.js +1 -0
  43. package/docs-dist/assets/TEST_USER_PLAYLISTS.md.BfBxYbaM.js +16 -0
  44. package/docs-dist/assets/TEST_USER_PLAYLISTS.md.BfBxYbaM.lean.js +1 -0
  45. package/docs-dist/assets/{USER_AVATAR_GUIDE.md.CGPI9GUj.js → USER_AVATAR_GUIDE.md.D5Rti1Gg.js} +7 -7
  46. package/docs-dist/assets/USER_AVATAR_GUIDE.md.D5Rti1Gg.lean.js +1 -0
  47. package/docs-dist/assets/{api_comments.md.CATvWhrg.js → api_comments.md.5nDhrWa8.js} +3 -3
  48. package/docs-dist/assets/api_comments.md.5nDhrWa8.lean.js +1 -0
  49. package/docs-dist/assets/api_index.md.DdG1WHkZ.js +1 -0
  50. package/docs-dist/assets/api_index.md.DdG1WHkZ.lean.js +1 -0
  51. package/docs-dist/assets/{api_music.md.D20_neZB.js → api_music.md.D66hq-_4.js} +6 -4
  52. package/docs-dist/assets/api_music.md.D66hq-_4.lean.js +1 -0
  53. package/docs-dist/assets/api_other.md.9KhspVEM.js +7 -0
  54. package/docs-dist/assets/api_other.md.9KhspVEM.lean.js +1 -0
  55. package/docs-dist/assets/api_playground.md.BZBvYMm2.js +11 -0
  56. package/docs-dist/assets/api_playground.md.BZBvYMm2.lean.js +11 -0
  57. package/docs-dist/assets/{api_playlist.md.CyLdLRR9.js → api_playlist.md.BQK32ZyE.js} +6 -6
  58. package/docs-dist/assets/api_playlist.md.BQK32ZyE.lean.js +1 -0
  59. package/docs-dist/assets/{api_rank.md.Z3xyYG_S.js → api_rank.md.z7YBwVgw.js} +3 -3
  60. package/docs-dist/assets/api_rank.md.z7YBwVgw.lean.js +1 -0
  61. package/docs-dist/assets/{api_search.md.D_lbFmYo.js → api_search.md.GfzIBRfc.js} +4 -4
  62. package/docs-dist/assets/api_search.md.GfzIBRfc.lean.js +1 -0
  63. package/docs-dist/assets/api_singer.md.BDR-_qDH.js +21 -0
  64. package/docs-dist/assets/api_singer.md.BDR-_qDH.lean.js +1 -0
  65. package/docs-dist/assets/{api_user.md.4WdmTXIB.js → api_user.md.Dx8BWGrb.js} +7 -7
  66. package/docs-dist/assets/api_user.md.Dx8BWGrb.lean.js +1 -0
  67. package/docs-dist/assets/app.CxuIZ1W7.js +1 -0
  68. package/docs-dist/assets/chunks/@localSearchIndexroot.ygoKgu27.js +1 -0
  69. package/docs-dist/assets/chunks/VPLocalSearchBox.BqgkAhNM.js +3 -0
  70. package/docs-dist/assets/chunks/framework.BUY3a635.js +4 -0
  71. package/docs-dist/assets/chunks/theme.C-Z3DN0r.js +2 -0
  72. package/docs-dist/assets/{guide_architecture.md.D_46khUI.js → guide_architecture.md.SHnKkzwb.js} +20 -20
  73. package/docs-dist/assets/guide_architecture.md.SHnKkzwb.lean.js +1 -0
  74. package/docs-dist/assets/guide_authentication.md.CZCKocgR.js +4 -0
  75. package/docs-dist/assets/guide_authentication.md.CZCKocgR.lean.js +1 -0
  76. package/docs-dist/assets/guide_index.md.CkJ-jjL0.js +1 -0
  77. package/docs-dist/assets/guide_index.md.CkJ-jjL0.lean.js +1 -0
  78. package/docs-dist/assets/guide_installation.md.D2TBzILh.js +7 -0
  79. package/docs-dist/assets/guide_installation.md.D2TBzILh.lean.js +1 -0
  80. package/docs-dist/assets/guide_quickstart.md.J7Sib8wg.js +13 -0
  81. package/docs-dist/assets/guide_quickstart.md.J7Sib8wg.lean.js +1 -0
  82. package/docs-dist/assets/index.md.ClwYf6Qc.js +1 -0
  83. package/docs-dist/assets/index.md.ClwYf6Qc.lean.js +1 -0
  84. package/docs-dist/assets/inter-italic-cyrillic-ext._dlW9xFb.woff2 +0 -0
  85. package/docs-dist/assets/inter-italic-cyrillic.D7dRslh9.woff2 +0 -0
  86. package/docs-dist/assets/inter-italic-greek-ext.Ct-Tf2bq.woff2 +0 -0
  87. package/docs-dist/assets/inter-italic-greek.DNcpQ8QC.woff2 +0 -0
  88. package/docs-dist/assets/inter-italic-latin-ext.DytegdRQ.woff2 +0 -0
  89. package/docs-dist/assets/inter-italic-latin.COaG5lWR.woff2 +0 -0
  90. package/docs-dist/assets/inter-italic-vietnamese.BI5UxJD-.woff2 +0 -0
  91. package/docs-dist/assets/inter-roman-cyrillic-ext.BeNbU08G.woff2 +0 -0
  92. package/docs-dist/assets/inter-roman-cyrillic.CD0kT8R4.woff2 +0 -0
  93. package/docs-dist/assets/inter-roman-greek-ext.CFAEQ5Ow.woff2 +0 -0
  94. package/docs-dist/assets/inter-roman-greek.Dsf7YjP7.woff2 +0 -0
  95. package/docs-dist/assets/inter-roman-latin-ext.Dl_ayf4-.woff2 +0 -0
  96. package/docs-dist/assets/inter-roman-latin.Cy4MYw_J.woff2 +0 -0
  97. package/docs-dist/assets/inter-roman-vietnamese.CpqCnS2H.woff2 +0 -0
  98. package/docs-dist/assets/reference_response-format.md.BrGoGoPV.js +12 -0
  99. package/docs-dist/assets/reference_response-format.md.BrGoGoPV.lean.js +1 -0
  100. package/docs-dist/assets/style.D_YoXH3a.css +1 -0
  101. package/docs-dist/guide/architecture.html +29 -29
  102. package/docs-dist/guide/authentication.html +12 -12
  103. package/docs-dist/guide/index.html +10 -10
  104. package/docs-dist/guide/installation.html +13 -13
  105. package/docs-dist/guide/quickstart.html +15 -15
  106. package/docs-dist/hashmap.json +1 -1
  107. package/docs-dist/index.html +10 -10
  108. package/docs-dist/reference/response-format.html +13 -13
  109. package/docs-dist/version.json +3 -3
  110. package/package.json +20 -16
  111. package/public/index.html +966 -0
  112. package/public/playground-utils.js +150 -0
  113. package/dist/jest.config.js +0 -52
  114. package/dist/scripts/run-tests-with-flags.js +0 -139
  115. package/dist/types/api.js +0 -55
  116. package/docs-dist/assets/CHANGELOG-ARCHITECTURE.md.DV9Xr7ve.lean.js +0 -1
  117. package/docs-dist/assets/COOKIE_CONFIG_GUIDE.md.B2-aTdcH.js +0 -13
  118. package/docs-dist/assets/COOKIE_CONFIG_GUIDE.md.B2-aTdcH.lean.js +0 -1
  119. package/docs-dist/assets/FALLBACK_MODE_GUIDE.md.0wqXqYxw.lean.js +0 -1
  120. package/docs-dist/assets/README.md.DFCMeLFa.js +0 -421
  121. package/docs-dist/assets/README.md.DFCMeLFa.lean.js +0 -1
  122. package/docs-dist/assets/TEST_USER_PLAYLISTS.md.Bj0AVpHw.js +0 -16
  123. package/docs-dist/assets/TEST_USER_PLAYLISTS.md.Bj0AVpHw.lean.js +0 -1
  124. package/docs-dist/assets/USER_AVATAR_GUIDE.md.CGPI9GUj.lean.js +0 -1
  125. package/docs-dist/assets/api_comments.md.CATvWhrg.lean.js +0 -1
  126. package/docs-dist/assets/api_index.md.Dqx3qXyO.js +0 -1
  127. package/docs-dist/assets/api_index.md.Dqx3qXyO.lean.js +0 -1
  128. package/docs-dist/assets/api_music.md.D20_neZB.lean.js +0 -1
  129. package/docs-dist/assets/api_other.md.CXyEsl8R.js +0 -7
  130. package/docs-dist/assets/api_other.md.CXyEsl8R.lean.js +0 -1
  131. package/docs-dist/assets/api_playlist.md.CyLdLRR9.lean.js +0 -1
  132. package/docs-dist/assets/api_rank.md.Z3xyYG_S.lean.js +0 -1
  133. package/docs-dist/assets/api_search.md.D_lbFmYo.lean.js +0 -1
  134. package/docs-dist/assets/api_singer.md.BbyYE88D.js +0 -21
  135. package/docs-dist/assets/api_singer.md.BbyYE88D.lean.js +0 -1
  136. package/docs-dist/assets/api_user.md.4WdmTXIB.lean.js +0 -1
  137. package/docs-dist/assets/app.2f7gcITE.js +0 -1
  138. package/docs-dist/assets/chunks/@localSearchIndexroot.D461xa5C.js +0 -1
  139. package/docs-dist/assets/chunks/VPLocalSearchBox.BiPSl83v.js +0 -9
  140. package/docs-dist/assets/chunks/framework.aJbMEiY9.js +0 -19
  141. package/docs-dist/assets/chunks/theme.BrMPT0hE.js +0 -2
  142. package/docs-dist/assets/guide_architecture.md.D_46khUI.lean.js +0 -1
  143. package/docs-dist/assets/guide_authentication.md.nCiAu07w.js +0 -4
  144. package/docs-dist/assets/guide_authentication.md.nCiAu07w.lean.js +0 -1
  145. package/docs-dist/assets/guide_index.md.gLozHqz5.js +0 -1
  146. package/docs-dist/assets/guide_index.md.gLozHqz5.lean.js +0 -1
  147. package/docs-dist/assets/guide_installation.md.BUDl8zk1.js +0 -7
  148. package/docs-dist/assets/guide_installation.md.BUDl8zk1.lean.js +0 -1
  149. package/docs-dist/assets/guide_quickstart.md.COQUzUN9.js +0 -13
  150. package/docs-dist/assets/guide_quickstart.md.COQUzUN9.lean.js +0 -1
  151. package/docs-dist/assets/index.md.DBZfQ2kF.js +0 -1
  152. package/docs-dist/assets/index.md.DBZfQ2kF.lean.js +0 -1
  153. package/docs-dist/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 +0 -0
  154. package/docs-dist/assets/inter-italic-cyrillic.By2_1cv3.woff2 +0 -0
  155. package/docs-dist/assets/inter-italic-greek-ext.1u6EdAuj.woff2 +0 -0
  156. package/docs-dist/assets/inter-italic-greek.DJ8dCoTZ.woff2 +0 -0
  157. package/docs-dist/assets/inter-italic-latin-ext.CN1xVJS-.woff2 +0 -0
  158. package/docs-dist/assets/inter-italic-latin.C2AdPX0b.woff2 +0 -0
  159. package/docs-dist/assets/inter-italic-vietnamese.BSbpV94h.woff2 +0 -0
  160. package/docs-dist/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 +0 -0
  161. package/docs-dist/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 +0 -0
  162. package/docs-dist/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 +0 -0
  163. package/docs-dist/assets/inter-roman-greek.BBVDIX6e.woff2 +0 -0
  164. package/docs-dist/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 +0 -0
  165. package/docs-dist/assets/inter-roman-latin.Di8DUHzh.woff2 +0 -0
  166. package/docs-dist/assets/inter-roman-vietnamese.BjW4sHH5.woff2 +0 -0
  167. package/docs-dist/assets/reference_response-format.md.yrdeqFUN.js +0 -12
  168. package/docs-dist/assets/reference_response-format.md.yrdeqFUN.lean.js +0 -1
  169. package/docs-dist/assets/style.DM4qKDd4.css +0 -1
@@ -1,29 +1,29 @@
1
1
  <!DOCTYPE html>
2
- <html lang="en-US" dir="ltr">
2
+ <html lang="zh-CN" dir="ltr">
3
3
  <head>
4
4
  <meta charset="utf-8">
5
5
  <meta name="viewport" content="width=device-width,initial-scale=1">
6
6
  <title>QQ Music API</title>
7
7
  <meta name="description" content="QQ 音乐 API 接口文档">
8
- <meta name="generator" content="VitePress v1.6.4">
9
- <link rel="preload stylesheet" href="/qq-music-api/assets/style.DM4qKDd4.css" as="style">
8
+ <meta name="generator" content="VitePress v2.0.0-alpha.17">
9
+ <link rel="preload stylesheet" href="/qq-music-api/assets/style.D_YoXH3a.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.2f7gcITE.js"></script>
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.BrMPT0hE.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.DFCMeLFa.lean.js">
12
+ <script type="module" src="/qq-music-api/assets/app.CxuIZ1W7.js"></script>
13
+ <link rel="preload" href="/qq-music-api/assets/inter-roman-latin.Cy4MYw_J.woff2" as="font" type="font/woff2" crossorigin="">
14
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/theme.C-Z3DN0r.js">
15
+ <link rel="modulepreload" href="/qq-music-api/assets/chunks/framework.BUY3a635.js">
16
+ <link rel="modulepreload" href="/qq-music-api/assets/README.md.CHbArqA7.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" 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" 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_README" data-v-39a288b8><div><h2 align="center" id="qqmusicapi">QQ Music API</h2><p>!&gt; QQ音乐API koa2 版本, 通过Web网页版请求QQ音乐接口数据, 有问题请提 <a href="https://github.com/Rain120/qq-music-api/issues" target="_blank" rel="noreferrer">issue</a>, 或者你有其他想法欢迎<code>PR</code>.</p><h2 id="api结构图" tabindex="-1">API结构图 <a class="header-anchor" href="#api结构图" aria-label="Permalink to &quot;API结构图&quot;">​</a></h2><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/qq-music.png" alt="qq-music"></p><h2 id="api接口" tabindex="-1">API接口 <a class="header-anchor" href="#api接口" aria-label="Permalink to &quot;API接口&quot;">​</a></h2><p>!&gt; koa2 接口说明(参数, 地址, 效果图)</p><h2 id="新特性" tabindex="-1">新特性 <a class="header-anchor" href="#新特性" aria-label="Permalink to &quot;新特性&quot;">​</a></h2><h3 id="支持自定义设置cookie" tabindex="-1">支持自定义设置cookie <a class="header-anchor" href="#支持自定义设置cookie" aria-label="Permalink to &quot;支持自定义设置cookie&quot;">​</a></h3><p>!&gt; 2020-01-23 新增, 只需要配置 <code>config/user-info.js</code> 中的 <code>cookies</code> 字段就会在发送请求时带上你的 <code>cookies</code>。</p><h4 id="格式化自定义的-cookie" tabindex="-1">格式化自定义的 cookie <a class="header-anchor" href="#格式化自定义的-cookie" aria-label="Permalink to &quot;格式化自定义的 cookie&quot;">​</a></h4><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/normalize-cookie.png" alt="normalize-cookie.png"></p><h3 id="特性提示支持" tabindex="-1">特性提示支持 <a class="header-anchor" href="#特性提示支持" aria-label="Permalink to &quot;特性提示支持&quot;">​</a></h3><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/new-feature-error-tips.png" alt="new-feature-error-tips.png"></p><h3 id="获取-cookie" tabindex="-1">获取 Cookie <a class="header-anchor" href="#获取-cookie" aria-label="Permalink to &quot;获取 Cookie&quot;">​</a></h3><p>!&gt; 目前只支持用户自己从 <em>QQ音乐</em> 获取获取 <code>Cookie</code>, 如何获取 <code>Cookie</code>, 登录 <code>QQ音乐</code>, 然后 <code>F12</code>, 找到 <code>Network</code>, 随便找一个获取数据的接口, 复制接口中 <code>request headers</code> 中的 <code>Cookie</code> 即可。</p><p>接口说明: 调用此接口, 可获取自己在 <code>config/user-info.js</code> 配置的 <code>Cookie</code> 被格式化的结果</p><p>配置信息如下:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>const userInfo = {</span></span>
23
+ <div id="app"><div class="Layout" data-v-0cf61682><!--[--><!--]--><!--[--><span tabindex="-1" data-v-331ec75c></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-331ec75c>跳转到内容</a><!--]--><!----><header class="VPNav" data-v-0cf61682 data-v-9f75dce3><div class="VPNavBar has-sidebar top" data-v-9f75dce3 data-v-9ca1369d><div class="wrapper" data-v-9ca1369d><div class="container" data-v-9ca1369d><div class="title" data-v-9ca1369d><div class="VPNavBarTitle has-sidebar" data-v-9ca1369d data-v-1e38c6bc><a class="title" href="/qq-music-api/" data-v-1e38c6bc><!--[--><!--]--><!--[--><img class="VPImage logo" src="/qq-music-api/logo.svg" alt data-v-8426fc1a><!--]--><span data-v-1e38c6bc>QQ Music API</span><!--[--><!--]--></a></div></div><div class="content" data-v-9ca1369d><div class="content-body" data-v-9ca1369d><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9ca1369d data-v-2fc7f2c6><!--[--><button type="button" class="VPNavBarSearchButton" aria-label="搜索文档" aria-keyshortcuts="/ control+k meta+k" data-v-2fc7f2c6 data-v-baa3be99><span class="vpi-search" aria-hidden="true" data-v-baa3be99></span><span class="text" data-v-baa3be99>搜索</span><span class="keys" aria-hidden="true" data-v-baa3be99><kbd class="key-cmd" data-v-baa3be99>⌘</kbd><kbd class="key-ctrl" data-v-baa3be99>Ctrl</kbd><kbd data-v-baa3be99>K</kbd></span></button><!----><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9ca1369d data-v-39714824><span id="main-nav-aria-label" class="visually-hidden" data-v-39714824> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/" tabindex="0" data-v-39714824 data-v-6dd25bb8><!--[--><span data-v-6dd25bb8>首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/guide/" tabindex="0" data-v-39714824 data-v-6dd25bb8><!--[--><span data-v-6dd25bb8>使用指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/api/" tabindex="0" data-v-39714824 data-v-6dd25bb8><!--[--><span data-v-6dd25bb8>API 文档</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/api/playground.html" tabindex="0" data-v-39714824 data-v-6dd25bb8><!--[--><span data-v-6dd25bb8>API 调试台</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/api/user.html" tabindex="0" data-v-39714824 data-v-6dd25bb8><!--[--><span data-v-6dd25bb8>用户能力</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/qq-music-api/guide/architecture.html" tabindex="0" data-v-39714824 data-v-6dd25bb8><!--[--><span data-v-6dd25bb8>架构说明</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9ca1369d 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-9ca1369d data-v-0394ad82 data-v-d07f11e6><!--[--><a class="VPSocialLink no-icon" href="https://github.com/sansenjian/qq-music-api" aria-label="github" target="_blank" rel="me noopener" data-v-d07f11e6 data-v-591a6b30><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9ca1369d data-v-562c832a data-v-42cb505d><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-42cb505d><span class="vpi-more-horizontal icon" data-v-42cb505d></span></button><div class="menu" data-v-42cb505d><div class="VPMenu" data-v-42cb505d data-v-25a6cce8><!----><!--[--><!--[--><!----><div class="group" data-v-562c832a><div class="item appearance" data-v-562c832a><p class="label" data-v-562c832a>主题</p><div class="appearance-action" data-v-562c832a><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-562c832a 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-562c832a><div class="item social-links" data-v-562c832a><div class="VPSocialLinks social-links-list" data-v-562c832a data-v-d07f11e6><!--[--><a class="VPSocialLink no-icon" href="https://github.com/sansenjian/qq-music-api" aria-label="github" target="_blank" rel="me noopener" data-v-d07f11e6 data-v-591a6b30><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-9ca1369d 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-9ca1369d><div class="divider-line" data-v-9ca1369d></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-0cf61682 data-v-db738f89><div class="container" data-v-db738f89><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-db738f89><span class="vpi-align-left menu-icon" data-v-db738f89></span><span class="menu-text" data-v-db738f89>菜单</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-db738f89 data-v-0bf0e06f><button data-v-0bf0e06f>返回顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-0cf61682 data-v-af661f50><div class="curtain" data-v-af661f50></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-af661f50><span class="visually-hidden" id="sidebar-aria-label" data-v-af661f50> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-8d50c081><section class="VPSidebarItem level-0" data-v-8d50c081 data-v-d81de50c><div class="item" role="button" tabindex="0" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><h2 class="text" data-v-d81de50c>开始使用</h2><!----></div><div class="items" data-v-d81de50c><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>首页</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/guide/" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>使用指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/guide/installation.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>安装指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/guide/quickstart.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>快速开始</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/QUICK_START.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>快速使用指南</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/DEGRADE_EXAMPLES.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>降级服务示例</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8d50c081><section class="VPSidebarItem level-0" data-v-8d50c081 data-v-d81de50c><div class="item" role="button" tabindex="0" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><h2 class="text" data-v-d81de50c>认证与用户</h2><!----></div><div class="items" data-v-d81de50c><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/guide/authentication.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>认证与登录</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/user.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>用户接口</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8d50c081><section class="VPSidebarItem level-0" data-v-8d50c081 data-v-d81de50c><div class="item" role="button" tabindex="0" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><h2 class="text" data-v-d81de50c>API 文档</h2><!----></div><div class="items" data-v-d81de50c><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>API 总览</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/music.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>音乐相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/singer.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>歌手相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/playlist.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>歌单相关</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/rank.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>排行榜</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/search.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>搜索</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/comments.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>评论</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/other.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>其他接口</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/api/playground.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>API 调试台</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-8d50c081><section class="VPSidebarItem level-0" data-v-8d50c081 data-v-d81de50c><div class="item" role="button" tabindex="0" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><h2 class="text" data-v-d81de50c>开发与维护</h2><!----></div><div class="items" data-v-d81de50c><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/reference/response-format.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>响应格式</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d81de50c data-v-d81de50c><div class="item" data-v-d81de50c><div class="indicator" data-v-d81de50c></div><a class="VPLink link link" href="/qq-music-api/guide/architecture.html" data-v-d81de50c><!--[--><p class="text" data-v-d81de50c>代码架构</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-0cf61682 data-v-9dc86fcc><div class="VPDoc has-sidebar has-aside" data-v-9dc86fcc data-v-7011f0d8><!--[--><!--]--><div class="container" data-v-7011f0d8><div class="aside" data-v-7011f0d8><div class="aside-curtain" data-v-7011f0d8></div><div class="aside-container" data-v-7011f0d8><div class="aside-content" data-v-7011f0d8><div class="VPDocAside" data-v-7011f0d8 data-v-3f215769><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-3f215769 data-v-60d5052e><div class="content" data-v-60d5052e><div class="outline-marker" data-v-60d5052e></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-60d5052e>本页目录</div><ul class="VPDocOutlineItem root" data-v-60d5052e data-v-1ce71065><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-3f215769></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-7011f0d8><div class="content-container" data-v-7011f0d8><!--[--><!--]--><main class="main" data-v-7011f0d8><div style="position:relative;" class="vp-doc _qq-music-api_README" data-v-7011f0d8><div><h2 align="center" id="qqmusicapi">QQ Music API</h2><p>!&gt; QQ音乐API koa2 版本, 通过Web网页版请求QQ音乐接口数据, 有问题请提 <a href="https://github.com/Rain120/qq-music-api/issues" target="_blank" rel="noreferrer">issue</a>, 或者你有其他想法欢迎<code>PR</code>.</p><h2 id="api结构图" tabindex="-1">API结构图 <a class="header-anchor" href="#api结构图" aria-label="Permalink to “API结构图”">​</a></h2><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/qq-music.png" alt="qq-music"></p><h2 id="api接口" tabindex="-1">API接口 <a class="header-anchor" href="#api接口" aria-label="Permalink to “API接口”">​</a></h2><p>!&gt; koa2 接口说明(参数, 地址, 效果图)</p><h2 id="新特性" tabindex="-1">新特性 <a class="header-anchor" href="#新特性" aria-label="Permalink to “新特性”">​</a></h2><h3 id="支持自定义设置cookie" tabindex="-1">支持自定义设置cookie <a class="header-anchor" href="#支持自定义设置cookie" aria-label="Permalink to “支持自定义设置cookie”">​</a></h3><p>!&gt; 2020-01-23 新增, 只需要配置 <code>config/user-info.js</code> 中的 <code>cookies</code> 字段就会在发送请求时带上你的 <code>cookies</code>。</p><h4 id="格式化自定义的-cookie" tabindex="-1">格式化自定义的 cookie <a class="header-anchor" href="#格式化自定义的-cookie" aria-label="Permalink to “格式化自定义的 cookie”">​</a></h4><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/normalize-cookie.png" alt="normalize-cookie.png"></p><h3 id="特性提示支持" tabindex="-1">特性提示支持 <a class="header-anchor" href="#特性提示支持" aria-label="Permalink to “特性提示支持”">​</a></h3><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/new-feature-error-tips.png" alt="new-feature-error-tips.png"></p><h3 id="获取-cookie" tabindex="-1">获取 Cookie <a class="header-anchor" href="#获取-cookie" aria-label="Permalink to “获取 Cookie”">​</a></h3><p>!&gt; 目前只支持用户自己从 <em>QQ音乐</em> 获取获取 <code>Cookie</code>, 如何获取 <code>Cookie</code>, 登录 <code>QQ音乐</code>, 然后 <code>F12</code>, 找到 <code>Network</code>, 随便找一个获取数据的接口, 复制接口中 <code>request headers</code> 中的 <code>Cookie</code> 即可。</p><p>接口说明: 调用此接口, 可获取自己在 <code>config/user-info.js</code> 配置的 <code>Cookie</code> 被格式化的结果</p><p>配置信息如下:</p><div class="language-"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>const userInfo = {</span></span>
24
24
  <span class="line"><span> loginUin: &#39;qq号码&#39;,</span></span>
25
25
  <span class="line"><span> cookie: &#39;&#39;,</span></span>
26
- <span class="line"><span>}</span></span></code></pre></div><p>接口地址: <code>/user/getCookie</code></p><p>调用例子: <code>/user/getCookie</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/normalize-cookie.png" alt="normalize-cookie.png"></p><h3 id="获取qq音乐产品的下载地址" tabindex="-1">获取QQ音乐产品的下载地址 <a class="header-anchor" href="#获取qq音乐产品的下载地址" aria-label="Permalink to &quot;获取QQ音乐产品的下载地址&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取QQ音乐标准产品下载链接</p><p>接口地址: <code>/downloadQQMusic</code></p><p>调用例子: <code>/downloadQQMusic</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/downloadQQMusic.png" alt="获取QQ音乐产品的下载地址"></p><h3 id="获取歌单分类" tabindex="-1">获取歌单分类 <a class="header-anchor" href="#获取歌单分类" aria-label="Permalink to &quot;获取歌单分类&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌单分类, 包含<code>category</code>信息</p><p>接口地址: <code>/getSongListCategories</code></p><p>调用例子: <code>/getSongListCategories</code></p><details><summary>SortID</summary><pre><code>sortId: 1, sortName: 默认
26
+ <span class="line"><span>}</span></span></code></pre></div><p>接口地址: <code>/user/getCookie</code></p><p>调用例子: <code>/user/getCookie</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/normalize-cookie.png" alt="normalize-cookie.png"></p><h3 id="获取qq音乐产品的下载地址" tabindex="-1">获取QQ音乐产品的下载地址 <a class="header-anchor" href="#获取qq音乐产品的下载地址" aria-label="Permalink to “获取QQ音乐产品的下载地址”">​</a></h3><p>接口说明: 调用此接口, 可获取QQ音乐标准产品下载链接</p><p>接口地址: <code>/downloadQQMusic</code></p><p>调用例子: <code>/downloadQQMusic</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/downloadQQMusic.png" alt="获取QQ音乐产品的下载地址"></p><h3 id="获取歌单分类" tabindex="-1">获取歌单分类 <a class="header-anchor" href="#获取歌单分类" aria-label="Permalink to “获取歌单分类”">​</a></h3><p>接口说明: 调用此接口, 可获取歌单分类, 包含<code>category</code>信息</p><p>接口地址: <code>/getSongListCategories</code></p><p>调用例子: <code>/getSongListCategories</code></p><details><summary>SortID</summary><pre><code>sortId: 1, sortName: 默认
27
27
  sortId: 2, sortName: 最新
28
28
  sortId: 3, sortName: 最热
29
29
  sortId: 4, sortName: 评分
@@ -217,12 +217,12 @@ sortId: 5, sortName: none
217
217
  6.13
218
218
  &quot;categoryId&quot;: 16,
219
219
  &quot;categoryName&quot;: &quot;校园&quot;,
220
- </code></pre></details><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongListCategories.png" alt="获取歌单分类"></p><h3 id="获取歌单列表" tabindex="-1">获取歌单列表 <a class="header-anchor" href="#获取歌单列表" aria-label="Permalink to &quot;获取歌单列表&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌单列表</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>categoryId</code>: 类别<code>id</code>, 详见 <code>/getSongListCategories</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li><li><p><code>sortId</code>: 最新, 最热,评分, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSongLists</code></p><p>调用例子: <code>/getSongLists?categoryId=10000000</code></p><p>示例截图:</p><p><strong>获取歌单列表</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongLists.png" alt="获取歌单列表"></p><h3 id="批量获取歌单列表" tabindex="-1">批量获取歌单列表 <a class="header-anchor" href="#批量获取歌单列表" aria-label="Permalink to &quot;批量获取歌单列表&quot;">​</a></h3><p>接口说明: 调用此接口, 可批量获取歌单列表</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>categoryIds</code>: 类别<code>id</code>列表, 详见 <code>/getSongListCategories</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li><li><p><code>sortId</code>: 最新, 最热,评分, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/batchGetSongLists</code></p><p>调用例子: <code>/batchGetSongLists</code></p><div class="language-json 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>
220
+ </code></pre></details><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongListCategories.png" alt="获取歌单分类"></p><h3 id="获取歌单列表" tabindex="-1">获取歌单列表 <a class="header-anchor" href="#获取歌单列表" aria-label="Permalink to “获取歌单列表”">​</a></h3><p>接口说明: 调用此接口, 可获取歌单列表</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>categoryId</code>: 类别<code>id</code>, 详见 <code>/getSongListCategories</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li><li><p><code>sortId</code>: 最新, 最热,评分, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSongLists</code></p><p>调用例子: <code>/getSongLists?categoryId=10000000</code></p><p>示例截图:</p><p><strong>获取歌单列表</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongLists.png" alt="获取歌单列表"></p><h3 id="批量获取歌单列表" tabindex="-1">批量获取歌单列表 <a class="header-anchor" href="#批量获取歌单列表" aria-label="Permalink to “批量获取歌单列表”">​</a></h3><p>接口说明: 调用此接口, 可批量获取歌单列表</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>categoryIds</code>: 类别<code>id</code>列表, 详见 <code>/getSongListCategories</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li><li><p><code>sortId</code>: 最新, 最热,评分, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/batchGetSongLists</code></p><p>调用例子: <code>/batchGetSongLists</code></p><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
221
221
  <span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;"> &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">limit</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 19</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
222
222
  <span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;"> &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">page</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 0</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
223
223
  <span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;"> &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">sortId</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 5</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span></span>
224
224
  <span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;"> &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">categoryIds</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> [</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;">167</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">,</span><span style="--shiki-light:#2F798A;--shiki-dark:#4C9A91;"> 168</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">]</span></span>
225
- <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><p>示例截图:</p><p><strong>批量获取歌单列表</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/batchGetSongLists.png" alt="获取歌单列表"></p><p><strong>获取歌单列表-带参数</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongLists-params.png" alt="获取歌单列表-带参数"></p><h3 id="获取歌单详情" tabindex="-1">获取歌单详情 <a class="header-anchor" href="#获取歌单详情" aria-label="Permalink to &quot;获取歌单详情&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌单详情</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>disstid</code>: 歌单<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSongListDetail</code></p><p>调用例子: <code>/getSongListDetail?disstid=7011264340</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongListDetail.png" alt="获取歌单详情"></p><h3 id="获取mv标签" tabindex="-1">获取MV标签 <a class="header-anchor" href="#获取mv标签" aria-label="Permalink to &quot;获取MV标签&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取MV标签</p><p>接口地址: <code>/getMvByTag</code></p><p>调用例子: <code>/getMvByTag</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMvByTag.png" alt="获取MV标签"></p><h3 id="获取mv播放信息" tabindex="-1">获取MV播放信息 <a class="header-anchor" href="#获取mv播放信息" aria-label="Permalink to &quot;获取MV播放信息&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取MV播放信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>vid</code>: <code>video id</code></li></ul></li></ul><p>接口地址: <code>/getMvPlay</code></p><p>调用例子: <code>/getMvPlay?vid=u00222le4ox</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMvPlay.png" alt="获取MV播放信息"></p><h3 id="获取歌手mv" tabindex="-1">获取歌手MV <a class="header-anchor" href="#获取歌手mv" aria-label="Permalink to &quot;获取歌手MV&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌手MV</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>order</code>: 当前MV类型, 默认为<code>time</code></p><ul><li><p><code>listen</code>: 歌手专辑音乐MV</p></li><li><p><code>time</code>: 粉丝上传MV视频</p></li></ul></li><li><p><code>limit</code>: 取出歌单数量, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSingerMV</code></p><p>调用例子: <code>/getSingerMV?singermid=0025NhlN2yWrP4&amp;order=all&amp;limit=5</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-default.png" alt="获取歌手MV - default"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-listen.png" alt="获取歌手MV - belong"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-time.png" alt="获取歌手MV - fans"></p><h3 id="获取歌手热门歌曲" tabindex="-1">获取歌手热门歌曲 <a class="header-anchor" href="#获取歌手热门歌曲" aria-label="Permalink to &quot;获取歌手热门歌曲&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌手热门歌曲</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 页数, 默认为0</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSingerHotsong</code></p><p>调用例子: <code>/getSingerHotsong?singermid=0025NhlN2yWrP4&amp;limit=10&amp;page=2</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerHotsong.png" alt="获取歌手热门歌曲"></p><h3 id="获取相似歌手" tabindex="-1">获取相似歌手 <a class="header-anchor" href="#获取相似歌手" aria-label="Permalink to &quot;获取相似歌手&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取相似歌手</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSimilarSinger</code></p><p>调用例子: <code>/getSimilarSinger?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSimilarSinger.png" alt="获取相似歌手"></p><h3 id="获取歌手信息" tabindex="-1">获取歌手信息 <a class="header-anchor" href="#获取歌手信息" aria-label="Permalink to &quot;获取歌手信息&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌手信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSingerDesc</code></p><p>调用例子: <code>/getSingerDesc?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerDesc.png" alt="获取歌手信息"></p><h3 id="获取歌手列表" tabindex="-1">获取歌手列表 <a class="header-anchor" href="#获取歌手列表" aria-label="Permalink to &quot;获取歌手列表&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌手列表</p><p>参数列表:</p><ul><li><p>可选参数</p><details><summary>area 默认是 -100</summary><pre><code> &quot;id&quot;: -100,
225
+ <span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">}</span></span></code></pre></div><p>示例截图:</p><p><strong>批量获取歌单列表</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/batchGetSongLists.png" alt="获取歌单列表"></p><p><strong>获取歌单列表-带参数</strong></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongLists-params.png" alt="获取歌单列表-带参数"></p><h3 id="获取歌单详情" tabindex="-1">获取歌单详情 <a class="header-anchor" href="#获取歌单详情" aria-label="Permalink to “获取歌单详情”">​</a></h3><p>接口说明: 调用此接口, 可获取歌单详情</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>disstid</code>: 歌单<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSongListDetail</code></p><p>调用例子: <code>/getSongListDetail?disstid=7011264340</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongListDetail.png" alt="获取歌单详情"></p><h3 id="获取mv标签" tabindex="-1">获取MV标签 <a class="header-anchor" href="#获取mv标签" aria-label="Permalink to “获取MV标签”">​</a></h3><p>接口说明: 调用此接口, 可获取MV标签</p><p>接口地址: <code>/getMvByTag</code></p><p>调用例子: <code>/getMvByTag</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMvByTag.png" alt="获取MV标签"></p><h3 id="获取mv播放信息" tabindex="-1">获取MV播放信息 <a class="header-anchor" href="#获取mv播放信息" aria-label="Permalink to “获取MV播放信息”">​</a></h3><p>接口说明: 调用此接口, 可获取MV播放信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>vid</code>: <code>video id</code></li></ul></li></ul><p>接口地址: <code>/getMvPlay</code></p><p>调用例子: <code>/getMvPlay?vid=u00222le4ox</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMvPlay.png" alt="获取MV播放信息"></p><h3 id="获取歌手mv" tabindex="-1">获取歌手MV <a class="header-anchor" href="#获取歌手mv" aria-label="Permalink to “获取歌手MV">​</a></h3><p>接口说明: 调用此接口, 可获取歌手MV</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>order</code>: 当前MV类型, 默认为<code>time</code></p><ul><li><p><code>listen</code>: 歌手专辑音乐MV</p></li><li><p><code>time</code>: 粉丝上传MV视频</p></li></ul></li><li><p><code>limit</code>: 取出歌单数量, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSingerMV</code></p><p>调用例子: <code>/getSingerMV?singermid=0025NhlN2yWrP4&amp;order=all&amp;limit=5</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-default.png" alt="获取歌手MV - default"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-listen.png" alt="获取歌手MV - belong"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerMv-time.png" alt="获取歌手MV - fans"></p><h3 id="获取歌手热门歌曲" tabindex="-1">获取歌手热门歌曲 <a class="header-anchor" href="#获取歌手热门歌曲" aria-label="Permalink to “获取歌手热门歌曲”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手热门歌曲</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 页数, 默认为0</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为5</p></li></ul></li></ul><p>接口地址: <code>/getSingerHotsong</code></p><p>调用例子: <code>/getSingerHotsong?singermid=0025NhlN2yWrP4&amp;limit=10&amp;page=2</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerHotsong.png" alt="获取歌手热门歌曲"></p><h3 id="获取相似歌手" tabindex="-1">获取相似歌手 <a class="header-anchor" href="#获取相似歌手" aria-label="Permalink to “获取相似歌手”">​</a></h3><p>接口说明: 调用此接口, 可获取相似歌手</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSimilarSinger</code></p><p>调用例子: <code>/getSimilarSinger?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSimilarSinger.png" alt="获取相似歌手"></p><h3 id="获取歌手信息" tabindex="-1">获取歌手信息 <a class="header-anchor" href="#获取歌手信息" aria-label="Permalink to “获取歌手信息”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSingerDesc</code></p><p>调用例子: <code>/getSingerDesc?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerDesc.png" alt="获取歌手信息"></p><h3 id="获取歌手列表" tabindex="-1">获取歌手列表 <a class="header-anchor" href="#获取歌手列表" aria-label="Permalink to “获取歌手列表”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手列表</p><p>参数列表:</p><ul><li><p>可选参数</p><details><summary>area 默认是 -100</summary><pre><code> &quot;id&quot;: -100,
226
226
  &quot;name&quot;: &quot;全部&quot;
227
227
  &quot;id&quot;: 200,
228
228
  &quot;name&quot;: &quot;内地&quot;
@@ -373,7 +373,7 @@ sortId: 5, sortName: none
373
373
 
374
374
  &quot;id&quot;: 2,
375
375
  &quot;name&quot;: &quot;组合&quot;
376
- </code></pre></details></li></ul><p>接口地址: <code>/getSingerList</code></p><p>调用例子: <code>/getSingerList</code> 调用例子: <code>/getSingerList?area=200&amp;sex=2&amp;index=3&amp;genre=2</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerList.png" alt="获取歌手列表"></p><h3 id="获取歌手被关注数量信息" tabindex="-1">获取歌手被关注数量信息 <a class="header-anchor" href="#获取歌手被关注数量信息" aria-label="Permalink to &quot;获取歌手被关注数量信息&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌手被关注数量信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSingerStarNum</code></p><p>调用例子: <code>/getSingerStarNum?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerStarNum.png" alt="获取歌手被关注数量信息"></p><h3 id="获取电台列表" tabindex="-1">获取电台列表 <a class="header-anchor" href="#获取电台列表" aria-label="Permalink to &quot;获取电台列表&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取电台列表, 分类</p><p>接口地址: <code>/getRadioLists</code></p><p>调用例子: <code>/getRadioLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRadioLists.png" alt="获取电台列表"></p><h3 id="获取专辑" tabindex="-1">获取专辑 <a class="header-anchor" href="#获取专辑" aria-label="Permalink to &quot;获取专辑&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取专辑信息(专辑列表、详情)</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>albummid</code>: 专辑<code>id</code></li></ul></li></ul><p>接口地址: <code>/getAlbumInfo</code></p><p>调用例子: <code>/getAlbumInfo?albummid=0016l2F430zMux</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getAlbumInfo.png" alt="获取专辑"></p><h3 id="获取数字专辑" tabindex="-1">获取数字专辑 <a class="header-anchor" href="#获取数字专辑" aria-label="Permalink to &quot;获取数字专辑&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取数字专辑, 轮播图<code>banner</code>, 专辑列表等信息, 详见<a href="#API结构图">API结构图</a></p><p>接口地址: <code>/getDigitalAlbumLists</code></p><p>调用例子: <code>/getDigitalAlbumLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getDigitalAlbumLists.png" alt="获取数字专辑"></p><h3 id="获取歌曲歌词" tabindex="-1">获取歌曲歌词 <a class="header-anchor" href="#获取歌曲歌词" aria-label="Permalink to &quot;获取歌曲歌词&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲歌词</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>songmid</code>: 专辑<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><code>isFormat</code>: 是否格式化歌词, 默认值为 <code>false</code></li></ul></li></ul><p>接口地址: <code>/getLyric</code></p><p>调用例子: <code>/getLyric?songmid=003rJSwm3TechU</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getLyric.png" alt="获取歌曲歌词 - 未格式化"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getLyric-parse.png" alt="获取歌曲歌词 - 格式化"></p><h3 id="获取mv" tabindex="-1">获取MV <a class="header-anchor" href="#获取mv" aria-label="Permalink to &quot;获取MV&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取MV以及其Tag信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>area_id</code>: 区域<code>id</code>, 默认值为全部(15)</li></ul></li></ul><details><summary>Area</summary><pre><code>&quot;area&quot;: [
376
+ </code></pre></details></li></ul><p>接口地址: <code>/getSingerList</code></p><p>调用例子: <code>/getSingerList</code> 调用例子: <code>/getSingerList?area=200&amp;sex=2&amp;index=3&amp;genre=2</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerList.png" alt="获取歌手列表"></p><h3 id="获取歌手被关注数量信息" tabindex="-1">获取歌手被关注数量信息 <a class="header-anchor" href="#获取歌手被关注数量信息" aria-label="Permalink to “获取歌手被关注数量信息”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手被关注数量信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSingerStarNum</code></p><p>调用例子: <code>/getSingerStarNum?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerStarNum.png" alt="获取歌手被关注数量信息"></p><h3 id="获取电台列表" tabindex="-1">获取电台列表 <a class="header-anchor" href="#获取电台列表" aria-label="Permalink to “获取电台列表”">​</a></h3><p>接口说明: 调用此接口, 可获取电台列表, 分类</p><p>接口地址: <code>/getRadioLists</code></p><p>调用例子: <code>/getRadioLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRadioLists.png" alt="获取电台列表"></p><h3 id="获取专辑" tabindex="-1">获取专辑 <a class="header-anchor" href="#获取专辑" aria-label="Permalink to “获取专辑”">​</a></h3><p>接口说明: 调用此接口, 可获取专辑信息(专辑列表、详情)</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>albummid</code>: 专辑<code>id</code></li></ul></li></ul><p>接口地址: <code>/getAlbumInfo</code></p><p>调用例子: <code>/getAlbumInfo?albummid=0016l2F430zMux</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getAlbumInfo.png" alt="获取专辑"></p><h3 id="获取数字专辑" tabindex="-1">获取数字专辑 <a class="header-anchor" href="#获取数字专辑" aria-label="Permalink to “获取数字专辑”">​</a></h3><p>接口说明: 调用此接口, 可获取数字专辑, 轮播图<code>banner</code>, 专辑列表等信息, 详见<a href="#api结构图">API结构图</a></p><p>接口地址: <code>/getDigitalAlbumLists</code></p><p>调用例子: <code>/getDigitalAlbumLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getDigitalAlbumLists.png" alt="获取数字专辑"></p><h3 id="获取歌曲歌词" tabindex="-1">获取歌曲歌词 <a class="header-anchor" href="#获取歌曲歌词" aria-label="Permalink to “获取歌曲歌词”">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲歌词</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>songmid</code>: 专辑<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><code>isFormat</code>: 是否格式化歌词, 默认值为 <code>false</code></li></ul></li></ul><p>接口地址: <code>/getLyric</code></p><p>调用例子: <code>/getLyric?songmid=003rJSwm3TechU</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getLyric.png" alt="获取歌曲歌词 - 未格式化"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getLyric-parse.png" alt="获取歌曲歌词 - 格式化"></p><h3 id="获取mv" tabindex="-1">获取MV <a class="header-anchor" href="#获取mv" aria-label="Permalink to “获取MV">​</a></h3><p>接口说明: 调用此接口, 可获取MV以及其Tag信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>area_id</code>: 区域<code>id</code>, 默认值为全部(15)</li></ul></li></ul><details><summary>Area</summary><pre><code>&quot;area&quot;: [
377
377
  {
378
378
  &quot;id&quot;: 15,
379
379
  &quot;name&quot;: &quot;全部&quot;
@@ -433,15 +433,15 @@ sortId: 5, sortName: none
433
433
  &quot;name&quot;: &quot;儿歌&quot;
434
434
  }
435
435
  ]
436
- </code></pre></details><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getMv</code></p><p>调用例子: <code>/getMv</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMv.png" alt="获取MV"></p><h3 id="获取新碟信息" tabindex="-1">获取新碟信息 <a class="header-anchor" href="#获取新碟信息" aria-label="Permalink to &quot;获取新碟信息&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取新碟信息</p><p>参数列表:</p><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getNewDisks</code></p><p>调用例子: <code>/getNewDisks</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getNewDisks.png" alt="获取新碟信息"></p><h3 id="获取歌手专辑" tabindex="-1">获取歌手专辑 <a class="header-anchor" href="#获取歌手专辑" aria-label="Permalink to &quot;获取歌手专辑&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌手专辑</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getSingerAlbum</code></p><p>调用例子: <code>/getSingerAlbum?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerAlbum.png" alt="获取歌手专辑"></p><h3 id="获取歌曲相关信息" tabindex="-1">获取歌曲相关信息 <a class="header-anchor" href="#获取歌曲相关信息" aria-label="Permalink to &quot;获取歌曲相关信息&quot;">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲相关信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>songmid</code>: 歌曲<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSongInfo</code></p><p>调用例子: <code>/getSongInfo?songmid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongInfo.png" alt="获取歌曲相关信息"></p><h3 id="批量获取歌曲相关信息" tabindex="-1">批量获取歌曲相关信息 <a class="header-anchor" href="#批量获取歌曲相关信息" aria-label="Permalink to &quot;批量获取歌曲相关信息&quot;">​</a></h3><p>接口说明: 调用此接口, 可批量获取歌曲相关信息</p><p>参数列表:</p><ul><li>必选参数</li></ul><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark vp-code" tabindex="0"><code><span class="line"><span>songs: [</span></span>
436
+ </code></pre></details><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getMv</code></p><p>调用例子: <code>/getMv</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getMv.png" alt="获取MV"></p><h3 id="获取新碟信息" tabindex="-1">获取新碟信息 <a class="header-anchor" href="#获取新碟信息" aria-label="Permalink to “获取新碟信息”">​</a></h3><p>接口说明: 调用此接口, 可获取新碟信息</p><p>参数列表:</p><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getNewDisks</code></p><p>调用例子: <code>/getNewDisks</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getNewDisks.png" alt="获取新碟信息"></p><h3 id="获取歌手专辑" tabindex="-1">获取歌手专辑 <a class="header-anchor" href="#获取歌手专辑" aria-label="Permalink to “获取歌手专辑”">​</a></h3><p>接口说明: 调用此接口, 可获取歌手专辑</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>singermid</code>: 歌手<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 20</p></li></ul></li></ul><p>接口地址: <code>/getSingerAlbum</code></p><p>调用例子: <code>/getSingerAlbum?singermid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSingerAlbum.png" alt="获取歌手专辑"></p><h3 id="获取歌曲相关信息" tabindex="-1">获取歌曲相关信息 <a class="header-anchor" href="#获取歌曲相关信息" aria-label="Permalink to “获取歌曲相关信息”">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲相关信息</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>songmid</code>: 歌曲<code>id</code></li></ul></li></ul><p>接口地址: <code>/getSongInfo</code></p><p>调用例子: <code>/getSongInfo?songmid=0025NhlN2yWrP4</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSongInfo.png" alt="获取歌曲相关信息"></p><h3 id="批量获取歌曲相关信息" tabindex="-1">批量获取歌曲相关信息 <a class="header-anchor" href="#批量获取歌曲相关信息" aria-label="Permalink to “批量获取歌曲相关信息”">​</a></h3><p>接口说明: 调用此接口, 可批量获取歌曲相关信息</p><p>参数列表:</p><ul><li>必选参数</li></ul><div class="language-"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span>songs: [</span></span>
437
437
  <span class="line"><span> [songmid, songid]</span></span>
438
- <span class="line"><span>]</span></span></code></pre></div><p>其中 <code>songid</code>可以不传</p><p>接口地址: <code>/batchGetSongInfo</code></p><p>调用例子: <code>/batchGetSongInfo</code></p><div class="language-json 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>
438
+ <span class="line"><span>]</span></span></code></pre></div><p>其中 <code>songid</code>可以不传</p><p>接口地址: <code>/batchGetSongInfo</code></p><p>调用例子: <code>/batchGetSongInfo</code></p><div class="language-json"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes vitesse-light vitesse-dark" style="--shiki-light:#393a34;--shiki-dark:#dbd7caee;--shiki-light-bg:#ffffff;--shiki-dark-bg:#121212;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#999999;--shiki-dark:#666666;">{</span></span>
439
439
  <span class="line"><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;"> &quot;</span><span style="--shiki-light:#998418;--shiki-dark:#B8A965;">songs</span><span style="--shiki-light:#99841877;--shiki-dark:#B8A96577;">&quot;</span><span style="--shiki-light:#999999;--shiki-dark:#666666;">:</span><span style="--shiki-light:#999999;--shiki-dark:#666666;"> [</span></span>
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-14T19:54:29.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\":\"CATvWhrg\",\"api_index.md\":\"Dqx3qXyO\",\"api_music.md\":\"D20_neZB\",\"api_other.md\":\"CXyEsl8R\",\"api_playlist.md\":\"CyLdLRR9\",\"api_rank.md\":\"Z3xyYG_S\",\"api_search.md\":\"D_lbFmYo\",\"api_singer.md\":\"BbyYE88D\",\"api_user.md\":\"4WdmTXIB\",\"changelog-architecture.md\":\"DV9Xr7ve\",\"cookie_config_guide.md\":\"B2-aTdcH\",\"fallback_mode_guide.md\":\"0wqXqYxw\",\"guide_architecture.md\":\"D_46khUI\",\"guide_authentication.md\":\"nCiAu07w\",\"guide_index.md\":\"gLozHqz5\",\"guide_installation.md\":\"BUDl8zk1\",\"guide_quickstart.md\":\"COQUzUN9\",\"index.md\":\"DBZfQ2kF\",\"readme.md\":\"DFCMeLFa\",\"reference_response-format.md\":\"yrdeqFUN\",\"test_user_playlists.md\":\"Bj0AVpHw\",\"user_avatar_guide.md\":\"CGPI9GUj\"}");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 “获取歌曲播放链接”">​</a></h3><p>接口说明: 调用此接口, 可获取歌曲播放链接</p><p>参数列表:</p><ul><li><p>必选参数</p></li><li><p><code>songmid</code>: 歌曲<code>id</code>, 多个播放链接使用 <code>,</code>分隔</p></li><li><p><code>justPlayUrl</code>: 仅返回播放链接, 默认是 <code>play</code>。<code>[all | play]</code></p></li><li><p><code>quality</code>: 播放品质, 默认是 128。<code>[m4a | 128 | 320 | ape | flac]</code></p></li></ul><p>接口地址: <code>/getMusicPlay</code></p><p>调用例子:</p><p>示例截图:</p><h4 id="获取单个播放链接" tabindex="-1">获取单个播放链接 <a class="header-anchor" href="#获取单个播放链接" aria-label="Permalink to “获取单个播放链接”">​</a></h4><p>例子: <code>/getMusicPlay?songmid=0012g3Et1iFQCC</code></p><p><img src="https://raw.githubusercontent.com/RTAkland/qq-music-api/refs/heads/main/screenshot/musicPlay.png" alt="获取单个播放链接"></p><h4 id="获取多个播放链接" tabindex="-1">获取多个播放链接 <a class="header-anchor" href="#获取多个播放链接" aria-label="Permalink to “获取多个播放链接”">​</a></h4><p>例子: <code>/getMusicPlay?songmid=001yNIo41SJjuC,001wPuVc4ZiMhj&amp;resType=play</code></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/just-get-play-url.png" alt="获取多个歌曲播放链接"></p><h4 id="获取多个播放链接-1" tabindex="-1">获取多个播放链接 <a class="header-anchor" href="#获取多个播放链接-1" aria-label="Permalink to “获取多个播放链接”">​</a></h4><p>例子: <code>/getMusicPlay?songmid=0012g3Et1iFQCC,001wPuVc4ZiMhj&amp;resType=all</code></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-play-all-data.png" alt="获取接口所有数据"></p><h4 id="歌曲品质" tabindex="-1">歌曲品质 <a class="header-anchor" href="#歌曲品质" aria-label="Permalink to “歌曲品质”">​</a></h4><p>例子: <code>songmid=001yNIo41SJjuC&amp;resType=play&amp;quality=m4a</code></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/song-quality-128.png" alt="song-quality-128.png"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/song-quality-m4a.png" alt="song-quality-m4a.png"></p><h3 id="获取搜索热词" tabindex="-1">获取搜索热词 <a class="header-anchor" href="#获取搜索热词" aria-label="Permalink to “获取搜索热词”">​</a></h3><p>接口说明: 调用此接口, 可获取搜索热词</p><p>接口地址: <code>/getHotkey</code></p><p>调用例子: <code>/getHotkey</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/gethotkey.png" alt="获取搜索热词"></p><h3 id="获取关键字搜索提示" tabindex="-1">获取关键字搜索提示 <a class="header-anchor" href="#获取关键字搜索提示" aria-label="Permalink to “获取关键字搜索提示”">​</a></h3><p>接口说明: 调用此接口, 可获取获取关键字搜索提示</p><p>参数列表:</p><ul><li><p>必选参数</p><ul><li><code>key</code>: 搜索关键字</li></ul></li></ul><p>接口地址: <code>/getSmartbox</code></p><p>调用例子: <code>/getSmartbox?key=周杰伦</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSmartbox.png" alt="获取获取关键字搜索提示"></p><h3 id="获取搜索结果" tabindex="-1">获取搜索结果 <a class="header-anchor" href="#获取搜索结果" aria-label="Permalink to “获取搜索结果”">​</a></h3><p>接口说明: 调用此接口, 可获取获取搜索结果</p><p>参数列表(部分参数待注释):</p><ul><li><p>必选参数</p><ul><li><p><code>key</code>: 搜索关键字</p></li><li><p><s><code>catZhida</code>: 默认值为1</s></p><p><s>1. <code>0</code> 表示歌曲</s></p><p><s>2. <code>2</code> 表示歌手</s></p><p><s>3. <code>3</code> 表示专辑</s></p></li><li><p><code>remoteplace</code>: 默认值为 <code>song</code></p><ol><li><p>单曲: <code>song</code></p></li><li><p>专辑: <code>album</code></p></li><li><p>MV: <code>mv</code></p></li><li><p>歌单: <code>playlist</code></p></li><li><p>用户: <code>user</code></p></li><li><p>歌词: <code>lyric</code></p></li></ol></li></ul></li><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 <code>1</code></p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 <code>10</code></p></li></ul></li></ul><p>接口地址: <code>/getSearchByKey</code></p><p>调用例子: <code>/getSearchByKey?key=周杰伦</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getSearchByKey.png" alt="获取获取搜索结果"></p><h3 id="获取首页推荐" tabindex="-1">获取首页推荐 <a class="header-anchor" href="#获取首页推荐" aria-label="Permalink to “获取首页推荐”">​</a></h3><p>接口说明: 调用此接口, 可获取首页推荐</p><p>接口地址: <code>/getRecommend</code></p><p>调用例子: <code>/getRecommend</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRecommend.png" alt="获取首页推荐"></p><h3 id="获取排行榜单列表" tabindex="-1">获取排行榜单列表 <a class="header-anchor" href="#获取排行榜单列表" aria-label="Permalink to “获取排行榜单列表”">​</a></h3><p>接口说明: 调用此接口, 可获取排行榜单列表</p><ul><li><p>可选参数</p><ul><li><p><code>page</code>: 当前页数, 默认为 <code>1</code></p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 <code>10</code></p></li></ul></li></ul><p>接口地址: <code>/getTopLists</code></p><p>调用例子: <code>/getTopLists</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getTopLists.png" alt="获取排行榜单列表"></p><h3 id="获取排行榜单详情" tabindex="-1">获取排行榜单详情 <a class="header-anchor" href="#获取排行榜单详情" aria-label="Permalink to “获取排行榜单详情”">​</a></h3><p>接口说明: 调用此接口, 可获取排行榜单详情</p><ul><li><p>可选参数</p><ul><li><p><code>topId</code>: 榜单<code>id</code></p></li><li><p><code>page</code>: 当前页数, 默认为1</p></li><li><p><code>limit</code>: 取出歌单数量, 默认为 10</p></li></ul></li></ul><p>接口地址: <code>/getRanks</code></p><p>调用例子: <code>/getRanks</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getRanks.png" alt="获取排行榜单详情"></p><h3 id="获取评论信息-cmd代表的意思没太弄明白" tabindex="-1">获取评论信息(cmd代表的意思没太弄明白) <a class="header-anchor" href="#获取评论信息-cmd代表的意思没太弄明白" aria-label="Permalink to “获取评论信息(cmd代表的意思没太弄明白)”">​</a></h3><p>接口说明: 调用此接口, 可获取评论信息</p><ul><li><p>必选参数</p><ul><li><code>id</code>: 专辑或者歌单请求结果的<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>rootcommentid</code>: 榜单<code>id</code></p></li><li><p><code>cid</code>:</p></li><li><p><code>pagenum</code>: 当前页数, 默认为 <code>0</code></p></li><li><p><code>pagesize</code>: 取出评论数量, 默认为 <code>25</code></p></li><li><p><code>cmd</code>:</p></li><li><p><code>reqtype</code>:</p></li><li><p><code>biztype</code>:</p></li></ul></li></ul><p>接口地址: <code>/getComments</code></p><p>调用例子: <code>/getComments?id=8220&amp;rootcommentid=album_8220_1003310416_1558068713</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getComments-id.png" alt="获取评论信息 - id获取"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getComments.png" alt="获取评论信息"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getComments-param.png" alt="获取评论信息 - 带params"></p><h3 id="获取歌曲-专辑-图片" tabindex="-1">获取歌曲 + 专辑 图片 <a class="header-anchor" href="#获取歌曲-专辑-图片" aria-label="Permalink to “获取歌曲 + 专辑 图片”">​</a></h3><p>接口说明: 调用此接口, 可获取票务信息</p><ul><li><p>必选参数</p><ul><li><code>id</code>: 专辑或者歌单请求结果的<code>id</code></li></ul></li><li><p>可选参数</p><ul><li><p><code>size</code>: 图片大小, 默认 <code>300x300</code></p></li><li><p><code>maxAge</code>: 图片过期时间, 默认 <code>12 mins = 2592000ms</code></p></li></ul></li></ul><p>接口地址: <code>/getImageUrl</code></p><p>调用例子: <code>/getImageUrl?id=000MkMni19ClKG</code> or <code>/getImageUrl?id=000MkMni19ClKG&amp;size=500x500</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-song-id.png" alt="获取歌曲id"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-song-image.png" alt="获取歌曲图片地址"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/song-image.png" alt="歌曲图片地址"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-song-album-id.png" alt="获取专辑id"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/get-album-image.png" alt="获取歌曲专辑地址"></p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/album-image.png" alt="歌曲专辑地址"></p><h3 id="获取票务信息" tabindex="-1">获取票务信息 <a class="header-anchor" href="#获取票务信息" aria-label="Permalink to “获取票务信息”">​</a></h3><p>接口说明: 调用此接口, 可获取票务信息</p><p>接口地址: <code>/getTicketInfo</code></p><p>调用例子: <code>/getTicketInfo</code></p><p>示例截图:</p><p><img src="https://raw.githubusercontent.com/Rain120/qq-music-api/master/screenshot/getTicketInfo.png" alt="获取票务信息"></p></div></div></main><footer class="VPDocFooter" data-v-7011f0d8 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-3c637f39>最后更新于: <time datetime="2026-05-17T15:29:28.000Z" data-v-3c637f39></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>下一页</span><span class="title" data-v-e257564d>首页</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-0cf61682 data-v-c3855bb3><div class="container" data-v-c3855bb3><p class="message" data-v-c3855bb3>基于 MIT 许可发布</p><p class="copyright" data-v-c3855bb3>Copyright © 2020-present Sansenjian</p></div></footer><!--[--><!--]--></div></div>
444
+ <script>window.__VP_HASH_MAP__=JSON.parse("{\"api_comments.md\":\"5nDhrWa8\",\"api_index.md\":\"DdG1WHkZ\",\"api_music.md\":\"D66hq-_4\",\"api_other.md\":\"9KhspVEM\",\"api_playground.md\":\"BZBvYMm2\",\"api_playlist.md\":\"BQK32ZyE\",\"api_rank.md\":\"z7YBwVgw\",\"api_search.md\":\"GfzIBRfc\",\"api_singer.md\":\"BDR-_qDH\",\"api_user.md\":\"Dx8BWGrb\",\"changelog-architecture.md\":\"CYHmaBdY\",\"cookie_config_guide.md\":\"Nvywo7CW\",\"degrade_examples.md\":\"Cz2J-qwE\",\"fallback_mode_guide.md\":\"wKA9yqoI\",\"guide_architecture.md\":\"SHnKkzwb\",\"guide_authentication.md\":\"CZCKocgR\",\"guide_index.md\":\"CkJ-jjL0\",\"guide_installation.md\":\"D2TBzILh\",\"guide_quickstart.md\":\"J7Sib8wg\",\"index.md\":\"ClwYf6Qc\",\"quick_start.md\":\"D5KfDgbs\",\"readme.md\":\"CHbArqA7\",\"reference_response-format.md\":\"BrGoGoPV\",\"test_user_playlists.md\":\"BfBxYbaM\",\"user_avatar_guide.md\":\"D5Rti1Gg\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"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\":\"API 调试台\",\"link\":\"/api/playground\"},{\"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\":\"快速使用指南\",\"link\":\"/QUICK_START\"},{\"text\":\"降级服务示例\",\"link\":\"/DEGRADE_EXAMPLES\"}]},{\"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\":\"API 调试台\",\"link\":\"/api/playground\"}]},{\"text\":\"开发与维护\",\"items\":[{\"text\":\"响应格式\",\"link\":\"/reference/response-format\"},{\"text\":\"代码架构\",\"link\":\"/guide/architecture\"}]}],\"aside\":true,\"outline\":{\"level\":[2,3],\"label\":\"本页目录\"},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/sansenjian/qq-music-api\"}],\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"Copyright © 2020-present Sansenjian\"},\"docFooter\":{\"prev\":\"上一页\",\"next\":\"下一页\"},\"lastUpdated\":{\"text\":\"最后更新于\",\"formatOptions\":{\"dateStyle\":\"short\",\"timeStyle\":\"short\",\"forceLocale\":true}},\"editLink\":{\"pattern\":\"https://github.com/sansenjian/qq-music-api/edit/main/docs/:path\",\"text\":\"在 GitHub 上编辑此页面\"},\"darkModeSwitchLabel\":\"主题\",\"lightModeSwitchTitle\":\"切换到浅色模式\",\"darkModeSwitchTitle\":\"切换到深色模式\",\"sidebarMenuLabel\":\"菜单\",\"returnToTopLabel\":\"返回顶部\",\"skipToContentLabel\":\"跳转到内容\",\"notFound\":{\"title\":\"页面未找到\",\"quote\":\"你访问的文档页不存在,可能已被移动或删除。\",\"link\":\"/\",\"linkLabel\":\"返回首页\",\"linkText\":\"返回首页\"},\"search\":{\"provider\":\"local\",\"options\":{\"detailedView\":\"auto\",\"translations\":{\"button\":{\"buttonText\":\"搜索\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"displayDetails\":\"显示详细列表\",\"backButtonTitle\":\"返回\",\"noResultsText\":\"无法找到相关结果\",\"resetButtonTitle\":\"清除查询条件\",\"footer\":{\"selectText\":\"选择\",\"selectKeyAriaLabel\":\"回车键\",\"navigateText\":\"切换\",\"navigateUpKeyAriaLabel\":\"上箭头\",\"navigateDownKeyAriaLabel\":\"下箭头\",\"closeText\":\"关闭\",\"closeKeyAriaLabel\":\"Esc 键\"}}}}}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false,\"additionalConfig\":{}}");</script>
445
445
 
446
446
  </body>
447
447
  </html>