跳转到主要内容
POST
编辑商品
按字段部分更新商品,未传字段保持不变。编辑生效中商品会生成新版本并返回新版本 ID;不支持修改状态(请使用变更商品状态接口)。features 为整表替换:传入时未包含的已有权益会被删除,并同步从该商品下所有定价移除;不传则权益不变。merchant_product_id 不可置空,修改后不会同步到已创建的定价。无法通过本接口清空全部权益;同一请求内权益 id 不可重复。

授权

Authorization
string
header
必填

Bearer API Key 鉴权。格式:Authorization: Bearer {your_api_key}

请求头

Request-Id
string
默认值:008e3967-a1b5-48bb-be14-d5bff5092e61
必填

请求的唯一标识符

路径参数

product_id
string
必填

Subotiz 平台商品 ID

请求体

application/json

编辑商品请求(按字段部分更新:未传的字段保持不变)

product_id
string
必填

Subotiz 平台商品 ID

product_name
string

商品名称,传入时不可为空

category_id
string

商品分类 ID

image_url
string

商品图片 URL,传入时不可为空

merchant_product_id
string

商户侧商品 ID,同商户内唯一;不可传空串(不支持通过本接口清空)。修改后不会同步到已创建的定价

description
string

商品描述

features
object[]

商品权益列表,整表替换:

  • 传入时,未包含的已有权益会被删除,并同步从该商品下所有定价移除
  • 不传(或传空列表)时权益保持不变,因此无法通过本接口清空全部权益
  • 保留已有权益需带上其 id;不带 id 视为新增;同一请求内 id 不可重复
quantity_unit
string

数量单位名称(商品级);传空串重置为默认 unit

响应

200 - application/json

OK

编辑商品响应

code
string

error code

message
string

error message

data
object

编辑商品响应