获取专题分类列表
正式环境
正式环境
POST
/karaoke/oper/v2/get_class_list
运营类
建议直接从厂商后台配置,客户端从厂商后台获取分类列表后,再根据歌单ID调用开平接口查询歌单歌曲列表。
请求参数
Header 参数
X-Open-Access-Token
string
必需
默认值:
{{X-Open-Access-Token}}
X-Open-ID
string
openid
默认值:
{{X-Open-ID}}
X-Open-App-ID
string
业务appid
默认值:
{{X-Open-App-ID}}
Device-ID
string
可选
Body 参数application/json
scene
integer
场景
示例
{
"scene": 0
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kg.qq.com/karaoke/oper/v2/get_class_list' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw ''
返回响应
🟢200OK
application/json
Body
class_list
array[object (protocol.ThemeClass) {3}]
可选
class_id
integer
可选
class_name
string
可选
themes
array[object (protocol.Theme) {5}]
可选
示例
{
"class_list": [
{
"class_id": 0,
"class_name": "string",
"themes": [
{
"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"
}
]
}
]
}
修改于 2025-02-28 09:58:58