（新）排行榜 - 全民K歌IOT开放平台

请求参数

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

index

integer

起始位置

可选

>= 0

list_id

string

可选

排行榜id，参考《排行榜id说明》

>= 0 字符

num

integer

数量

可选

<= 50

示例

{
    "num": 20,
    "index": 20,
    "list_id": "1"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.kg.qq.com/karaoke/oper/v2/get_toplist' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "num": 20,
    "index": 20,
    "list_id": "1"
}'

返回响应

🟢200OK

application/json

Body

has_more

boolean

可选

PicUrl string json:"pic_url" //完整图片Url
Desc string json:"desc" //详情描述

next_index

integer

可选

下一次传的index

songs

array[object (protocol.SongInfo) {31}]

可选

1080_mv_cover_size

integer

可选

遮挡mv1080质量文件大小

1080_mv_size

integer

可选

mv1080质量文件大小

480_mv_cover_size

integer

可选

遮挡mv480质量文件大小

480_mv_size

integer

可选

mv480质量文件大小

720_mv_cover_size

integer

可选

遮挡mv720质量文件大小

720_mv_size

integer

可选

mv720质量文件大小

album_img

string

可选

歌曲专辑封面图片500*500

cp_status

integer

可选

版权状态，1:有版权， [-99,0]无版权，可播， <-300,无版权，不可播

has_hq

boolean

是否有HQ品质伴奏

可选

has_lyric

integer

可选

（废弃）是否有字幕(0-未知 1-无字幕 2-有字幕)

has_midi

boolean

唱歌时是否支持打分

可选

has_mv

boolean

是否有MV

可选

has_ori_song

boolean

歌曲是否有原唱

可选

language

integer

可选

语种：0-国语 1-粤语 2-闽南语 3-日语 4-韩语 5-英语 6-法语 7-其他 9-纯音乐

mv_cover

string

mv视频封面

可选

mv_has_lyric

boolean

可选

MV是否包含KTV歌词字幕：0-无，1-有（这种情况可以不用再加载伴奏歌词了）

mv_height

integer

mv视频高度

可选

mv_width

integer

mv视频宽度

可选

need_vip

boolean

是否需要VIP

可选

play_count

integer

歌曲播放量

可选

play_duration

integer

播放时长

可选

qqmusic_id

integer

可选

废弃(该字段返回0)

singer_id

string

歌手Id

可选

singer_name

string

歌手名称

可选

song_desc

string

歌曲描述

可选

song_id

string

歌曲编号

可选

song_lyric_mask

integer

可选

伴奏歌词标记，可按位判断与是否有对应的类型。(1:有qrc歌词)+(2:有lrc歌词)

song_name

string

歌曲名称

可选

song_type

integer

可选

歌曲类型 0-完整版 3-Live 6-Remix 100-和声

status

integer

可选

状态 0-下架 1-正常

tag_id_list

array[integer]

可选

tagid列表。参考《TagId对照表》

total_num

integer

可选

总数，只有部分榜单返回

示例

{
    "has_more": true,
    "next_index": 0,
    "songs": [
        {
            "1080_mv_cover_size": 0,
            "1080_mv_size": 0,
            "480_mv_cover_size": 0,
            "480_mv_size": 0,
            "720_mv_cover_size": 0,
            "720_mv_size": 0,
            "album_img": "string",
            "cp_status": 0,
            "has_hq": true,
            "has_lyric": 0,
            "has_midi": true,
            "has_mv": true,
            "has_ori_song": true,
            "language": 0,
            "mv_cover": "string",
            "mv_has_lyric": true,
            "mv_height": 0,
            "mv_width": 0,
            "need_vip": true,
            "play_count": 0,
            "play_duration": 0,
            "qqmusic_id": 0,
            "singer_id": "string",
            "singer_name": "string",
            "song_desc": "string",
            "song_id": "string",
            "song_lyric_mask": 0,
            "song_name": "string",
            "song_type": 0,
            "status": 0,
            "tag_id_list": [
                0
            ]
        }
    ],
    "total_num": 0
}