6.分页查询商品信息 - globalsacnner/open-api GitHub Wiki
1. 说明
分页查询商品信息
2. 调用URI
/item/listItems
3. 请求方式
请求方式统一为POST,媒体类型application/json
4. 业务请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
deliverCode | String | 否 | 发货编码 |
page | int | 否 | 页码,默认1 |
pageSize | int | 否 | 分页大小,默认20,最大50 |
请求参数示例
{
"partner":"ggjtest",
"params":{
"deliverCode":"1545123397080"
},
"timestamp":"2019-01-19 15:39:00"
}
5. 响应结果
名称 | 父级 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
code | - | String | 是 | 1:成功 否则失败 |
message | - | String | 是 | 业务处理结果描述 |
data | - | Object | 否 | 成功时返回结果 |
--rows | data | array | 否 | 结果列表 |
--total | data | int | 否 | 列表数量 |
rows参数
名称 | 父级 | 类型 | 是否必须 | 描述 |
---|---|---|---|---|
deliverAreaId | data/rows | Long | 否 | 发货地id |
deliverAreaName | data/rows | String | 否 | 发货地名称 |
deliverCode | data/rows | String | 否 | 发货编码 |
itemCode | data/rows | String | 否 | 商品编码 |
skuCode | data/rows | String | 否 | sku编码 |
availableCount | data/rows | Integer | 否 | 可用库存 |
productName | data/rows | String | 否 | 商品名称 |
skuName | data/rows | String | 否 | sku名称 |
status | data/rows | Integer | 否 | 商品状态 0停用 1可用 |
costPrice | data/rows | Integer | 否 | 供货价 单位:分 |
注:itemCode和skuCode为系统自动生成的,一个itemCode会对应一个或多个skuCode,deliverCode为商家在创建商品时针对每个sku填写的。
响应成功参数示例
{
"code":"1",
"data":{
"rows":[
{
"deliverAreaId":100860,
"deliverAreaName":"深圳",
"deliverCode":"11AABVSA00121",
"itemCode":"CBS121",
"skuCode":"SKU121",
"availableCount":0,
"productName":"33333333322",
"skuName":"白色-大",
"status":1,
"costPrice":400
}
],
"total":1
},
"message":"操作成功"
}
失败响应示例
{
"code":"03000001",
"message":"参数校验异常"
}