获取专题下歌曲信息 - 全民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

可选

page_num

integer

最大30

可选

>= 1

start_page

integer

可选

>= 1

theme_id

integer

歌单Id

可选

示例

{
  "index": 0,
  "page_num": 1,
  "start_page": 1,
  "theme_id": 0
}

示例代码

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_theme_songs' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "index": 0,
    "page_num": 1,
    "start_page": 1,
    "theme_id": 0
}'

返回响应

🟢200OK

application/json

Body

has_more

boolean

是否还有更多

可选

next_index

integer

可选

theme

object (protocol.Theme)

可选

songs

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

专题歌曲列表

可选

theme_desc

string

专题详情

可选

theme_id

integer

可选

theme唯一id, 大于0专题, 小于0自建歌单

theme_name

string

专题名称

可选

theme_pic

string

专题封面

可选

total_num

integer

歌单下歌曲数量

可选

示例

{
  "has_more": true,
  "next_index": 0,
  "theme": {
    "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
        ]
      }
    ],
    "theme_desc": "string",
    "theme_id": 0,
    "theme_name": "string",
    "theme_pic": "string"
  },
  "total_num": 0
}