Skip to content

商品展示排序

【station】修改点

/merchandise/category1/update 修改一级分类

接口名: /merchandise/category1/update
Method: POST
请求:
    id M string 一级分类ID
    name O string 一级分类名
    icon O string 图片ID
    rank O int 一级分类权重(新增)
响应:
    code M int 0为成功,其它为失败
    msg M string 错误提示信息
逻辑:
    判断rank值是否在范围内,rank的值范围是(1 - 10000);
    判断rank值合法后,修改一级分类信息

/merchandise/category1/get 获取一级分类信息

接口名: /merchandise/category1/get
Method: GET
请求:
    无
响应:
    code M int 0为成功,其它为失败
    msg M string 错误提示信息
    data M list 返回的分类信息
    [{
        'id' M string 分类ID
        'name' M string 分类名
        'icon' M int 图标ID
        'rank' O int 一级分类权重(新增)
    }]
逻辑:
    分类中,优先按序号(逆序)排列,无序号按一级分类ID排列;
    已设置rank值,存在rank值的要将rank值返回,未设置rank值的则不返回rank;
    返回一级分类信息列表

/merchandise/category2/update 更新二级分类

接口名: /merchandise/category2/update
Method: POST
请求:
    id M string 二级分类ID
    name O string 二级分类名
    rank O int 二级分类权重(新增)

响应:
    code M int 0为成功,其它为失败
    msg M string 错误提示信息
逻辑:
    判断rank值是否在范围内,rank的值范围是(1 - 10000);
    判断rank值合法后,修改一级分类信息

/merchandise/category2/get 获取二级分类信息

接口名: /merchandise/category2/get
Method: GET
请求:
    upstream_id O string 上游ID
响应:
    code M int 0为成功,其它为失败
    msg M string 错误提示信息
    data M list 返回的分类信息
    [{
        'id' M string 分类ID
        'name' M string 分类名
        'upstream_id' M string 一级分类ID
        'rank' O int 二级分类权重(新增)
    }]
逻辑:
    分类中,优先按序号逆序排列,无序号按二级分类ID排列;
    已设置rank值,存在rank值的要将rank值返回,未设置rank值的则不返回rank;
    返回二级分类信息列表

/merchandise/spu/update 更新spu

接口名: /merchandise/spu/update
Method: POST
请求:
    id M string spuID
    name O string spu名称
    desc O string spu描述
    p_type O int 类型(0:通用;1:私有)
    std_unit_name O string 基本单位
    image O string 图片名称
    dispatch_method O int 分拣方式(1: bagua;2: union)
    pinlei_id O string 品类ID
    category_id_2  O 二级分类ID
    alias O list 别名列表
    rank O int spu权重(新增)
响应:
    code M int 0为成功,其它为失败
    msg M string 错误提示信息
逻辑:
    判断rank值是否在范围内,rank的值范围是(1 - 10000);
    判断rank值合法后,修改一级分类信息

/merchandise/spu/list 获取spu列表

接口名: /merchandise/spu/list
Method: GET
请求:
    pinlei_id O string 品类ID
    category_id_2 O string 二级分类ID
    pinlei_id 和 category_id_2 必需二选一
    p_type O int spu类型(0:通用;1:私有)
响应:
    code M int 0为成功,其它为失败
    msg M string 错误提示信息
    data M list 返回的分类信息
    [{
        'id' M string spu ID
        'name' M string spu名
        'desc' M string 描述
        'p_type' M int spu类型
        'rank' O int spu权重(新增)
    }]
逻辑:
    按序号逆序排列,无序号按商品spuid正序排列;
    已设置rank值,存在rank值的要将rank值返回,未设置rank值的则不返回rank;
    返回spu信息列表

【bshop】修改点-后台修改

/product/category/get 获取商品分类

接口名: /product/category/get
Method: 
   GET
请求:
 salemenu_ids O list 销售单ID列表
响应:
 code M int 返回码 0为成功、其他为错误
 msg O string 出错信息提示
 data O list 成功时返回数据,json格式
 [{
    name M string 一级分类名
    id M string 一级分类ID
    rank O int 一级分类权重(新增)
    children M list 二级分类信息
    [{
        id M string 二级分类ID
        name M string 二级分类名
        rank O int 二级分类权重(新增)
        first_category_id M string 所属一级分类ID
    }]
 }] 
分类中,优先按序号(逆序)排列,无序号按一级分类ID排列;
已设置rank值,存在rank值的要将rank值返回,未设置rank值的则不返回rank;
返回一级分类信息列表和二级分类信息列表

/product/spu/list 获取指定分类的商品

接口名: /product/spu/list
Method: GET
请求:
category_id M string 分类ID
level O int 分类级别 默认一级分类
salemenu_ids O list 销售单ID列表
响应:
code M int 返回码 0为成功、其他为错误
msg O string 出错信息提示
data O list 成功时返回数据,json格式
[{
    img_url: spu图片链接,
    id: spu_id,
    name: spu名称,
    is_fav: 是否已收藏,
    std_unit_name: 基本单位,
    std_sale_price: 售卖价格,
    cart_amount: 加入购物车数量,
    skus: [{
        name: sku名称,
        sale_unit_name: 售卖单位,
        std_sale_price: 基本单位价格,
        sale_ratio: 换算率(售卖单位/基本单位),
        img_url: sku图片链接,
        sale_num_least: 最小下单数量,
        state: 上架状态(1:上架;0:下架),
        category_id_1: 一级分类ID,
        sale_price: 售卖价格,
        is_valid: 是否有效(在用户的销售单内),
        rule_price: 规则价格,
        desc: 描述,
        id: sku_id,
        search_key: 搜索的二级分类ID 前端用,
        std_unit_name: 基本单位,
        category_id_2: 二级分类ID,
        stocks: 库存数量,
        station_id: 站点ID,
        cart_amount: 加入采购单数量,
        salemenu_id: 销售单ID,
        spu_id: spu_id,
    }],
    salemenu_id: 销售单ID,
    rank: spu权重(新增)
 }]
 逻辑:
    按序号逆序排列,无序号按商品spuid正序排列;
    已设置rank值,存在rank值的要将rank值返回,未设置rank值的则不返回rank;
    返回spu信息列表

【gm_rmiclient】增加rank字段

在gm_rmiclient/merchandise.py中的SpuService类、Category1Servicl类和Category2Service类这三个类的update函数中增加rank字段,sort_id字段视为无效字段。

【gm_server_merchandise】增加商品序号rank字段

在category/migrations/service.py中的SpuUpdateView类、Category1UpdateView类和Category1UpdateView类中增加rank字段,sort_id字段视为无效字段。