听歌足迹 - 周/月/年收听报告
登录后调用此接口, 获取周/月/年收听报告
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /listen/data/report |
| 请求方式 | GET / POST |
| 需要登录 | 是 |
| 对应模块 | listen_data_report |
| 文档分类 | 听歌记录 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
type | string | ✅ | - | 维度类型 周 week 月 month 年 year |
endTime | number | string | — | - | 周: 每周周六0点的时间戳 月: 每月最后一天0点的时间戳 年: 每年最后一天0点的时间戳 不填就是本周/月的, 今年没结束，则没有今年的数据 |
HTTP 示例
bash
GET /listen/data/report?type=month编程式调用
ts
import { listenDataReport } from 'hana-music-api'
const result = await listenDataReport({
type: 'month',
})
console.log(result.body)补充说明
说明 : 登录后调用此接口, 获取周/月/年收听报告
必选参数 :
type: 维度类型 周 week 月 month 年 year
可选参数 :
endTime : 周: 每周周六0点的时间戳 月: 每月最后一天0点的时间戳 年: 每年最后一天0点的时间戳 不填就是本周/月的, 今年没结束，则没有今年的数据
接口地址 : /listen/data/report
调用例子 : /listen/data/report?type=month