搜索联想

正式环境

https://api.kg.qq.com

POST

/karaoke/base/v2/search_hint

基础类

搜索提示联想功能帮助用户联想出相关的搜索词

请求参数

Header 参数

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

可选

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Device-ID

string

可选

设备id，调用KtvSdk.getSdkImei()获取

Body 参数application/json

page_num

integer

每页数量，最多20

可选

>= 1<= 20

start_page

integer

起始页，从1开始

必需

>= 1

word

string

搜索词

必需

示例

{
  "start_page": 1,
  "word": "wo",
  "page_num": 10
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.kg.qq.com/karaoke/base/v2/search_hint' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start_page": 1,
    "word": "wo",
    "page_num": 10
}'

返回响应

🟢200OK

application/json

Body

has_more

boolean

可选

items

array[string]

可选

示例

{
  "code": 0,
  "sub_code": 0,
  "msg": "请求成功",
  "data": {
    "has_more": true,
    "items": [
      "我想静静 秋裤大叔",
      "我来人间一趟",
      "我是你的格桑花",
      "我拿青春爱错人",
      "我的快乐就是想你 陈雅森",
      "我在红尘中遇见你 张冬玲/冷漠",
      "我记得",
      "我是一条小河",
      "我曾用心爱着你",
      "我是否也在你心中 高安/囚鸟"
    ]
  }
}

搜索

查询歌手歌曲