曲风-专辑
调用此接口可以获取该曲风对应的专辑
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /style/album |
| 请求方式 | GET / POST |
| 需要登录 | 否 |
| 对应模块 | style_album |
| 文档分类 | 曲风 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
tagId | string | ✅ | - | 曲风 ID |
size | number | string | — | 20 | 返回数量，默认为 20 |
cursor | number | string | — | 0 | 返回数据的 cursor, 默认为 0，传入上一次返回结果的 cursor,将会返回下一页的数据 |
sort | string | — | - | 排序方式，0: 按热度排序，1: 按时间排序 |
HTTP 示例
bash
GET /style/album?tagId=1000
GET /style/album?tagId=1010&sort=1编程式调用
ts
import { styleAlbum } from 'hana-music-api';
const result = await styleAlbum({
tagId: '1000',
});
console.log(result.body);返回内容
body.code、body.data.albums 和每张专辑自己的编号 data.albums[].id 收紧：data.albums 是通到曲风专辑的路径。专辑记录复用宽松的 SimpleAlbum，只把 id 收紧；songs 在录制里只见过空数组，元素类型猜不出，没有声明，awardTags、displayTags 只见过 null，也没有声明。body.data.page 是分页提示，全部宽松。未知曲风 id 返回空数组（录制 style_album.unknown-tag.json）。
补充说明
说明: 调用此接口可以获取该曲风对应的专辑
接口地址: /style/album
必选参数: tagId: 曲风 ID
可选参数 : size : 返回数量，默认为 20
cursor : 返回数据的 cursor, 默认为 0，传入上一次返回结果的 cursor,将会返回下一页的数据
sort: 排序方式，0: 按热度排序，1: 按时间排序
调用例子: /style/album?tagId=1000 /style/album?tagId=1010&sort=1