查询商品列表
`POST` `https://qw-openapi-tx.dustess.com/java-data-exchange-srv/api/goods/v1/get-list`
Content-Type: application/json
字段 | 类型 | 描述 | 是否必须 |
---|---|---|---|
accessToken | String | Token认证信息 | true |
参数名称 | 类型 | 说明 | 是否必须 |
---|---|---|---|
categoryName | String | 分类名称 | false |
codeList | String[] | 商品编码列表 | false |
limitSize | Int | 分页查询限制条数(默认10,最大100) | false |
name | String | 商品名称 | false |
nextPageBeginNumber | String | 下一页数据查询起始编码(对应商品或订单ID) | false |
{
"categoryName": "",
"codeList": ["7b1eecbed04f42e38ee0dca627e7540a"],
"limitSize": 1,
"name": "",
"nextPageBeginNumber": ""
}
{
"code": 500200,
"msg": "成功",
"data": [
{
"name": "白色毛衣",
"remark": "商品描述",
"goodsId": "4de5f278-1111-1111-1111-ae15ff93a830",
"type": 1,
"status": 2,
"totalInventory": 223,
"categoryId": "07d50c82-1111-1111-1111-42881b0def92/07d53021-652e-11eb-86ad-42881b0def92",
"categoryName": "衣服/毛衣",
"code": "7b1eecbed04f42e38ee0dca627e7540a",
"unit": "白色毛衣",
"marketPrice": "10.01",
"price": "20.00",
"resource": {
"detailImageList": [
{
"name": "",
"url": "www.1612268087922.com"
}
],
"imageList": [
{
"name": "",
"url": "www.1612268087922.com"
}
],
"detailVideoCoverList": [
"www.1612268087922.com"
],
"detailVideoList": [
{
"name": "",
"second": 0,
"size": 0,
"url": "www.1612268087922.com"
}
]
}
}
],
"logMessageId": "ae8b98530bfd4664b06bb3b90f71ef86",
"success": true
}
响应参数名 | 类型 | 说明 |
---|---|---|
success | Bool | 请求状态, true: 成功; false: 失败 |
code | Int | 响应代码 |
msg | String | 消息提示 |
data | Object[] | 数据信息 |
logMessageId | String | 调用链日志id |
data
字段类型说明参数名称 | 类型 | 描述 |
---|---|---|
categoryId | String | 分类ID 层级以“/”分割 一级分类ID/二级分类ID/三级分类ID |
categoryName | String | 分类名称 层级以“/”分割 一级分类/二级分类/三级分类 |
code | String | 商品编码(全局非空不重复) |
goodsId | String | 商品ID |
marketPrice | String | 市场价格(单位:元)(单位:元) 输入199元,商品详情页面划线展示“市场价199元” |
name | String | 商品名称 |
remark | String | 商品描述 |
price | String | 售价(单位:元)sku里面的最低价格 |
resource | Object | 资源 |
resource.detailImageList | Object[] | 详情图 |
resource.detailImageList.name | String | 图片名称 |
resource.detailImageList.url | String | 图片地址 |
resource.detailVideoCoverList | String[] | 详情视频封面 |
resource.detailVideoList | Object[] | 详情视频 |
resource.detailVideoList.name | String | 视频名称 |
resource.detailVideoList.second | Float | 视频长度,单位:秒 |
resource.detailVideoList.size | Float | 视频大小,单位:字节 |
resource.detailVideoList.url | String | 视频地址 |
resource.imageList | Object[] | 头图图片 |
resource.imageList.name | String | 图片名称 |
resource.imageList.url | String | 图片地址 |
status | Int | 商品状态(1:上架,2:下架) |
totalInventory | Float | 商品总库存数量 |
type | Int | 商品类型 1:普通商品,2:虚拟商品 |
customeField | String | 自定义字段 |
unit | String | 商品单位:[件] |
state | Int | 商品删除标识,1=正常商品,2=已删除商品 |
修改于 2024-09-20 10:30:51