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
}

results matching ""

    No results matching ""