**版本：202701**

# 查询定制模板列表

**GET** `/openapi/2027-01/customization/templates`

分页返回当前店铺可复用的定制模板列表。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页返回的记录数，范围 1-100，默认 20
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `name` string

  按模板名模糊过滤

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `templates` object[]

    模板列表

    *   Array [

    - `id` string

      模板 ID
    - `name` string

      模板名称
    - `image` object

      模板封面图

      - `src` string

        图片地址
      - `width` int32

        图片宽度（像素）
      - `height` int32

        图片高度（像素）
    - `updated_at` string

      最后更新时间，ISO 8601
    - `related_product_count` int32

      关联的定制商品数量
    *   ]
  - `cursor` string

    下一页游标；没有更多数据时为空
  - `has_more` boolean

    是否还有下一页
  - `total` int32

    全部页的模板总数

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "templates": [
      {
        "id": "string",
        "name": "string",
        "image": {
          "src": "string",
          "width": 0,
          "height": 0
        },
        "updated_at": "string",
        "related_product_count": 0
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```