Skip to content

营销活动

营销活动

/station/promotion/delete 删除营销活动

接口:
    /station/promotion/delete
class:
    /website/station/promotion/views.py/PromotionDeleteView
方法:
    POST
请求:
    id      M    Int    活动id
响应:
    code    M    Int       状态码
    msg     M    String    状态消息
    data    M    Dict      响应数据    
示例:
    请求:
        {
            id: 1
        }
    响应:
        {
            code: 0,
            msg: "ok",
            data: null
        }
说明:
    删除按钮在详情页面

/station/promotion/get 获取营销活动详情

接口:
    /station/promotion/get
class:
    /website/station/promotion/views.py/PromotionDetailView
方法:
    GET
请求:
    id      M    Int    活动id
响应:
    code    M    Int       状态码
    msg     M    String    状态消息
    data    M    Dict      响应数据
        {
            active              M    Int           活动状态
            cms_key             M    String        cms_key
            enable_label_2      M    Int           是否开启二级标签
            label_1_name        M    String        一级标签名字
            label_2             M    List<Dict>    二级标签数据
                [
                    {
                        id      M    Int           二级标签id
                        name    M    String        二级标签名
                        sort    M    Int           展示优先级
                    },
                    ...
                ]
            name                M    String        活动名称
            pic_url             M    String        活动图片
            show_method         M    Int           展示类型
            skus                M    List<Dict>    商品信息 
                [
                    {
                        id                         M    String    sku_id
                        img_url                    M    Int       sku图片
                        is_price_timing            M    bool      是否时价
                        label_1_name               M    String    一级标签名称
                        label_2_id                 M    Int       二级标签id
                        label_2_name               M    String    二级标签名称
                        last_in_stock_price        M    Int       供应商最近入库价
                        last_purchase_price        M    Int       供应商最近采购价
                        last_quote_price           M    Int       供应商最近询价
                        latest_in_stock_price      M    Int       最近入库价
                        latest_quote_price         M    Int       最近询价
                        limit_number               M    Int       限购数量
                        name                       M    Int       商品名
                        price                      M    Int       活动价
                        sale_price                 M    Int       当前定价
                        sale_unit_name             M    String    销售规格名称
                        salemenu_name              M    String    报价单名称
                        state: 1                   M    String    是否上架(1 上架 0 下架)
                        std_unit_name              M    String    基本单位名称
                        stock_avg_price            M    Int       库存均价
                    },
                    ...
                ]
            sort                                   M    Int       位置排序
            type                                   M    Int       活动类型
        }
示例:
    请求:
        {
            id: 2507
        }
    响应:
        {
            code: 0,
            msg: "ok",
            data: 
                {
                    active: 0
                    cms_key: "miaotest"
                    enable_label_2: 0
                    label_1_name: "dd"
                    label_2: []
                    name: "ddd"
                    pic_url: "//img.guanmai.cn/icon/icon-veg.4fa23256.png"
                    show_method: 1
                    skus: 
                        [
                            {
                                id: "D9840925"
                                img_url: "https://img.guanmai.cn/product_pic/20180509a00027.jpg"
                                is_price_timing: false
                                label_1_name: "dd"
                                label_2_id: null
                                label_2_name: null
                                last_in_stock_price: 600
                                last_purchase_price: 600
                                last_quote_price: 213
                                latest_in_stock_price: 600
                                latest_quote_price: 213
                                limit_number: 5
                                name: "迟底肉"
                                price: 600
                                sale_price: 15
                                sale_unit_name: "斤"
                                salemenu_name: "自售单不许删"
                                state: 0
                                std_unit_name: "斤"
                                stock_avg_price: 500
                            }
                        ]
                    sort: null
                    type: 2
                }
        }
说明:
    获取获得活动详情

/station/promotion/create 创建营销活动

接口:
    /station/promotion/create
class:
    /website/station/promotion/views.py/PromotionCreateView
方法:
    POST
请求:
    name                   M    String       营销活动名称
    active                 M    Int          活动状态
    show_method            M    Int          展示方式
    sort                   M    Int          展示优先级
    enable_label_2         M    Int          是否开启二级标签
    label_1_name           M    String       以及标签名称
    label_2                M    List<Dict>   二级标签列表
        [
            {
                id         M    String       二级标签id
                name       M    String       二级标签名称
                sort       M    String       二级标签排序
            },
            ...
        ]
    pic_url                M    String       营销活动图片
    type                   M    Int          营销活动类型
    skus                   M    List<Dict>   营销活动 sku 数据列表
        [
            {
                state            M    Int       是否上架
                name             M    String    sku 名称
                salemenu_name    M    String    报价单名称
                id               M    String    sku_id
                value            M    String    sku_id?
                _gm_select       M    Bool      
                label_2_id       M    String    二级标签名称
                label_2_name     M    String    二级标签名称
                label_1_name     M    String    二级标签名称
            },
            ...
        ]
响应:
    code                   M    Int           状态码
    msg                    M    String        状态消息
    data                   M    Dict          响应消息
        {
            id             M    Int           营销活动id
        }
示例:
    请求:
        {
            name: nick_test
            active: 1
            show_method: 1
            sort: 2
            enable_label_2: 1
            label_1_name: 西西瓜
            label_2: 
                [
                    {"id":"114525541160463","name":"大西瓜","sort":"1"},
                    {"id":"09972176880205685","name":"中西瓜"},
                    {"id":"3738220104924683","name":"小西瓜"}
                ]
            pic_url: //img.guanmai.cn/icon/icon-fruit.0af6ca01.png
            type: 1
            skus: 
                [
                    {
                        "state":1,"name":"红菜",
                        "salemenu_name":"测试商品多效果",
                        "id":"D8918889",
                       "value":"D8918889",
                       "_gm_select":false,
                       "label_2_id":"114525541160463",
                       "label_2_name":"大西瓜","label_1_name":"西西瓜"
                   },
                   ...
                ]
        }
    响应:
        {
            "data": {"id": 3366}, 
            "msg": "ok", 
            "code": 0
        }
