获取歌手专辑
调用此接口,传入歌手 id, 可获得歌手专辑内容
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /artist/album |
| 请求方式 | GET / POST |
| 需要登录 | 否 |
| 对应模块 | artist_album |
| 文档分类 | 歌手 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
id | string | ✅ | - | 歌手 id |
limit | number | string | — | 30 | 取出数量,默认为 30 |
offset | number | string | — | 为 | 偏移数量,用于分页,如:(页数 - 1)*30, 其中 30 为 limit 的值,默认 为 0 |
HTTP 示例
bash
GET /artist/album?id=6452&limit=5编程式调用
ts
import { artistAlbum } from 'hana-music-api';
const result = await artistAlbum({
id: '6452',
limit: '5',
});
console.log(result.body);返回内容
body.hotAlbums 里每张专辑声明了 id、name、picUrl、size(歌曲数)、artist(id、name)、publishTime(毫秒时间戳)、company(唱片公司),more 表示后面还有没有。只有 code、hotAlbums、hotAlbums[].id 收紧;顶层 artist 和专辑的其他字段宽松。结构定义和类型是 ArtistAlbumBody,见 返回体结构。
补充说明
说明 : 调用此接口,传入歌手 id, 可获得歌手专辑内容
必选参数 : id: 歌手 id
可选参数 : limit: 取出数量,默认为 30
offset: 偏移数量,用于分页,如:(页数 - 1)*30, 其中 30 为 limit 的值,默认 为 0
接口地址 : /artist/album
调用例子 : /artist/album?id=6452&limit=5 ( 周杰伦 )