---
title: "GET /v1/admin/model-square/banners"
method: GET
path: "/v1/admin/model-square/banners"
tags: ["AdminModelSquareService"]
---

# GET /v1/admin/model-square/banners

`GET /v1/admin/model-square/banners`

ListBanners 查询 Banner 列表（前后台复用：前台首页展示亦调用本接口，登录即可）。
 ListBanners returns the banner list; shared by admin and console (login is enough).

## Query parameters

- `status` string
- `sortOrder` string
- `lang` string
- `page` integer
- `pageSize` integer
- `title` string

## Response `200`

OK

- ModelsquareV1ListBannersReply — ListBannersReply Banner 列表响应。/ ListBannersReply is the banner list reply.
  - `carouselIntervalSeconds` integer — 每张 Banner 停留秒数。
  - `items` ModelsquareV1Banner[]
    - `bannerCode` string
    - `bannerId` integer
    - `createdAt` string, date-time
    - `creator` string
    - `creatorName` string — 创建人展示名；无法解析时回退 creator。
    - `description` string — 推送描述，最长 500 个字符。
    - `i18nImages` ModelsquareV1I18nImage[] — 中英双语图片全量。/ Full set of zh + en images.
      - `imageUrl` string — 当前语言 Banner 大图地址。/ Full-size banner image URL for this language.
      - `langCode` string — 语言编码：仅允许 zh / en。/ Language code: only zh or en.
      - `thumbnailUrl` string — 当前语言 Banner 缩略图地址（可选）。/ Thumbnail URL for this language (optional).
    - `imageUrl` string
    - `jumpUrl` string
    - `langCode` string — 按请求 lang 解析出的当前语言图片信息（列表接口填充；创建/编辑响应可为空）。 Resolved current-language image by request lang (filled by list; may be empty on create/update).
    - `remark` string
    - `sort` integer
    - `status` string — 推荐状态：PENDING(待发布) / PUBLISHED(已发布) / OFFLINE(已下架)。 Status: PENDING / PUBLISHED / OFFLINE.
    - `thumbnailUrl` string
    - `title` string — 推送标题，最长 100 个字符。
    - `updatedAt` string, date-time
    - `updater` string
    - `updaterName` string — 修改人展示名；无法解析时回退 updater。
  - `page` integer
  - `pageSize` integer
  - `total` integer

---

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