商品列表基础版
POST
/ark/open_api/v3/common_controller错误码 | 错误码描述 | |
---|---|---|
-4002005 | 接口报错 |
请求参数
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
总商品数
hits
array [object {14}]
商品基础信息列表
itemId
string
商品编号
name
string
商品名
splId
string
spl编号
spvId
string
spv编号
spuId
string
spu编号
price
integer
商品售价
skucode
string
小红书编码
buyable
boolean
是否可售卖
barcode
string
可选
条形码,只能输入“字母 数字 / -” (创建商品时手动填入,首选upc码,但不介意商家使用自定义商品编码)
stock
integer
商品可售普通库存数
status
integer
审核状态(已弃用)
freeze
boolean
可选
是否被冻结 true为已冻结,false为未冻结
createTime
integer
创建时间
updateTime
integer
更新时间
示例
{
"currentPage": 1,
"pageSize": 50,
"total": 500,
"hits": [
{
"itemId": "607***450",
"name": "607***450",
"splId": "58e***450",
"spvId": "15e***450",
"spuId": "587***450",
"price": 100,
"skucode": "690***466",
"buyable": true,
"barcode": "690***452",
"stock": 1000,
"status": 1,
"freeze": true,
"createTime": 1612518379,
"updateTime": 1612518379
}
]
}
最后修改时间: 2 年前