云搜索
和搜索接口相同，但结果更完整。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /cloudsearch |
| 请求方式 | GET / POST |
| 需要登录 | 否 |
| 对应模块 | cloudsearch |
| 文档分类 | 搜索 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
keywords | string | ✅ | - | 关键词 |
limit | number | string | — | 30 | 返回数量，默认为 30 offset : 偏移数量，用于分页，如: 如：(页数 - 1)*30, 其中 30 为 limit 的值，默认为 0 |
type | string | — | 1 | 搜索类型；默认为 1 即单曲，取值意义 : 1: 单曲, 10: 专辑, 100: 歌手, 1000: 歌单, 1002: 用户, 1004: MV, 1006: 歌词, 1009: 电台, 1014: 视频, 1018:综合, 2000:声音(搜索声音返回字段格式会不一样) |
HTTP 示例
bash
GET /cloudsearch?keywords=海阔天空编程式调用
ts
import { cloudsearch } from 'hana-music-api'
const result = await cloudsearch({
keywords: '海阔天空',
})
console.log(result.body)补充说明
说明 : 调用此接口，传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户 , 关键词可以多个，以空格隔开，如 " 周杰伦 搁浅 "( 不需要登录 ), 可通过 /song/url 接口传入歌曲 id 获取具体的播放链接
必选参数 : keywords : 关键词
可选参数 : limit : 返回数量，默认为 30 offset : 偏移数量，用于分页，如 : 如：(页数 - 1)*30, 其中 30 为 limit 的值，默认为 0
type: 搜索类型；默认为 1 即单曲，取值意义 : 1: 单曲, 10: 专辑, 100: 歌手, 1000: 歌单, 1002: 用户, 1004: MV, 1006: 歌词, 1009: 电台, 1014: 视频, 1018:综合, 2000:声音(搜索声音返回字段格式会不一样)
接口地址 : /search 或者 /cloudsearch(更全)
调用例子 : /search?keywords=海阔天空 /cloudsearch?keywords=海阔天空