**版本：202601**

# 查询应用嵌入列表

**GET** `/openapi/2026-01/themes/apps`

返回店铺已安装应用提供的嵌入卡片（app-embed）和注入的 script tag。

## 请求

**Query参数**

- `limit` int32

  返回 app-embed 卡片的数量上限，默认不限制。对 `script_tag_apps` 无效

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `app_embeds` object[]

    店铺已安装应用提供的 app-embed 卡片；每一项都是无固定结构的 JSON 对象
  - `script_tag_apps` object[]

    按应用分组的 script tag 列表

    *   Array \[

    - `app_info` object

      应用信息

      - `id` int64

        应用内部 ID
      - `icon` string

        应用图标 URL
      - `uid` string

        应用 UID（client ID）
      - `name` string

        应用名称（内部）
      - `title` string

        应用显示标题
      - `link` string

        应用入口链接（相对路径）
      - `subtitle` string

        应用副标题 / 简介
      - `installed_at` string

        应用安装时间（RFC3339）
    - `script_tags` object[]

      该应用拥有的 script tag 列表

      *   Array \[

      - `id` string

        Script tag 唯一标识
      - `name` string

        Script tag 名称
      - `app_id` string

        拥有此 script tag 的应用 ID
      - `source` string

        来源：custom（客户定义）或 public（运营平台）
      - `device` string

        目标设备：`all`、`mobile`、`pc`
      - `display_scope` string

        展示页面范围
      - `event_type` string

        脚本事件类型
      - `src` string

        脚本内容或 URL
      - `status` string

        状态：open（有效）或 close（无效）
      - `position` string

        JS 加载位置
      - `store_id` string

        所属店铺 ID
      - `store_domain` string

        目标店铺域名（空 = 全部店铺）
      - `event_period` string

        生效周期，如 permanent
      - `env` string

        环境，如 staging / production
      - `exclude_ids` string

        排除的页面 ID
      - `weight` string

        排序权重（字符串形式）
      - `started_at` string

        开始时间，unix 秒字符串（`0` 表示不限）
      - `ended_at` string

        结束时间，unix 秒字符串（`0` 表示不限）
      - `created_at` string

        创建时间
      - `updated_at` string

        更新时间
      *   \]
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "app_embeds": [
      {}
    ],
    "script_tag_apps": [
      {
        "app_info": {
          "id": 0,
          "icon": "string",
          "uid": "string",
          "name": "string",
          "title": "string",
          "link": "string",
          "subtitle": "string",
          "installed_at": "string"
        },
        "script_tags": [
          {
            "id": "string",
            "name": "string",
            "app_id": "string",
            "source": "string",
            "device": "string",
            "display_scope": "string",
            "event_type": "string",
            "src": "string",
            "status": "string",
            "position": "string",
            "store_id": "string",
            "store_domain": "string",
            "event_period": "string",
            "env": "string",
            "exclude_ids": "string",
            "weight": "string",
            "started_at": "string",
            "ended_at": "string",
            "created_at": "string",
            "updated_at": "string"
          }
        ]
      }
    ]
  }
}
```