只改标题、封面和 fields，fields 会整份替换，不能改价格

PATCH/api/v1/catalogs/{id}/products/{product_id}

认证	请求头 Authorization: Bearer <访问令牌>，访问令牌用设备码换取，不要向用户要密码、短信验证码或 API Key
权限	商家，需要 product:write 才能修改商品、图片或店铺介绍

路径参数

path

idstring必填

商品 ID

product_idstring必填

商品 ID

路径示例

/api/v1/catalogs/prd_example/products/prd_example

请求体

application/json

出现的 fields 会整份替换，不能改价格

titlestring

新标题

coverstring | null

新封面

fieldsobject

整份替换已保存属性，省略的 key 会被去掉

请求示例

{
  "title": "示例",
  "cover": null,
  "fields": {}
}

响应

200

application/json

成功时 code 为 200，资源在 data

idstring必填

商品 ID，以 prd_ 开头

catalog_idstring必填

目录 ID

titlestring必填

商品名称

statusenum<string>必填

上架状态

可选值: onoff

coverstring | null必填

封面地址

fieldsobject必填

目录字段值

schema_revisioninteger必填

字段定义版本

created_atstring必填

创建时间，ISO-8601

updated_atstring必填

更新时间，ISO-8601

deleted_atstring | null必填

软删除时间，未删除时为 null

axes[].idstring必填

规格轴 ID

axes[].keystring必填

规格轴 key

axes[].labelstring必填

规格轴名称

axes[].positioninteger必填

规格轴顺序

variants[].idstring必填

规格 ID

variants[].skustring | null必填

SKU

variants[].option_valuesobject必填

规格轴取值

variants[].priceinteger必填

整数分

variants[].stockinteger | null必填

库存，null 表示不限

variants[].statusenum<string>必填

是否可售

可选值: onoff

variants[].coverstring | null必填

规格封面

variants[].deletedboolean必填

是否已软删除

响应示例

{
  "id": "prd_example",
  "catalog_id": "cat_example",
  "title": "示例",
  "status": "on",
  "cover": "string",
  "fields": {},
  "schema_revision": 1,
  "created_at": "2026-05-16T00:00:00.000Z",
  "updated_at": "2026-05-16T00:00:00.000Z",
  "deleted_at": "2026-05-16T00:00:00.000Z",
  "axes": [
    {
      "id": "id_example",
      "key": "weight_g",
      "label": "示例",
      "position": 1
    }
  ],
  "variants": [
    {
      "id": "var_example",
      "sku": "string",
      "option_values": {},
      "price": 159900,
      "stock": null,
      "status": "on",
      "cover": "string",
      "deleted": true
    }
  ]
}