---
title: "Web 获取官网资源位投放"
method: GET
path: "/webResource/positions"
tags: ["Web Resource"]
---

# Web 获取官网资源位投放

`GET /webResource/positions`

返回官网各资源位的投放配置，按资源位编码平铺在 data 下。允许未登录访问；若投放配置了用户分层，则仅命中分层的登录用户可见。\n\n**后端自动处理（无需传参）**\n- 端口：由请求头 appId 识别（WEB=PC，WAP=MobileWeb）\n- 语言：由请求头 lang 识别\n- 跳转链接：jump_url 由国家消费档位自动解析（default/test/T1/T2/T3）\n\n**去重规则**\n同一语言、端口、资源位、跳转类型仅返回权重最高的一条。\n\n**页面展示**\n接口不按 page_code 过滤，响应中的 page_codes 供前端按当前页面自行判断是否展示；page_codes 为空数组表示不限页面。\n\n无投放时对应资源位返回 null，前端应隐藏且不占位。

响应契约：ResourcePositionMap。

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

认证要求：无需登录。

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

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

## Query parameters

- `slot_code` string — 指定资源位编码，不传则返回全部资源位。可选值：incentive_task_nav=激励任务导航，banner_bottom_bar=底部 Banner 条，card_float=卡片浮窗，profile_homepage=个人中心首页资源位。

## 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` ResourcePositionMap, required — 官网资源位投放结果，按资源位编码平铺在 data 下；每个 key 对应一条配置或 null。
    - `incentive_task_nav` ResourcePositionItem — 单个资源位投放配置。
      - `id` integer — 投放配置 ID。
      - `slot_code` string — 资源位编码。
      - `resource_name` string — 资源名称。
      - `title` string — 展示标题。
      - `icon` string — 图标完整 URL；静态图为图片地址，Lottie 为 JSON 文件地址。
      - `icon_type` 'image' | 'lottie' — 图标类型，由文件后缀自动识别：image=静态图片，lottie=Lottie 动画 JSON。
      - `tip` string — 提示文案。
      - `jump_type` string — 跳转类型，如 turbolink_task_center。
      - `jump_config` object — 分档位跳转配置，key 为 default/test/T1/T2/T3。
      - `jump_url` string — 后端解析后的最终跳转链接。
      - `scene_tag` string — 本次资源位命中的消费档位标识，用于前端埋点；取值如 default、test、T1、T2、T3。
      - `page_codes` string[] — 启用页面编码列表，空数组表示不限页面。可选值：index、index_group、play、detail、short_episode、search、tag_filter、tag_detail、all_tags、profile。
      - `weight` integer — 权重。
    - `banner_bottom_bar` ResourcePositionItem — 单个资源位投放配置。
      - `id` integer — 投放配置 ID。
      - `slot_code` string — 资源位编码。
      - `resource_name` string — 资源名称。
      - `title` string — 展示标题。
      - `icon` string — 图标完整 URL；静态图为图片地址，Lottie 为 JSON 文件地址。
      - `icon_type` 'image' | 'lottie' — 图标类型，由文件后缀自动识别：image=静态图片，lottie=Lottie 动画 JSON。
      - `tip` string — 提示文案。
      - `jump_type` string — 跳转类型，如 turbolink_task_center。
      - `jump_config` object — 分档位跳转配置，key 为 default/test/T1/T2/T3。
      - `jump_url` string — 后端解析后的最终跳转链接。
      - `scene_tag` string — 本次资源位命中的消费档位标识，用于前端埋点；取值如 default、test、T1、T2、T3。
      - `page_codes` string[] — 启用页面编码列表，空数组表示不限页面。可选值：index、index_group、play、detail、short_episode、search、tag_filter、tag_detail、all_tags、profile。
      - `weight` integer — 权重。
    - `card_float` ResourcePositionItem — 单个资源位投放配置。
      - `id` integer — 投放配置 ID。
      - `slot_code` string — 资源位编码。
      - `resource_name` string — 资源名称。
      - `title` string — 展示标题。
      - `icon` string — 图标完整 URL；静态图为图片地址，Lottie 为 JSON 文件地址。
      - `icon_type` 'image' | 'lottie' — 图标类型，由文件后缀自动识别：image=静态图片，lottie=Lottie 动画 JSON。
      - `tip` string — 提示文案。
      - `jump_type` string — 跳转类型，如 turbolink_task_center。
      - `jump_config` object — 分档位跳转配置，key 为 default/test/T1/T2/T3。
      - `jump_url` string — 后端解析后的最终跳转链接。
      - `scene_tag` string — 本次资源位命中的消费档位标识，用于前端埋点；取值如 default、test、T1、T2、T3。
      - `page_codes` string[] — 启用页面编码列表，空数组表示不限页面。可选值：index、index_group、play、detail、short_episode、search、tag_filter、tag_detail、all_tags、profile。
      - `weight` integer — 权重。
    - `profile_homepage` ResourcePositionItem — 单个资源位投放配置。
      - `id` integer — 投放配置 ID。
      - `slot_code` string — 资源位编码。
      - `resource_name` string — 资源名称。
      - `title` string — 展示标题。
      - `icon` string — 图标完整 URL；静态图为图片地址，Lottie 为 JSON 文件地址。
      - `icon_type` 'image' | 'lottie' — 图标类型，由文件后缀自动识别：image=静态图片，lottie=Lottie 动画 JSON。
      - `tip` string — 提示文案。
      - `jump_type` string — 跳转类型，如 turbolink_task_center。
      - `jump_config` object — 分档位跳转配置，key 为 default/test/T1/T2/T3。
      - `jump_url` string — 后端解析后的最终跳转链接。
      - `scene_tag` string — 本次资源位命中的消费档位标识，用于前端埋点；取值如 default、test、T1、T2、T3。
      - `page_codes` string[] — 启用页面编码列表，空数组表示不限页面。可选值：index、index_group、play、detail、short_episode、search、tag_filter、tag_detail、all_tags、profile。
      - `weight` integer — 权重。
  - `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)