From 37b64ab01e0ddb52d234f40f8cd394a96ca00569 Mon Sep 17 00:00:00 2001 From: MT-SUPER-POWER Date: Sat, 3 Oct 2026 18:42:36 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E4=BA=86'=E4=B9=90?= =?UTF-8?q?=E8=BF=B7=E5=9B=A2'=E7=9A=84=E7=9B=B8=E5=85=B3=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- interface.d.ts | 25 ++++++++++++++ module/fans_group_detail.js | 15 +++++++++ module/fans_group_feed_recommend.js | 17 ++++++++++ module/fans_group_user_group_detail.js | 14 ++++++++ module/fans_group_user_groups.js | 11 ++++++ public/docs/home.md | 46 +++++++++++++++++++++++++- 6 files changed, 127 insertions(+), 1 deletion(-) create mode 100644 module/fans_group_detail.js create mode 100644 module/fans_group_feed_recommend.js create mode 100644 module/fans_group_user_group_detail.js create mode 100644 module/fans_group_user_groups.js diff --git a/interface.d.ts b/interface.d.ts index f81b8e5..28c8226 100644 --- a/interface.d.ts +++ b/interface.d.ts @@ -2890,3 +2890,28 @@ export function voicelist_trans( } & MultiPageConfig & RequestBaseConfig, ): Promise + +export function fans_group_detail( + params: { + groupId: string + scene?: string + } & RequestBaseConfig, +): Promise + +export function fans_group_feed_recommend( + params: { + fansGroupId: string + cursor?: string + size?: string | number + } & RequestBaseConfig, +): Promise + +export function fans_group_user_groups( + params?: RequestBaseConfig, +): Promise + +export function fans_group_user_group_detail( + params: { + groupId: string | number + } & RequestBaseConfig, +): Promise diff --git a/module/fans_group_detail.js b/module/fans_group_detail.js new file mode 100644 index 0000000..d7134ee --- /dev/null +++ b/module/fans_group_detail.js @@ -0,0 +1,15 @@ +// 乐迷团详情 + +const createOption = require('../util/option.js') + +module.exports = (query, request) => { + const data = { + groupId: query.groupId || query.id || '', + scene: query.scene || '', + } + return request( + '/api/social/fansgroup/bff/detail/get', + data, + createOption(query, 'eapi'), + ) +} diff --git a/module/fans_group_feed_recommend.js b/module/fans_group_feed_recommend.js new file mode 100644 index 0000000..be8cd2f --- /dev/null +++ b/module/fans_group_feed_recommend.js @@ -0,0 +1,17 @@ +// 乐迷团推荐笔记 + +const createOption = require('../util/option.js') + +module.exports = (query, request) => { + const data = { + artistSelf: query.artistSelf || '0', + fansGroupId: query.fansGroupId || query.groupId || '', + cursor: query.cursor || '0', + size: String(query.size || 10), + } + return request( + '/api/fans/group/feed/recommend/get', + data, + createOption(query, 'eapi'), + ) +} diff --git a/module/fans_group_user_group_detail.js b/module/fans_group_user_group_detail.js new file mode 100644 index 0000000..8d046b7 --- /dev/null +++ b/module/fans_group_user_group_detail.js @@ -0,0 +1,14 @@ +// 用户所处乐迷团详情 + +const createOption = require('../util/option.js') + +module.exports = (query, request) => { + const data = { + groupId: query.groupId || query.id || '', + } + return request( + '/api/social/fansgroup/bff/user/group/detail/get', + data, + createOption(query, 'eapi'), + ) +} diff --git a/module/fans_group_user_groups.js b/module/fans_group_user_groups.js new file mode 100644 index 0000000..c9db381 --- /dev/null +++ b/module/fans_group_user_groups.js @@ -0,0 +1,11 @@ +// 获取当前登录用户加入的全部歌手乐迷团列表 + +const createOption = require('../util/option.js') + +module.exports = (query, request) => { + return request( + '/api/social/fansgroup/bff/user/groups/get', + {}, + createOption(query, 'eapi'), + ) +} diff --git a/public/docs/home.md b/public/docs/home.md index 166a836..e1346f7 100644 --- a/public/docs/home.md +++ b/public/docs/home.md @@ -1307,7 +1307,7 @@ tags: 歌单标签 `lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清臻音`, `dolby` => `杜比全景声`, `vivid` => `臻音全景声`, `jymaster` => `超清母带`, `sky` => `沉浸环绕声` `unblock`: 是否使用使用歌曲解锁, 分为`true`和`false` -**可选参数 :** `immerseType`: 沉浸声环绕声类型, 分为`c512` => `新版c51类型`, `ste2` => `新版环绕立体声类型`, `aac2` => `新版aac类型`, `c51` => `c51类型`, `ste` => `环绕立体声类型`, `aac` => `aac类型`, 仅在 `level=sky` 时生效, 默认为 `c51` +**可选参数 :** `immerseType`: 沉浸声环绕声类型, 分为`c512` => `新版c51类型`, `ste2` => `新版环绕立体声类型`, `aac2` => `新版aac类型`, `c51` => `c51类型`, `ste` => `环绕立体声类型`, `aac` => `aac类型`, 仅在 `level=sky` 时生效, 默认为 `c51` **接口地址 :** `/song/url/v1` @@ -5878,6 +5878,50 @@ let data = encodeURIComponent( **调用例子 :** `/song/simi/get?id=39227633` +### 获取用户乐迷团列表 + +说明 : 登录后调用此接口 , 可获取当前登录用户已加入的全部歌手乐迷团列表 + +**接口地址 :** `/fans/group/user/groups` + +**调用例子 :** `/fans/group/user/groups` + +### 获取乐迷团详情 + +说明 : 调用此接口 , 可获取乐迷团详情 + +**必选参数 :** `groupId` : 乐迷团 ID + +**可选参数 :** `scene` : 场景标识 + +**接口地址 :** `/fans/group/detail` + +**调用例子 :** `/fans/group/detail?groupId=1872529203038486609` + +### 获取用户在乐迷团的详情 + +说明 : 登录后调用此接口 , 可获取当前用户在指定乐迷团的详细成员信息及铭牌等级 + +**必选参数 :** `groupId` : 乐迷团 ID + +**接口地址 :** `/fans/group/user/group/detail` + +**调用例子 :** `/fans/group/user/group/detail?groupId=1755777360858267711` + +### 获取乐迷团推荐笔记 + +说明 : 调用此接口 , 可获取指定乐迷团的推荐笔记 + +**必选参数 :** `fansGroupId` : 乐迷团 ID + +**可选参数 :** `cursor` : 游标 , 默认为 0 + +`size` : 返回数量 , 默认为 10 + +**接口地址 :** `/fans/group/feed/recommend` + +**调用例子 :** `/fans/group/feed/recommend?fansGroupId=1872529203038486609&size=10&cursor=0` + ## 离线访问此文档 此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问