商品列表完整版(新)
POST
/ark/open_api/v3/common_controller请求参数
Body 参数application/json
id
string
必需
商品编号,使用id查询其他条件可以不填
createTimeFrom
integer
必需
商品创建时间开始时间,Unix-Time时间戳
createTimeTo
integer
必需
商品创建时间结束时间,Unix-Time时间戳
updateTimeFrom
integer
必需
商品更新时间开始时间,Unix-Time时间戳
updateTimeTo
integer
必需
商品更新时间结束时间,Unix-Time时间戳
buyable
boolean
是否在架上
stockGte
integer
库存大于等于某数
stockLte
integer
库存小于等于某数
pageNo
integer
必需
返回页码 默认 1,页码从 1 开始 PS:当前采用分页返回,数量和页数会一起传,如果不传,则采用 默认值
pageSize
integer
必需
返回数量,默认50最大100
barcode
string
商品条码
skucode
string
小红书编码
freeze
boolean
必需
是否被冻结 true为已冻结,false为未冻结
singlePackOnly
boolean
必需
只返回单品类型的商品
lastId
string
必需
查询起始商品id,全店商品时间倒序
isChannel
boolean
必需
不传返回全部,传true只返回渠道商品,传false只返回非渠道商品
示例
{
"id": "607***450",
"createTimeFrom": 1612518379000,
"createTimeTo": 1612518379000,
"updateTimeFrom": 1612518379000,
"updateTimeTo": 1612518379000,
"buyable": true,
"stockGte": 10,
"stockLte": 100,
"pageNo": 1,
"pageSize": 50,
"barcode": "690***466",
"skucode": "690***772",
"freeze": true,
"singlePackOnly": true,
"lastId": "61694f367133c30009f8a76d",
"isChannel": true
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
currentPage
integer
当前返回页
pageSize
integer
查询总数
total
integer
总商品数
data
array [object {2}]
商品详情列表
spuData
object
可选
itemData
object
item信息
示例
{
"data": [
{
"item": {
"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": ""
},
"sku": {
"itemId": "64ff12f***fd12f1",
"ipq": 100,
"originalPrice": 88,
"price": 80,
"stock": 5000,
"logisticsPlanId": "5e37***a9f0",
"whcode": "C01",
"priceType": 1,
"erpCode": "001231",
"variants": [
{
"id": "5a60***9ce6",
"name": "尺码",
"value": "36",
"valueId": "f423***921f"
}
],
"deliveryTime": {
"time": "2021/06/01",
"type": "ABSOLUTE_TIME"
},
"specImage": "http://img.xiaohongshu.com/items/123456789",
"barcode": "RedTest20200507001",
"rowNumber": "",
"id": "6123**5132",
"scSkucode": "XHSd12f1r1f",
"logisticsName": "red_auto",
"buyable": true,
"unionItemDetails": [
{
"id": "607***450",
"name": "口红",
"scSkuCode": "690***466",
"barcode": "690***452",
"ipq": 100,
"erpCode": "dq123da"
}
],
"createTime": "",
"updateTime": "",
"name": "",
"isGift": true
}
}
],
"pageNO": "",
"pageSize": "",
"total": ""
}
最后修改时间: 2 年前