综合歌单列表查询（海外） - 全民K歌IOT开放平台

综合歌单列表查询，可以查询排行榜、自建歌单、推荐。
推荐优先使用该接口查询歌单。
playlist_id获取途径：

playlist_type: toplist
playlist_id需用接口"榜单列表查询（海外）"查询

playlist_type:recommend
推荐歌单不需传playlist id

playlist type:custom_playlist
playlist_id需用接口"自建歌单列表查询(海外)"查询

用例：用户想查询自建歌单内Best Karaoke Songs的内容，则需先通过自建歌单列表查询(海外)返回以下信息：
{"id": 1000340,
"category_name": "Best Karaoke Songs",}
找到Best Karaoke Songs对应的id，在本接口传入playlist type:”custom_playlist“，id：1000340，即可查询

请求头X-Language参数示例：
"en" -> 英文
"zh_Hans" -> 简体中文
"zh_Hant" -> 繁体中文
"id" -> 印度尼西亚
"ms" -> 马来西亚
"th" -> 泰国
"ph" -> 菲律宾
"vi" -> 越南
"ar" -> 阿拉伯语
"pt" -> 葡萄牙语
"es" -> 西班牙语

请求参数

Header 参数

X-Language

string

语种

可选

示例值:

X-Open-Access-Token

string

必需

access token

默认值:

X-Open-ID

string

openid

必需

默认值:

X-Open-App-ID

string

业务appid

必需

默认值:

Body 参数application/json

index

integer

位置

可选

>= 0

nums

integer

数量

可选

>= 1<= 50

pass_back

string

可选

playlist_id

string

可选

歌单id，可使用“榜单列表查询（海外）”接口查询

playlist_type

string

歌单类型

可选

示例

