更新TEM - 小红书 API

curl --location --request POST 'https://ark.xiaohongshu.com/ark/open_api/v3/common_controller' \ --header 'Content-Type: application/json;charset=utf-8' \ --data-raw '{ "name": "spu标题", "ename": "spuEName", "shortName": "spu短标题，不得超过30的长度，其中中文字符占两个长度", "brandId": "52dd****7d4b", "categoryId": "5a31****9df5", "attributes": [ { "propertyId": "5845****325e", "name": "测试属性名01", "valueId": "test", "value": "test", "valueList": [ { "valueId": "test", "value": "test" } ] } ], "shippingTemplateId": "null", "shippingGrossWeight": 100, "variantIds": [ "string" ], "imageUrls": [ "string" ], "videoUrl": "", "articleNo": "", "imageDescUrls": [ "string" ], "transparentImageUrl": "", "desc": "", "faqs": [ { "question": "", "answer": "" } ], "deliveryMode": "", "id": "spu标题", "updatedFields": [ "string" ] }'

{ "name": "item标题", "ename": "itemEName", "brandId": "", "categoryId": "5a31****9df5", "attributes": [ { "propertyId": "5845****325e", "name": "测试属性名01", "value": "test", "valueId": "test", "valueList": [ { "valueId": "test", "value": "test" } ] } ], "shippingTemplateId": "null", "shippingGrossWeight": 100, "variantIds": [ "string" ], "images": [ "string" ], "videoUrl": "", "articleNo": "", "imageDescriptions": [ "string" ], "transparentImage": "", "description": "", "faq": [ { "question": "", "answer": "" } ], "isChannel": "", "deliveryMode": "", "freeReturn": "", "id": "64******412f1f", "createTime": "", "updateTime": "" }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

name

string

item标题

必需

ename

string

item英文名

可选

brandId

string

必需

品牌ID,目前查询品牌返回均为String但是是数字可以强转成Long使用

categoryId

string

末级商品类目ID

必需

attributes

array [object {5}]

item属性

必需

propertyId

string

属性ID

必需

name

string

属性名

必需

valueId

string

可选

属性值ID，单选属性时必填

value

string

可选

属性值，单选属性使用

valueList

array [object {2}]

可选

属性值列表，多选属性填入列表

shippingTemplateId

string

运费模板ID

必需

shippingGrossWeight

integer

必需

商品物流重量（克），当运费模版选择按重量计费时，该值必须大于0

variantIds

array[string]

必需

item下商品规格列表

imageUrls

array[string]

商品主图(必传)

必需

videoUrl

string

主图视频

必需

articleNo

string

商品货号

必需

imageDescUrls

array[string]

图文描述

可选

transparentImageUrl

string

透明图

可选

description

string

商品描述

可选

faq

array [object {2}]

常见的问题

可选

question

string

必需

answer

string

必需

deliveryMode

string

可选

物流模式,0：普通，1：支持无物流发货（限定类目支持，不支持的类目创建会报错）

freeReturn

string

可选

是否支持7天无理由,1：支持，2：不支持，不传会按照规则给默认值，必须支持则支持，不必须则不支持

string

商品id

可选

updatedFields

string

可选

更新字段，不填默认全量，填入后只有传入的字段会被更新

示例

返回响应

🟢200成功

application/json

Body

name

string

item标题

必需

ename

string

item英文名

必需

brandId

string

品牌ID

必需

categoryId

string

末级商品类目ID

必需

attributes

array [object {5}]

spu属性

必需

propertyId

string

属性ID

可选

name

string

属性名

可选

valueId

string

可选

属性值ID，单选属性时必填

value

string

可选

属性值，单选属性使用

valueList

array [object {2}]

可选

属性值列表，多选属性填入列表

shippingTemplateId

string

运费模板ID

必需

shippingGrossWeight

integer

必需

商品物流重量（克），当运费模版选择按重量计费时，该值必须大于0

variantIds

array[string]

必需

spu下商品规格列表

imageUrls

array[string]

商品主图(必传)

必需

videoUrl

string

主图视频

必需

articleNo

string

商品货号

必需

imageDescUrls

array[string]

图文描述

必需

transparentImageUrl

string

透明图

必需

description

string

商品描述

必需

faqs

array [object {2}]

常见问题

必需

question

string

可选

answer

string

可选

isChannel

string

是否是渠道商品

必需

deliveryMode

string

必需

物流模式，0：普通，1：支持无物流发货（限定类目支持，不支持的类目创建会报错）

string

必需

itemId,创建时不填，删除更新必填

createTime

string

item创建时间

必需

updateTime

string

item更新时间

必需