拉取短剧合集的列表 - 全民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

album_id

integer

短剧集id

必需

dir

enum<integer>

可选

翻页方向 1-正向 2-反向（返回上一页）

枚举值:

12

jump_ugcid

string

必需

子集id。用于定位，返回包括当前集数在内的前/后10集

passback

string

回传

可选

示例

{
  "album_id": 1557,
  "jump_ugcid": "400746523_1700119944_890",
  "dir": 1,
  "passback": "DBwmGDQwMDc0NjUyM18xNjk5NjEwNTg0XzYxMjw="
}

示例代码

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/mini_show_collection' \
--header 'X-Open-Access-Token;' \
--header 'X-Open-ID: ' \
--header 'X-Open-App-ID;' \
--header 'Device-ID;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "album_id": 1557,
    "jump_ugcid": "400746523_1700119944_890",
    "dir": 1,
    "passback": "DBwmGDQwMDc0NjUyM18xNjk5NjEwNTg0XzYxMjw="
}'

返回响应

🟢200OK

application/json

Body

album_detail

object (protocol.MiniShowItem)

可选

album_cover

string

专辑封面

可选

album_id

integer

专辑ID

可选

album_title

string

标题

可选

desc

string

剧情介绍

可选

is_free

boolean

短剧是否全免费

可选

jump_ugcid

string

可选

跳转作品ID，一般是第一集

offline

integer

可选

是否下架 offline=1 已下架

play_num

integer

短剧合辑播放总量

可选

total_set

integer

总集数

可选

episodes

array[object (protocol.Episode) {6}]

子集详情

可选

cover

string

封面

可选

desc

string

剧情介绍

可选

location

integer

第N集，从1开始

可选

pay_type

integer

可选

付费类型参考 EnumPayType

play_cnt

integer

播放次数

可选

ugcid

string

作品ID

可选

has_more

integer

1-有更多

可选

passback

string

回传

可选

示例

{
  "code": 0,
  "sub_code": 0,
  "msg": "请求成功",
  "data": {
    "passback": "DBwmFzQwMDc0NjUyM18xNjk5NjEwNTYzXzMzPA==",
    "has_more": 1,
    "album_detail": {
      "album_id": 1557,
      "album_title": "妻子的背叛",
      "album_cover": "http://img.tencentmusic.com/T013M000004NqKXz2t3bex.jpg",
      "jump_ugcid": "",
      "desc": "男子出差提前回来了，哪知家里出大事儿了！",
      "play_num": 763,
      "offline": 0,
      "total_set": 32
    },
    "episodes": [
      {
        "location": 22,
        "cover": "",
        "ugcid": "400746523_1700119898_525",
        "desc": "",
        "play_cnt": 3,
        "pay_type": 1
      },
      {
        "location": 23,
        "cover": "",
        "ugcid": "400746523_1700119952_349",
        "desc": "",
        "play_cnt": 10,
        "pay_type": 1
      },
      {
        "location": 24,
        "cover": "",
        "ugcid": "400746523_1699610525_918",
        "desc": "feqeqf",
        "play_cnt": 2,
        "pay_type": 1
      },
      {
        "location": 25,
        "cover": "",
        "ugcid": "400746523_1700119918_908",
        "desc": "",
        "play_cnt": 3,
        "pay_type": 1
      },
      {
        "location": 26,
        "cover": "",
        "ugcid": "400746523_1700119912_753",
        "desc": "fqfeqfeq",
        "play_cnt": 13,
        "pay_type": 1
      },
      {
        "location": 27,
        "cover": "",
        "ugcid": "400746523_1700119950_54",
        "desc": "",
        "play_cnt": 8,
        "pay_type": 1
      },
      {
        "location": 28,
        "cover": "",
        "ugcid": "400746523_1700119900_863",
        "desc": "",
        "play_cnt": 4,
        "pay_type": 1
      },
      {
        "location": 29,
        "cover": "",
        "ugcid": "400746523_1699610639_640",
        "desc": "",
        "play_cnt": 5,
        "pay_type": 1
      },
      {
        "location": 30,
        "cover": "",
        "ugcid": "400746523_1699610693_957",
        "desc": "",
        "play_cnt": 3,
        "pay_type": 1
      },
      {
        "location": 31,
        "cover": "",
        "ugcid": "400746523_1699610563_33",
        "desc": "",
        "play_cnt": 10,
        "pay_type": 1
      }
    ]
  }
}