Skip to content

商品库

字段可选

M：must 必填
O：optional 选填
C: conditional 某些条件下必选

全部商品分类

接口名
    /goods_category
Method
    GET
请求
    无
响应
    code    M   int     返回码，0表示成功，其他表示错误
    msg     M   string  错误信息
    data    M   string  返回json数据

    [
        {
            "name"  M   string  一级商品分类
            "level" M   int 商品分类级别（1，2，3）
            "id"    M   string  一级商品分类名
            "child": [{ O   list    一级商品分类下的所有二级分类
                "name"  M   string  二级商品分类名
                "child": [{ O   list    二级商品分类下的所有品类
                    "name"  M   string  品类名
                    "level" M   int 商品分类级别（1，2，3）
                    "id"    M   string  品类ID
                }],
                "level" M   int 商品分类级别（1，2，3）
                "id": "B000002"
            }]
        }
    ]
示例
    request
        http://test.guanmai.cn:8888/goods_category
    response
        {
            "data": [{
                "name": "A1",
                "level": 1,
                "id": "A000001",
                "child": [{
                    "name": "B1",
                    "child": [{
                        "name": "C1",
                        "level": 3,
                        "id": "C000003"
                    }],
                    "level": 2,
                    "id": "B000002"
                }]
            }],
            "code": 0,
            "msg": "ok"
        }

编辑商品分类（编辑的逻辑是先删除再添加）

接口名
    /goods_category/edit
Method
    POST
请求
    "id"    M   string  商品分类ID
    "name"  O   string  商品分类名
    "type"  O   int 商品类别（1:公库;2:私库）
响应
    code    M   int     返回码，0表示成功，其他表示错误
    msg     M   string  错误信息
    data    M   string  返回改变了的所有商品分类

    这里返回的商品分类级数会根据修改的商品分类具体级别变动，这里以修改了二级分类为例
    修改二级分类会修改其下所有的品类，这里会返回新的二级分类及其下的所有品类
    "id"    M   string  二级商品分类ID
    "level" M   int 商品分类级别（1，2，3）
    "name"  M   string  二级商品分类名
    "child": [{ O   list    二级商品分类下的所有品类
        "id"    M   string  品类ID
        "level" M   int 商品分类级别（1，2，3）
        "name"  M   string  品类名
    }]
示例
    request
        http://test.guanmai.cn:8888/goods_category/edit
    form-data
        id: WC0001
        name: "141"
    response
        {
            "msg": "ok",
            "code": 0,
            "data": {
                "id": "B000085",
                "level": 2,
                "name": "肉3",
                "child": [{
                    "id": "C000084",
                    "level": 3,
                    "name": "肉肉肉肉肉",
                    "child": []
                }]
            }
        }

添加商品分类

接口名
    /goods_category/create
Method
    POST
请求
    "parent_id"    M   string  父商品分类ID，如果是添加一级分类，传""
    "name"  M   string  商品分类名
响应
    code    M   int     返回码，0表示成功，其他表示错误
    msg     M   string  错误信息
    data    M   string  返回商品分类ID
示例
    request
        http://test.guanmai.cn:8888/goods_category/create
    form-data
        parent_id: A0001
        name: "141"
    response
        {
            "data": "B001",
            "code": 0,
            "msg": "ok"
        }

删除商品分类

接口名
    /goods_category/delete
Method
    POST
请求
    "id"    M   string  商品分类ID
响应
    code    M   int     返回码，0表示成功，其他表示错误
    msg     M   string  错误信息
    data    M   string  空
示例
    request
        http://test.guanmai.cn:8888/goods_category/delete
    form-data
        id: C0001
    response
        {
            "data": "",
            "code": 0,
            "msg": "ok"
        }