搜索联想

正式环境

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": [
            "我想静静 秋裤大叔",
            "我来人间一趟",
            "我是你的格桑花",
            "我拿青春爱错人",
            "我的快乐就是想你 陈雅森",
            "我在红尘中遇见你 张冬玲/冷漠",
            "我记得",
            "我是一条小河",
            "我曾用心爱着你",
            "我是否也在你心中 高安/囚鸟"
        ]
    }
}

修改于 2024-07-10 08:55:47

搜索

查询歌手歌曲