1.商品列表
接口
POST https://open.jisuapp.cn/business/Shop/goodsList/
请求参数说明
Content-Type: application/x-www-form-urlencoded
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | String | Y | 用户授权的唯一票据 |
page | int | N | 页码 |
page_size | int | N | 每页数量,默认10 |
idx_arr | array | N | 分类或标题 |
data_ids | array | N | 商品id数组 |
sort_key | int | N | 排序key |
sort_direction | int | N | 排序方向 |
is_integral | int | N | 0不考虑积分商品 1只显示积分优惠 2不显示积分商品 3只显示积分兑换 4显示积分商品 5显示非积分兑换商品 |
only_display_common | int | N | 是否过滤掉不能参加营销活动的商品 1是 0否 |
filter_vip_goods | int | N | 如果使用only_display_common该参数过滤了营销工具又需要特别显示出会员价商品,则传1 |
least_price | int | N | 最低价格 |
most_price | int | N | 最高价格 |
least_view | int | N | 最低浏览量 |
most_view | int | N | 最高浏览量 |
start_time | int | N | 变更时间-开始 |
end_time | int | N | 变更时间-结束 |
least_stock | int | N | 最低库存 |
most_stock | int | N | 最高库存 |
least_sales | int | N | 最低销量 |
most_sales | int | N | 最高销量 |
type | int | N | 0实体商品,1虚拟商品 |
status | int | N | 0全部,1出售中,2仓库中,3售罄 |
pick_up_type | array | N | 1->快递,2->同城,3->上门自提,4->点餐 |
goods_code | string | N | 商品码/套餐码 |
show_package_goods | int | N | 默认为0,1->只显示套餐商品,2->显示全部(单商品+套餐),其它->过滤掉套餐商品 |
only_pick_up_type | array | N | 准确筛选出必须包含的配送方式 |
package_goods_id | int | N | 自动屏蔽该套餐id下已添加的单商品(多规格无法屏蔽) |
参数详情说明
idx_arr 可以用来搜索 分类或者商品名字
其中搜索分类
'idx_arr' => array(
"idx" => 'category',
'idx_value' => $category_id // 分类1的id
),
搜索商品名字
'idx_arr' => array(
"idx" => 'title',
'idx_value' => $search //商品名字
),
data_ids 用于获取指定的商品id集合对应的商品信息
如
'data_ids' => [$goods_id1,$goods_id2], //其中$goods_id为商品id
is_seckill 是否参加秒杀 1-是 2-不是
这两个互斥
is_group_buy 会去掉已经参加秒杀的商品 但会返回 所有的未参加秒杀的商品 不区分是否参加拼团
is_seckill 会去掉拼团的商品 且当is_seckill=2时 只取出未参加秒杀且没有参加拼团的商品
当两个都不传的时候 就是取所有的商品
is_group_buy=0 + is_seckill=2 查询未参加活动的商品
only_pick_up_type 传参示例(筛选出必须包含快递&同城配送的商品)
only_pick_up_type[0]:1
only_pick_up_type[1]:2
返回参数
参数 | 类型 | 说明 |
---|---|---|
form_data | array | 商品信息 |
form_data.description | string | 商品描述 |
form_data.type | int | 0实体商品,1虚拟商品 |
form_data.delivery_id | int | |
form_data.region_id | int | 区域id |
form_data.id | int | 商品id |
form_data.app_id | string | 小程序id |
form_data.title | string | 商品名字 |
form_data.cover | string | 商品封面 |
form_data.price | decimal(2) | 商品价格 单位元 |
form_data.sale_price | decimal(2) | 促销价 单位元 |
form_data.sales | int | 商品销售 |
form_data.is_recommend | int | 是否推荐 |
form_data.stock | int | 商品库存 |
form_data.weight | int | 商品排序权重 越大排序越前 |
form_data.goods_type | int | 商品类型 |
form_data.max_can_use_integral | int | 最大使用积分 |
form_data.integral | int | 积分 -1 表示该商品不是积分商品 0~1表示积分优惠 2表示积分兑换 |
form_data.mass | string | 商品重量 |
form_data.volume | string | 商品体积 |
form_data.express_rule_id | int | 运费模板的id |
form_data.is_seckill | int | 是否秒杀 1-是 2-不是 |
form_data.seckill_status | int | 秒杀开启状态 1-开启 2-不开启 默认不开启 |
form_data.virtual_price | string | 商品虚拟价格 |
form_data.add_time | int | 商品添加时间 |
form_data.update_time | string | 商品修改时间 |
form_data.viewed_count | string | 浏览数 |
form_data.sell_time | string | 定时上架时间(如果status为1,但是当前时间大于该时间并且该时间存在,则视为上架) |
form_data.status | string | 是否上架 0上架 1下架 |
form_data.server_time | int | |
form_data.is_group_buy | string | 是否拼团 1已经参加拼团 0未拼团 |
form_data.model | array | 商品规格集合 |
form_data.goods_model | array | 商品规格集合详情 |
form_data.category | array | 商品二级分类名字集合 |
form_data.category_id | array | 商品二级分类id集合 |
form_data.model.id | int | 商品规格类型id |
form_data.model.name | int | 商品规格类型名字 |
form_data.model.subModelName | int | 商品规格类型 下面分类名字集合 |
form_data.model.subModelId | int | 商品规格类型 下面分类id集合 |
form_data.goods_model.id | int | 商品规格id |
form_data.goods_model.goods_id | int | 商品id |
form_data.goods_model.model | string | 规格组合 |
form_data.goods_model.price | decimal(2) | 规格价格 |
form_data.goods_model.stock | int | 库存 |
form_data.goods_model.commodity_code | string | 扫码购编码 |
form_data.goods_model.add_time | int | 创建时间 |
form_data.goods_model.sales | int | 销量 |
form_data.goods_model.seckill_stock | int | 秒杀库存 |
form_data.goods_model.seckill_price | decimal(2) | 秒杀价格 |
form_data.goods_model.seckill_sales | int | 秒杀销量 |
form_data.goods_model.img_url | string | 规格图片链接 |
form_data.goods_model.virtual_price | decimal(2) | 商品虚拟价格 |
form_data.goods_model.no_discount | int | (是否)秒杀无折扣 |
form_data.goods_express_data.express_fee | decimal(2) | 快递费 |
form_data.goods_express_data.express_fee_sort | array | 快递费集合 |
form_data.code | string | 商品检索码 |
form_data.scan_code | string | 扫码购编码(单个设置) |
form_data.pick_up_type | array | 配送方式 1快递 2同城 3上门自提 4点餐 |
form_data.box_fee | decimal(2) | 餐盒费 |
form_data.corner_mark | int | 是否开启商品角标模式 0否 1新品 2HOT 3NEW 4爆款 5自定义 |
form_data.corner_position | int | 角标样式位置 0商品图片 1商品标题 |
form_data.corner_url | string | 角标图片地址 |
form_data.package | array | 套餐商品详情 |
form_data.receipt_group_id | array | 打印分组id集合 |
form_data.attributes | array | 单商品属性详情 |
参数返回示例
{
"status": 0,
"data": [
{
"form_data": {
"description": "dfx",
"model": {
"7": {
"id": "7",
"name": "尺寸",
"subModelName": [
"s",
"m",
"ss",
"sm"
],
"subModelId": [
"33",
"34",
"35",
"36"
]
}
},
"type": 0,
"delivery_id": "0",
"region_id": "",
"id": "11138",
"app_id": "y99I4IxB94",
"title": "我是测试 1-1+2",
"cover": "http://img.zhichiwangluo.com/zcimgdir/album/file_5ae98d64cf70d.png",
"price": "1.00",
"sale_price": "0.00",
"category": [
"cesh_111/ceshi_1_1",
"cesh_111/ceshi_1_2"
],
"sales": "0",
"is_recommend": "0",
"stock": "10",
"weight": "0",
"goods_type": "0",
"max_can_use_integral": "0",
"integral": "-1",
"mass": "1.000",
"volume": "1.000",
"express_rule_id": "0",
"is_seckill": "2",
"seckill_status": "2",
"virtual_price": "0.00",
"add_time": "1528194075",
"update_time": "2018.06.05",
"viewed_count": "0",
"sell_time": "0",
"status": 0,
"category_id": [
"4659",
"4660"
],
"server_time": 1530005592,
"goods_model": [
{
"id": "14321",
"goods_id": "11138",
"model": "33",
"price": "1.00",
"stock": "1",
"commodity_code": null,
"add_time": "1528194075",
"sales": "0",
"seckill_stock": "0",
"seckill_price": "0.00",
"seckill_sales": "0",
"img_url": "http://img.zhichiwangluo.com/zcimgdir/album/file_5ae98d64cf70d.png",
"virtual_price": "1.00",
"no_discount": "0"
},
{
"id": "14322",
"goods_id": "11138",
"model": "34",
"price": "2.00",
"stock": "2",
"commodity_code": null,
"add_time": "1528194075",
"sales": "0",
"seckill_stock": "0",
"seckill_price": "0.00",
"seckill_sales": "0",
"img_url": "http://img.zhichiwangluo.com/zcimgdir/album/file_5ae98d64cf70d.png",
"virtual_price": "2.00",
"no_discount": "0"
},
{
"id": "14323",
"goods_id": "11138",
"model": "35",
"price": "3.00",
"stock": "3",
"commodity_code": null,
"add_time": "1528194075",
"sales": "0",
"seckill_stock": "0",
"seckill_price": "0.00",
"seckill_sales": "0",
"img_url": "http://img.zhichiwangluo.com/zcimgdir/album/file_5adda075a34e8.jpg",
"virtual_price": "3.00",
"no_discount": "0"
},
{
"id": "14324",
"goods_id": "11138",
"model": "36",
"price": "4.00",
"stock": "4",
"commodity_code": null,
"add_time": "1528194075",
"sales": "0",
"seckill_stock": "0",
"seckill_price": "0.00",
"seckill_sales": "0",
"img_url": "http://img.zhichiwangluo.com/zcimgdir/album/file_5adda075a34e8.jpg",
"virtual_price": "4.00",
"no_discount": "0"
}
],
"is_group_buy": 0
}
}
],
"is_more": 0,
"current_page": 1,
"count": "6",
"total_page": 1
}