创建商品图片

POST 
/openapi/2026-07/products/:product_id/images

使用提供的详情创建新的商品图片。

请求

Path参数

product_id string必填

商品 ID

application/json

请求体

请求体必填

image object必填

图片

srcstring必填

图片的 URL，必须为有效 URL

altstring

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

widthint32

图片宽度（像素），必须大于 0

heightint32

图片高度（像素），必须大于 0

positionint32

图片相对于其他图片的位置，必须大于 0

示例

{
  "image": {
    "src": "string",
    "alt": "string",
    "width": 0,
    "height": 0,
    "position": 0
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

image object

图片

idstring

图片 ID

product_idstring

与图片关联的商品 ID

positionint32

图片在商品图库中相对于其他图片的位置

srcstring

图片的 URL

widthint32

图片宽度（像素）

heightint32

图片高度（像素）

altstring

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

created_atstring

图片创建时间

updated_atstring

图片最后更新时间

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "image": {
      "id": "string",
      "product_id": "string",
      "position": 0,
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}