创建ITEM - 小红书 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": "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": "" } ], "deliveryMode": "", "freeReturn": "" }'

{ "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

必需

timestamp

string

必需

接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp

appId

string

必需

第三方获取到的appid

sign

string

输入参数的签名结果

必需

version

string

必需

版本号，采用oauth2授权后均填入2.0

method

string

具体调用方法

必需

accessToken

string

可选

业务接口鉴权。非必须，调用商家业务接口必须使用

deliveryMode

string

可选

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

freeReturn

string

可选

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

示例

返回响应

🟢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更新时间

必需