---
title: "首页轮播图列表"
method: GET
path: "/getBannerList"
tags: ["Index"]
---

# 首页轮播图列表

`GET /getBannerList`

返回 App 首页轮播图数据。

响应契约：BannerList。

需要登录。 需要请求签名。 响应会经过加密中间件。

认证要求：需要登录。

签名要求：需要请求签名。

响应处理：默认会经过响应加密。

## Headers

- `lang` string — 语言代码，例如 en、zh、es。
- `device_number` string — 设备唯一标识。
- `app_version` string — 客户端版本号。
- `timestamp` integer — 请求时间戳（秒）。
- `signature` string — 接口签名。

## Response `200`

请求成功

- object
  - `code` integer, required
  - `msg` string, required
  - `data` BannerList, required — Banner 列表。
    - `list` object[]
      - `title` string
      - `image` string
      - `jump_type` integer
      - `link` string
      - `series_id` integer
      - `description` string
      - `tags` object[]
        - `tag_id` integer, required — 标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。
        - `tag_name` string, required — 当前语言下的标签展示名称。
        - `url_title` string, required — 标签 URL 基础 slug，不包含 web_tag_id。
        - `web_tag_id` string, required — 由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。
  - `info` object, required
  - `is_encrypt` 0 | 1, required
  - `request_id` string, required
  - `response_time` integer, required
  - `original_data` object

## Other responses

- `400` — 请求失败

---

[API](https://skmtc.dev/flextv/apis/flextv-api.md) · [All operations](https://skmtc.dev/flextv/apis/flextv-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flextv/flextv-api/revisions/84f55eb57fd0/schema)