最近播放-专辑
调用此接口,可获得最近播放-专辑
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /record/recent/album |
| 请求方式 | GET / POST |
| 需要登录 | 否 |
| 对应模块 | record_recent_album |
| 文档分类 | 听歌记录 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
limit | number | string | — | 100 | 返回数量,默认为 100 |
HTTP 示例
bash
GET /record/recent/album?limit=1编程式调用
ts
import { recordRecentAlbum } from 'hana-music-api';
const result = await recordRecentAlbum({
limit: '1',
});
console.log(result.body);返回内容
body.code、body.data、body.data.list 和每条记录的 resourceId(字符串)、专辑 data.id 收紧;专辑摘要复用 AlbumSummary,记录里附带的 songs(专辑的完整歌曲数组,录制里长度等于 size)、lastSong、transName、playTime、resourceType、total、message 和其余展示字段宽松。limit 非数字时上游 HTTP 400 空正文被归一成 status: 200、body: '',结构定义保留这个空字符串分支。结构定义和类型是 RecordRecentAlbumBody,见 返回体结构。匿名调用返回 total: 0、list: [](录制 record_recent_album.anonymous.json),作为真实空结果;登录录制见 record_recent_album.default.json。
补充说明
说明 : 调用此接口,可获得最近播放-专辑
可选参数 : limit : 返回数量,默认为 100
接口地址 : /record/recent/album
调用例子 : /record/recent/album?limit=1