本文档由 Tester 自动生成,最后修改时间 2020-09-04 09:37:11
一、接口说明
可根据歌手、歌曲等进行歌曲的搜索
二、请求方式
POST https://api.bbbug.com/api/song/search
三、请求参数
字段 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
keyword | string | 是 | 周杰伦 | - |
access_token | string | 是 | 123456 | - |
plat | string | 是 | pc | - |
version | number | 是 | 10000 | - |
示例JSON:
{
"keyword": "周杰伦",
"access_token": "123456",
"plat": "pc",
"version": 10000
}
四、更多参数
Headers:
Content-Type:application/json;
五、返回数据
字段 | 类型 | 固定 | 示例值 | 说明 |
---|---|---|---|---|
code | number | 是 | 200 | - |
msg | string | 是 | - | |
data | array | 是 | [] | 歌曲对象数组,后边会用到 |
data.mid | number | 是 | 142655450 | 歌曲ID |
data.name | string | 是 | Mojito | 歌曲名称 |
data.pic | string | 是 | http://309391875.jpg | 歌曲头图 |
data.length | number | 是 | 185 | 歌曲播放秒数 |
data.singer | string | 是 | 周杰伦 | 歌手名称 |
示例返回结果:
{
"code": 200,
"msg": "",
"data": [
{
"mid": 142655450,
"name": "Mojito",
"pic": "http://img3.kuwo.cn/star/albumcover/300/48/47/309391875.jpg",
"length": 185,
"singer": "周杰伦"
},
{
"mid": 228908,
"name": "晴天",
"pic": "http://img2.kuwo.cn/star/albumcover/300/64/96/2266534336.jpg",
"length": 269,
"singer": "周杰伦"
},
{
"mid": 7149583,
"name": "告白气球",
"pic": "http://img2.kuwo.cn/star/albumcover/300/64/39/3540704654.jpg",
"length": 215,
"singer": "周杰伦"
},
{
"mid": 140064959,
"name": "稻香",
"pic": "http://img1.kuwo.cn/star/starheads/300/10/6/294045140.jpg",
"length": 198,
"singer": "周杰伦&林俊杰"
}
]
}
六、测试用例
https://tester.hamm.cn/#/20200922/10f5ba58efed41b91431d89646a9f290ced6e7f9