歌手分类列表

调用此接口,可获取歌手分类列表

接口信息

项目	值
接口地址	/artist/list
请求方式	GET / POST
需要登录	否
对应模块	artist_list
文档分类	歌手

请求参数

参数	类型	必填	默认值	说明
limit	number | string	—	30	返回数量，默认为 30
offset	number | string	—	0	偏移数量，用于分页，如 : 如：(页数 - 1)*30, 其中 30 为 limit 的值，默认为 0
initial	string	—	-	按首字母索引查找参数,如 /artist/list?type=1&area=96&initial=b 返回内容将以 name 字段开头为 b 或者拼音开头为 b 为顺序排列, 热门传-1,#传 0
type	string	—	-	取值: -1:全部 1:男歌手 2:女歌手 3:乐队
area	string	—	-	取值: -1:全部 7华语 96欧美 8:日本 16韩国 0:其他

HTTP 示例

GET /artist/list?type=1&area=96&initial=b
GET /artist/list?type=2&area=2&initial=b

编程式调用

import { artistList } from 'hana-music-api';

const result = await artistList({
  type: '1',
  area: '96',
  initial: 'b',
});

console.log(result.body);

返回内容

body.code、歌手列表 body.artists 和每个歌手的编号 artists[].id 收紧；more 是分页标记，宽松。offset 越过总数时返回空 artists（录制 artist_list.empty.json），数组本身允许为空。歌手记录的其余字段（name、alias、fansCount、picUrl 等）都是宽松字段。结构定义和类型是 ArtistListBody，见 返回体结构。

补充说明

说明 : 调用此接口,可获取歌手分类列表

可选参数 :

limit : 返回数量，默认为 30

offset : 偏移数量，用于分页，如 : 如：(页数 - 1)*30, 其中 30 为 limit 的值，默认为 0 initial: 按首字母索引查找参数,如 /artist/list?type=1&area=96&initial=b 返回内容将以 name 字段开头为 b 或者拼音开头为 b 为顺序排列, 热门传-1,#传 0

type 取值:

-1:全部
1:男歌手
2:女歌手
3:乐队

area 取值:

-1:全部
7华语
96欧美
8:日本
16韩国
0:其他

接口地址 : /artist/list

调用例子 : /artist/list?type=1&area=96&initial=b /artist/list?type=2&area=2&initial=b