说明:

/station/promotion/list 获取当前站点的营销活动

接口:
    /station/promotion/list
class:
    /website/station/promotion/views.py/PromotionListView
方法:
    GET
请求:
    active          O    Int           营销活动是否有效 (1有效,0无效)
    show_method     O    Int           展示类型 (1代表首页分类,2无,3代表广告滚动)
    search_text     O    String        搜索关键字
    offset          O    Int           分页偏移 default 0
    limit           O    Int           一页的条目数量 default 10
响应:
    code            M    Int           响应状态码
    msg             M    String        状态消息
    data            M    List<Dict>    响应数据
        [
            {
                active          M    Int         活动状态
                create_time     M    DateTime    创建时间
                id              M    Int         活动id
                name            M    String      活动名称
                operator        M    Sting       活动创建人
                show_method     M    Int         展示类型
                sku_nums        M    Int         商品规格数量
                type            M    Int         活动类型
                valid_sku_nums  M    Int         有效的规格数量
            },
            ...
        ]
示例:
    请求:
        {
            offset: 0
        }
    响应:
        {
            code: 0,
            msg: "ok",
            data:
                [
                    {
                        active: 0,
                        create_time: "2019-08-12T10:12:00",
                        id: 1,
                        name: "活动一",
                        operator: "miaomiao",
                        show_method: 0,
                        sku_nums: 3,
                        type: 1,
                        valid_sku_nums: 3
                    },
                    ...
                ]
        }
说明:
    获取当前站点的营销活动

/station/promotion/update 更新营销活动

接口:
    /station/promotion/update
class:
    /website/station/promotion/views.py/PromotionUpdateView
方法:
    POST
请求:
    name                   M    String       营销活动名称
    active                 M    Int          活动状态
    show_method            M    Int          展示方式
    sort                   M    Int          展示优先级
    enable_label_2         M    Int          是否开启二级标签
    label_1_name           M    String       以及标签名称
    label_2                M    List<Dict>   二级标签列表
        [
            {
                id         M    String       二级标签id
                name       M    String       二级标签名称
                sort       M    String       二级标签排序
            },
            ...
        ]
    pic_url                M    String       营销活动图片
    type                   M    Int          营销活动类型
    skus                   M    List<Dict>   营销活动 sku 数据列表
        [
            {
                state            M    Int       是否上架
                name             M    String    sku 名称
                salemenu_name    M    String    报价单名称
                id               M    String    sku_id
                value            M    String    sku_id?
                _gm_select       M    Bool      
                label_2_id       M    String    二级标签名称
                label_2_name     M    String    二级标签名称
                label_1_name     M    String    二级标签名称
            },
            ...
        ]    
响应:
    code                   M    Int           状态码
    msg                    M    String        状态消息
    data                   O                  响应消息
示例:
    请求:
        {
            name: nick_test
            active: 1
            show_method: 1
            sort: 2
            enable_label_2: 1
            label_1_name: 西西瓜
            label_2: 
                [
                    {"id":"114525541160463","name":"大西瓜","sort":"1"},
                    {"id":"09972176880205685","name":"中西瓜"},
                    {"id":"3738220104924683","name":"小西瓜"}
                ]
            pic_url: //img.guanmai.cn/icon/icon-fruit.0af6ca01.png
            type: 1
            skus: 
                [
                    {
                        "state":0,
                        "name":"嫩豆腐",
                        "salemenu_name":"供应时间限制",
                        "id":"D9097572",
                       "value":"D9097572",
                       "_gm_select":false,
                       "label_2_id":"5403",
                       "label_2_name":"大西瓜","label_1_name":"西西瓜"
                   },
                   ...
                ]
        }
    响应:
        {
            "data": null, 
            "msg": "ok", 
            "code": 0
        }
说明:

/station/promotion/sku/list 获取营销活动中的 sku 数据

接口:
    /station/promotion/sku/list
class:
    /website/station/promotion/views.py/PromotionSkuGetView
方法:
    GET
请求:
    无
响应:
    code                   M    Int           状态码
    msg                    M    String        状态消息
    data                   M    List<Dict>    响应消息
        [
            {
                id         M    String        一级分类id
                name       M    String        一级分类名称
                children   M    List<Dict>    一级分类的数据列表
                    [
                        {
                            id         M    String        二级分类id
                            name       M    String        二级分类名称
                            children   M    List<Dict>    二级分类的数据列表
                                [
                                    {
                                        id             M String  sku_id
                                        name           M String  商品名称
                                        salemenu_name  M String  报价单名称
                                        state          M Int     销售状态
                                    },
                                    ...
                                ]
                        },
                        ...
                    ]
            },
            ...
        ]
示例:
    请求:
        无
    响应:
        {
            code: 0,
            msg: "ok",
            data:
                [
                    {
                        id: "A8217"
                        name: "果蔬"
                        children:
                            [
                                {
                                    id: "B39463"
                                    name: "叶菜"
                                    children:
                                        [
                                            {
                                                id: "D4481622"
                                                name: "大白菜|包test2"
                                                salemenu_name: "蔬菜报价单"
                                                state: 1
                                            },
                                            ...
                                        ]
                                },
                                ...
                            ]
                    },
                    ...
                ]
        }
说明: