---
title: "首页弹窗"
method: GET
path: "/recommend/getFistPagePopV2"
tags: ["Recommend"]
---

# 首页弹窗

`GET /recommend/getFistPagePopV2`

返回首页弹窗推荐列表。响应 data 直接为数组。pop_up_style 枚举：0=通用、1=爱情、2=古装、3=萌宝、4=逆袭、5=整图（整图样式下前端直接展示 image 字段的图片，不再叠加样式模板）。

响应契约：FirstPagePopupList。

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

认证要求：需要登录。

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

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

## Query parameters

- `series_id` integer — 当前剧集 ID，用于过滤自身。

## 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` object[], required — 首页弹窗推荐列表。响应 data 即为数组，未再包 list 层。
    - `id` integer — 推荐配置 ID。
    - `recommend_name` string — 推荐标题。
    - `image` string — 弹窗图片地址。当弹窗样式为整图(5)时，客户端应直接以整图方式展示此图。
    - `jump_type` 'play' | 'open_url' | 'inner_url' | 'rand_series' — 跳转类型：play=跳转剧集；open_url=外链；inner_url=内嵌跳转；rand_series=随机剧集（服务端会改写为 play）。
    - `jump_value` string — 跳转目标值（剧集 ID 或 URL 等）。
    - `pop_up_style` 0 | 1 | 2 | 3 | 4 | 5 — 弹窗样式枚举： 0 = 通用 1 = 爱情 2 = 古装 3 = 萌宝 4 = 逆袭 5 = 整图（整图模式下直接展示运营上传的图片，不再叠加样式模板）
    - `url` string — 外链 URL，仅当 jump_type=open_url/inner_url 时有效。
    - `series_id` integer — 关联剧集 ID（0 表示无）。
    - `is_collect` 0 | 1 — 是否已收藏：0/1。
    - `tags` object[] — 额外标签列表，预留字段。
    - `end_time` integer — 活动结束时间（毫秒）。
    - `every_hour` integer — 弹出频率：每 N 小时。由 extra.every_hour 带出。
    - `pop_time` integer — 弹出次数上限。由 extra.pop_time 带出。
    - `home_status` 0 | 1 — 首页场景是否生效：0/1。
    - `foryou_status` 0 | 1 — foryou 场景是否生效：0/1。
    - `play_status` 0 | 1 — 播放器场景是否生效：0/1。
  - `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)