feat: 增加听歌足迹相关接口

public/docs/home.md

@@ -312,6 +312,11 @@
 294. 用户状态 - 支持设置的状态
 295. 用户状态 - 相同状态的用户
 296. 用户状态 - 编辑
+297. 听歌足迹 - 年度听歌足迹
+298. 听歌足迹 - 今日收听
+299. 听歌足迹 - 总收听时长
+300. 听歌足迹 - 本周/本月收听时长
+301. 听歌足迹 - 周/月/年收听报告
 
 ## 安装
 
@@ -4863,6 +4868,53 @@ bitrate = Math.floor(br / 1000)
 
 **接口地址 :** `/user/social/status/edit`
 
+### 听歌足迹 - 年度听歌足迹
+
+说明 : 登录后调用此接口, 获取年度听歌足迹
+
+**接口地址 :** `/listen/data/year/report`
+
+### 听歌足迹 - 今日收听
+
+说明 : 登录后调用此接口, 获取今日收听
+
+**接口地址 :** `/listen/data/today/song`
+
+### 听歌足迹 - 总收听时长
+
+说明 : 登录后调用此接口, 获取总收听时长; 相关接口可能需要vip权限
+
+**接口地址 :** `/listen/data/total`
+
+### 听歌足迹 - 本周/本月收听时长
+
+说明 : 登录后调用此接口, 获取本周/本月收听时长
+
+**必选参数 :**  
+
+`type`: 维度类型 周 week 月 month; 今年没结束，不支持今年的数据
+
+**接口地址 :** `/listen/data/realtime/report`
+
+**调用例子 :** `/listen/data/realtime/report?type=month`
+
+### 听歌足迹 - 周/月/年收听报告
+
+说明 : 登录后调用此接口, 获取周/月/年收听报告
+
+**必选参数 :**  
+
+`type`: 维度类型 周 week 月 month 年 year
+
+**可选参数 :**
+
+`endTime` : 周: 每周周六0点的时间戳 月: 每月最后一天0点的时间戳 年: 每年最后一天0点的时间戳
+不填就是本周/月的, 今年没结束，则没有今年的数据
+
+**接口地址 :** `/listen/data/report`
+
+**调用例子 :** `/listen/data/report?type=month`
+
 ## 离线访问此文档
 
 此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问