**版本：202601**

# 查询商品图片列表

**GET** `/openapi/2026-01/products/:product_id/images`

分页获取所有商品图片列表。

## 请求

**Path参数**

- `product_id` string (required)

  商品 ID

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `images` object[]

    图片列表

    *   Array \[

    - `id` string

      图片 ID
    - `product_id` string

      与图片关联的商品 ID
    - `position` int32

      图片在商品图库中相对于其他图片的位置
    - `src` string

      图片的 URL
    - `width` int32

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

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

      图片的替代文本（用于可访问性或描述）
    - `created_at` string

      图片创建时间
    - `updated_at` string

      图片最后更新时间
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "images": [
      {
        "id": "string",
        "product_id": "string",
        "position": 0,
        "src": "string",
        "width": 0,
        "height": 0,
        "alt": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ]
  }
}
```