Skip to content

曲风-歌曲 ​

调用此接口可以获取该曲风对应的歌曲

接口信息 ​

项目值
接口地址/style/song
请求方式GET / POST
需要登录否
对应模块style_song
文档分类曲风

请求参数 ​

参数类型必填默认值说明
tagIdstring✅-曲风 ID
sizenumber | string—20返回数量,默认为 20
cursornumber | string—0返回数据的 cursor, 默认为 0,传入上一次返回结果的 cursor,将会返回下一页的数据
sortstring—-排序方式,0: 按热度排序,1: 按时间排序

HTTP 示例 ​

bash
GET /style/song?tagId=1000
GET /style/song?tagId=1010&sort=1

编程式调用 ​

ts
import { styleSong } from 'hana-music-api';

const result = await styleSong({
  tagId: '1000',
});

console.log(result.body);

返回内容 ​

body.code、body.data.songs 和每首歌自己的编号 data.songs[].id 收紧:data.songs 是通到曲风歌曲的路径。歌曲复用共享的 Song,其中只有 id 收紧,其余声明字段宽松。body.data.page 是分页提示,全部宽松。未知曲风 id 返回空数组(录制 style_song.unknown-tag.json)。

补充说明 ​

说明: 调用此接口可以获取该曲风对应的歌曲

接口地址: /style/song

必选参数: tagId: 曲风 ID

可选参数 : size : 返回数量,默认为 20

cursor : 返回数据的 cursor, 默认为 0,传入上一次返回结果的 cursor,将会返回下一页的数据

sort: 排序方式,0: 按热度排序,1: 按时间排序

调用例子: /style/song?tagId=1000 /style/song?tagId=1010&sort=1

Released under the MIT License.