查询歌手歌曲 - 全民K歌IOT开放平台

根据歌手id查询歌手所有的歌曲

请求参数

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开始，返回[index, index+page_num)的内容

page_num

integer

可选

数量。可能会少于page_num条

>= 1

query

string

可选

过滤词，搜索该歌手下的匹配歌曲。可为空

singer_id

string

歌手Id

必需

start_page

integer

每页返回数量

可选

>= 1

示例

{
  "index": 0,
  "page_num": 1,
  "query": "string",
  "singer_id": "string",
  "start_page": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

has_more

boolean

是否含有更多

可选

next_index

integer

可选

下一次传的index

singer_cover

string

歌手图片

可选

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,
  "singer_cover": "string",
  "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
}