Appearance
商品列表
请求路径
- 请求方式：
POST - 请求头：
Content-Type:application/json - 接口地址：
/Third/Goods/goodsList - 频率限制：
10秒100次
请求参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| currentPage | 是 | string | 当前页：分页情况下是必填参数 |
| pageSize | 是 | string | 每页记录数，默认为10 |
| app_id | 否 | string | 频道ID |
| gid | 否 | string | 查询商品详情时使用商品ID |
| opt | 否 | string | 返回数据是否分页控制 all：不分页 |
| name | 否 | string | 搜索的商品名称 |
| category_id | 否 | string | 商品分组id |
| type | 否 | string | 商品类型：goods-实物商品，virtual-虚拟商品 |
| sale_status | 否 | string | 开售状态：0-全部，1-未开售，2-销售中 |
| goods_ids | 否 | string | 商品ID，多个用逗号分隔，用于批量查询指定商品 |
| update_time_start | 否 | integer | 更新时间-（开始时间戳） |
| update_time_end | 否 | integer | 更新时间-（结束时间戳） |
请求示例
基础查询示例
{
"uid": "123456",
"app_id": "789",
"currentPage": "1",
"pageSize": "10"
}批量查询指定商品示例
{
"uid": "123456",
"goods_ids": "12345,12346,12347",
"currentPage": "1",
"pageSize": "10"
}响应参数
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| code | 是 | int | 响应状态码：200-成功，400-失败 |
| msg | 是 | string | 响应消息 |
| data | 是 | object | 响应数据 |
data 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| list | 是 | array | 商品列表 |
| total | 是 | string | 总记录数 |
| currentPage | 是 | int | 当前页码 |
| pageSize | 是 | int | 每页记录数 |
list 商品项参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | string | 商品ID |
| name | 是 | string | 商品名称 |
| price | 是 | string | 商品价格 |
| type | 是 | string | 商品类型：goods-实物商品，virtual-虚拟商品 |
| status | 是 | string | 商品状态：1正常，2已下架 |
| status_info | 是 | string | 商品状态描述 |
| unit | 是 | string | 商品单位 |
| stock | 是 | string/int | 商品库存 |
| pics | 是 | string | 商品图片（JSON字符串） |
| picArr | 是 | array | 商品图片数组 |
| desc | 是 | string | 商品描述 |
| create_time | 是 | string | 创建时间 |
| is_sku | 是 | int | 是否有SKU：1-有，2-无 |
| attrGroup | 是 | array | 商品属性组（有SKU时返回） |
| skuGroup | 是 | object | SKU组信息（有SKU时返回） |
| sku_list | 是 | array | SKU列表（有SKU时返回） |
| goods_encode | 是 | string | 商品/货品编码 |
| goods_specs_encode | 是 | string | 商家编码 |
| linkType | 是 | string | 链接类型 |
| link | 是 | string | 链接地址 |
| num | 是 | string | 商品数量 |
| lotterySwitch | 是 | string | 抽奖开关 |
| recommend | 是 | int | 是否推荐 |
| is_to_store_discount | 是 | string | 是否到店折扣 |
| to_store_discount_content | 是 | string | 到店折扣内容 |
| is_display_stock | 是 | string | 是否显示库存 |
| app_id | 是 | string | 应用ID |
| goods_type_info | 是 | object | 商品类型信息 |
| postage | 是 | string | 邮费 |
| sk_sta | 是 | string | 秒杀状态 |
| st | 是 | string | 开始时间 |
| et | 是 | string | 结束时间 |
| sp | 是 | int | 特殊标识 |
| seckill_sta | 是 | string | 秒杀状态 |
| num_limit_kill | 是 | string | 限购数量 |
| is_limit_buy | 是 | string | 是否限购 |
| num_limit_buy | 是 | string | 限购数量 |
| sort_sn | 是 | string | 排序号 |
| storage | 是 | string/int | 库存 |
| underlined_price | 是 | string | 划线价格 |
| is_coupon_type | 是 | string | 优惠券类型 |
| coupon_id | 是 | string | 优惠券ID |
| category_id | 是 | int | 分类ID |
| sale_type | 是 | string | 销售类型 |
| sale_time | 是 | string | 销售时间 |
| sale_status | 是 | int | 销售状态 |
| sale_status_info | 是 | string | 销售状态描述 |
| enable_copy | 是 | boolean | 是否允许复制 |
| bind_type | 是 | int | 绑定类型 |
attrGroup 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| attr_name | 是 | string | 属性名称 |
| attr_val | 是 | array | 属性值列表 |
attr_val 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | string | 属性值ID |
| txt | 是 | string | 属性值文本 |
skuGroup 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | string | SKU组ID |
| goods_id | 是 | string | 商品ID |
| content | 是 | string | SKU内容（JSON字符串） |
sku_list 参数结构
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| id | 是 | string | SKU ID |
| goods_id | 是 | string | 商品ID |
| sku_true_price | 是 | string | SKU价格 |
| sku_stock | 是 | string | SKU库存 |
| sku_encode | 是 | string | SKU编码 |
| goods_attribute_ids | 是 | string | 商品属性ID组合（逗号分隔） |
| goods_attribute_value | 是 | string | 商品属性值（JSON字符串） |
| default_sku | 是 | string | 是否默认SKU：1-是，2-否 |
响应示例
json
{
"code": 200,
"msg": "success",
"data": {
"list": [
{
"applet_buy_conf": null,
"goods_encode": "GOODS001",
"goods_specs_encode": "GOODS000001",
"status": "1",
"status_info": "已上架",
"push_app_nick": null,
"id": "12345",
"name": "示例商品A",
"price": "99.00~199.00",
"linkType": "local",
"link": "",
"num": "0",
"type": "goods",
"lotterySwitch": "0",
"unit": "件",
"recommend": 0,
"desc": "<p>这是一个示例商品描述</p>",
"is_to_store_discount": "2",
"to_store_discount_content": "",
"is_display_stock": "1",
"pics": "[{\"path\":\"https://example.com/images/goods/12345.jpg\"}]",
"picArr": [
"https://example.com/images/goods/12345.jpg"
],
"app_id": "0",
"goods_type_info": null,
"postage": "0.00",
"sk_sta": "1",
"st": "",
"et": "",
"sp": 0,
"stock": 1000,
"seckill_sta": "1",
"num_limit_kill": "0",
"is_limit_buy": "2",
"create_time": "2024-01-01 10:00:00",
"num_limit_buy": "1",
"sort_sn": "1",
"is_sku": 1,
"attrGroup": [
{
"attr_name": "规格",
"attr_val": [
{
"id": "1001",
"txt": "小号"
},
{
"id": "1002",
"txt": "中号"
}
]
},
{
"attr_name": "颜色",
"attr_val": [
{
"id": "2001",
"txt": "红色"
},
{
"id": "2002",
"txt": "蓝色"
}
]
}
],
"skuGroup": {
"id": "500",
"goods_id": "12345",
"content": "[{\"id\":\"5001\",\"v1_t\":\"规格\",\"v1\":\"小号\",\"v1_id\":0,\"v1_tid\":0,\"key\":\"0-0_1-0_\",\"v2_t\":\"颜色\",\"v2\":\"红色\",\"v2_id\":0,\"v2_tid\":1,\"price\":\"99.00\",\"stock\":\"100\",\"sellNum\":0,\"default_sku\":2},{\"id\":\"5002\",\"v1_t\":\"规格\",\"v1\":\"小号\",\"v1_id\":0,\"v1_tid\":0,\"key\":\"0-0_1-1_\",\"v2_t\":\"颜色\",\"v2\":\"蓝色\",\"v2_id\":1,\"v2_tid\":1,\"price\":\"99.00\",\"stock\":\"100\",\"sellNum\":0,\"default_sku\":2},{\"id\":\"5003\",\"v1_t\":\"规格\",\"v1\":\"中号\",\"v1_id\":1,\"v1_tid\":0,\"key\":\"0-1_1-0_\",\"v2_t\":\"颜色\",\"v2\":\"红色\",\"v2_id\":0,\"v2_tid\":1,\"price\":\"199.00\",\"stock\":\"200\",\"sellNum\":0,\"default_sku\":2},{\"id\":\"5004\",\"v1_t\":\"规格\",\"v1\":\"中号\",\"v1_id\":1,\"v1_tid\":0,\"key\":\"0-1_1-1_\",\"v2_t\":\"颜色\",\"v2\":\"蓝色\",\"v2_id\":1,\"v2_tid\":1,\"price\":\"199.00\",\"stock\":\"200\",\"sellNum\":0,\"default_sku\":2}]"
},
"sku_list": [
{
"id": "5001",
"goods_id": "12345",
"sku_true_price": "99.00",
"sku_stock": "100",
"sku_encode": "SKU001",
"goods_attribute_ids": "1001,2001",
"goods_attribute_value": "[{\"id\":\"1001\",\"name\":\"规格\",\"val\":\"小号\"},{\"id\":\"2001\",\"name\":\"颜色\",\"val\":\"红色\"}]",
"default_sku": "2"
},
{
"id": "5002",
"goods_id": "12345",
"sku_true_price": "99.00",
"sku_stock": "100",
"sku_encode": "SKU002",
"goods_attribute_ids": "1001,2002",
"goods_attribute_value": "[{\"id\":\"1001\",\"name\":\"规格\",\"val\":\"小号\"},{\"id\":\"2002\",\"name\":\"颜色\",\"val\":\"蓝色\"}]",
"default_sku": "2"
},
{
"id": "5003",
"goods_id": "12345",
"sku_true_price": "199.00",
"sku_stock": "200",
"sku_encode": "SKU003",
"goods_attribute_ids": "1002,2001",
"goods_attribute_value": "[{\"id\":\"1002\",\"name\":\"规格\",\"val\":\"中号\"},{\"id\":\"2001\",\"name\":\"颜色\",\"val\":\"红色\"}]",
"default_sku": "2"
},
{
"id": "5004",
"goods_id": "12345",
"sku_true_price": "199.00",
"sku_stock": "200",
"sku_encode": "SKU004",
"goods_attribute_ids": "1002,2002",
"goods_attribute_value": "[{\"id\":\"1002\",\"name\":\"规格\",\"val\":\"中号\"},{\"id\":\"2002\",\"name\":\"颜色\",\"val\":\"蓝色\"}]",
"default_sku": "2"
}
],
"storage": 1000,
"underlined_price": "0.00",
"is_coupon_type": "2",
"coupon_id": "0",
"category_id": 0,
"sale_type": "1",
"sale_time": "0",
"sale_status": 2,
"sale_status_info": "售卖中",
"enable_copy": true,
"bind_type": 0
},
{
"applet_buy_conf": null,
"goods_encode": "GOODS002",
"goods_specs_encode": "GOODS000002",
"status": "1",
"status_info": "已上架",
"push_app_nick": null,
"id": "12346",
"name": "示例商品B",
"price": "59.00",
"linkType": "local",
"link": "",
"num": "0",
"type": "virtual",
"lotterySwitch": "0",
"unit": "个",
"recommend": 0,
"desc": "<p>这是一个虚拟商品示例</p>",
"is_to_store_discount": "2",
"to_store_discount_content": "",
"is_display_stock": "1",
"pics": "[{\"path\":\"https://example.com/images/goods/12346.jpg\"}]",
"picArr": [
"https://example.com/images/goods/12346.jpg"
],
"app_id": "0",
"goods_type_info": null,
"postage": "0.00",
"sk_sta": "1",
"st": "",
"et": "",
"sp": 0,
"stock": "500",
"seckill_sta": "1",
"num_limit_kill": "0",
"is_limit_buy": "2",
"create_time": "2024-01-01 11:00:00",
"num_limit_buy": "1",
"sort_sn": "2",
"attrGroup": [],
"skuGroup": [],
"sku_list": [],
"is_sku": 2,
"storage": "500",
"underlined_price": "0.00",
"is_coupon_type": "2",
"coupon_id": "0",
"category_id": 0,
"sale_type": "2",
"sale_time": "1735689600",
"sale_time_date": "2024-01-01 12:00:00",
"sale_status": 2,
"sale_status_info": "售卖中",
"enable_copy": true,
"bind_type": 0
}
],
"total": "2",
"currentPage": 1,
"pageSize": 10
}
}