{
    "playlist_id": "2",
    "playlist_type": "toplist",
    "index": 0,
    "nums": 20
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

sub_code

integer

必需

msg

string

必需

data

object

必需

songs

array [object {43}]

必需

has_more

integer

必需

next_index

integer

必需

pass_back

string

必需

total

integer

必需

detail

object

必需

示例

{"code":0,"sub_code":0,"msg":"请求成功","data":{"songs":[{"status":1,"song_id":"0034bo051eKtJO","song_name":"Cô Độc Vương","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M000sg002cGmyM0ugZbx.jpg","singer_id":"002cGmyM0ugZbx","singer_name":"Thiên Tú","song_type":0,"play_count":1118129,"play_duration":204,"has_mv":false,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":-11,"need_vip":false,"qqmusic_id":0,"language":24,"has_lyric":0,"song_lyric_mask":3,"song_desc":"","480_mv_size":0,"720_mv_size":0,"1080_mv_size":0,"480_mv_cover_size":0,"720_mv_cover_size":0,"1080_mv_cover_size":0,"mv_width":0,"mv_height":0,"mv_cover":"https://imgcache.qq.com/music/photo/mid_album_500/b/x/sg002cGmyM0ugZbx.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false},{"status":1,"song_id":"0040jSbS2DlsWh","song_name":"可可托海的牧羊人","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M000002sYQ3h4Fgp4d.jpg","singer_id":"002YZB8L41d2Ne","singer_name":"王琪","song_type":0,"play_count":1106302,"play_duration":340,"has_mv":true,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":1,"need_vip":false,"qqmusic_id":0,"language":0,"has_lyric":1,"song_lyric_mask":3,"song_desc":"","480_mv_size":31816391,"720_mv_size":58913868,"1080_mv_size":255471686,"480_mv_cover_size":0,"720_mv_cover_size":0,"1080_mv_cover_size":0,"mv_width":1920,"mv_height":1080,"mv_cover":"https://p.kg.qq.com/music/photo_new/T029R960x540M0000013VQgZ1SE2J8.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false},{"status":1,"song_id":"003PKuZP2PsztN","song_name":"Having You Near Me","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M000004JG0Cq4gA5Ne.jpg","singer_id":"001pobIk2GYE2r","singer_name":"Air Supply(AirSupply)","song_type":0,"play_count":4977990,"play_duration":247,"has_mv":false,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":-11,"need_vip":false,"qqmusic_id":0,"language":5,"has_lyric":0,"song_lyric_mask":3,"song_desc":"","480_mv_size":0,"720_mv_size":0,"1080_mv_size":0,"480_mv_cover_size":0,"720_mv_cover_size":0,"1080_mv_cover_size":0,"mv_width":0,"mv_height":0,"mv_cover":"https://imgcache.qq.com/music/photo/mid_album_500/N/e/004JG0Cq4gA5Ne.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false},{"status":1,"song_id":"000JeePO22XI2X","song_name":"白月光与朱砂痣","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M000000dt9Py0BrReK.jpg","singer_id":"002sT7040IAT6z","singer_name":"大籽","song_type":0,"play_count":562685,"play_duration":204,"has_mv":true,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":1,"need_vip":false,"qqmusic_id":0,"language":0,"has_lyric":1,"song_lyric_mask":3,"song_desc":"","480_mv_size":16535628,"720_mv_size":31282247,"1080_mv_size":69997786,"480_mv_cover_size":0,"720_mv_cover_size":0,"1080_mv_cover_size":0,"mv_width":1920,"mv_height":1080,"mv_cover":"https://p.kg.qq.com/music/photo_new/T029R960x540M000004OS5QR42JwWP.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false},{"status":1,"song_id":"002888ho2NCSTJ","song_name":"Sài Gòn Đau Lòng Quá","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M000sg0012Vy6S3753P4.jpg","singer_id":"0012Vy6S3753P4","singer_name":"Hứa Kim Tuyền/Hoàng Duyên","song_type":0,"play_count":256439,"play_duration":312,"has_mv":false,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":-11,"need_vip":false,"qqmusic_id":0,"language":24,"has_lyric":0,"song_lyric_mask":3,"song_desc":"","480_mv_size":0,"720_mv_size":0,"1080_mv_size":0,"480_mv_cover_size":0,"720_mv_cover_size":0,"1080_mv_cover_size":0,"mv_width":0,"mv_height":0,"mv_cover":"https://imgcache.qq.com/music/photo/mid_album_500/P/4/sg0012Vy6S3753P4.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false},{"status":1,"song_id":"002rnFOM4U7DKo","song_name":"Chỉ Là Không Cùng Nhau","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M0000049QHB141QBxr.jpg","singer_id":"001Uy1372BHghq","singer_name":"Tăng Phúc/Trương Thảo Nhi","song_type":0,"play_count":481448,"play_duration":232,"has_mv":false,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":-11,"need_vip":false,"qqmusic_id":0,"language":24,"has_lyric":0,"song_lyric_mask":3,"song_desc":"","480_mv_size":0,"720_mv_size":0,"1080_mv_size":0,"480_mv_cover_size":0,"720_mv_cover_size":0,"1080_mv_cover_size":0,"mv_width":0,"mv_height":0,"mv_cover":"https://imgcache.qq.com/music/photo/mid_album_500/x/r/0049QHB141QBxr.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false},{"status":1,"song_id":"0000GPZN34f4bK","song_name":"永不失联的爱","album_img":"https://p.kg.qq.com/music/photo_new/T002R500x500M000003xoLyf0Xj3Oe.jpg","singer_id":"0022bqqN3dRfN4","singer_name":"Eric周兴哲(Eric Chou)","song_type":0,"play_count":413281,"play_duration":253,"has_mv":true,"has_hq":true,"has_ori_song":true,"has_midi":true,"mv_has_lyric":false,"cp_status":1,"need_vip":false,"qqmusic_id":0,"language":0,"has_lyric":2,"song_lyric_mask":3,"song_desc":"","480_mv_size":29333355,"720_mv_size":38331802,"1080_mv_size":86513145,"480_mv_cover_size":19775949,"720_mv_cover_size":35549296,"1080_mv_cover_size":64407553,"mv_width":1920,"mv_height":1080,"mv_cover":"https://p.kg.qq.com/music/photo_new/T029R960x540M000002SInlP4G4Dbj.jpg","tag_id_list":null,"singer_type":0,"hq_accompany_file_mid":"","hq_song_file_mid":"","hq_accompany_file_md5":"","hq_song_file_md5":"","accompany_file_mid":"","song_file_mid":"","song_mask":0,"has_segment":false,"segment_start_ms":0,"segment_end_ms":0,"is_Favorites":false}],"has_more":1,"next_index":0,"pass_back":"20","total":0,"detail":{"title":"","sub_title":"","square_img":"","long_img":"","desc":""}}}