feat: 新增 listen_data_song_play_rank 歌曲播放排行接口

新增 /api/content/activity/listen/data/song/play/rank,返回某周/月
听歌排行(每首带 playCount),默认 Top20、不足则返回全部。与已有的
listen_data_today_song(今日)同族,补全「带次数的历史周/月榜」。

- module/listen_data_song_play_rank.js:type(week|month) + endTime 参数
- interface.d.ts:补类型声明
- public/docs/home.md:补接口文档
This commit is contained in:
floatwoozy
2026-06-25 03:25:20 +08:00
parent 1454ee216c
commit f6db3e76e9
3 changed files with 36 additions and 0 deletions
+17
View File
@@ -4810,6 +4810,23 @@ bitrate = Math.floor(br / 1000)
**接口地址 :** `/listen/data/today/song`
### 听歌足迹 - 歌曲播放排行
说明 : 登录后调用此接口, 获取歌曲播放排行, 返回每首歌的播放次数 (playCount); 默认返回前 20 名 (Top20), 不足则返回全部
**必选参数 :**
`type`: 维度类型 周 week 月 month
**可选参数 :**
`endTime` : 周: 每周周六 0 点的时间戳 月: 每月最后一天 0 点的时间戳
不填就是本周/月的
**接口地址 :** `/listen/data/song/play/rank`
**调用例子 :** `/listen/data/song/play/rank?type=month`
### 听歌足迹 - 总收听时长
说明 : 登录后调用此接口, 获取总收听时长; 相关接口可能需要 vip 权限