常用地址访问

本地商城前端访问地址
 本地商城后台访问地址

阿里云商城前台访问地址
 阿里云商城后台访问地址

[TOC]

科比特商城系统API接口

后台

URL: 192.168.4.232/mmcshop

退出登录

HOST:URL/admin/public/logOut

商品种类列表

添加商品分类

权限：admin_priv(‘cat_manage’);
HOST:URL/admin/category/addCategory

请求方式：POST
参数

cat_id ：自增ID
parent_id ：分类的父ID，取值于该表的cat_id字段
sort_order：该分类在页面显示的顺序，数字越大顺序越靠后；同数字，id在前的先显示
keywords：分类的关键字，是为了搜索
cat_desc：分类描述
measure_unit：该分类的计量单位
cat_name：分类名称
show_in_nav：是否显示在导航栏。0：不显示；1：显示在导航栏
is_show：是否在前台页面显示，1，显示；0，不显示
grade：该分类的最高和最低价之间的价格分级，当大于1 时，会根据最大最小价格区间分成区间，会在页面显示价格范围，如0-300,300-600,600-900这种

取消字段：
//style：该分类的单独的样式表的包括文件名部分的文件路径 
//filter_attr：如果该字段有值，则该分类将还会按照该值对应在表goods_attr的goods_attr_id所对应的属性筛选，如，封面颜色下有红，黑分类筛选

返回值

1. cat_name 已经存在
$status = 1
$message = '该分类已经存在，请直接编辑分类！';
2. cat_name 为空
$status = 1
$message = '该分类为空，请填写后提交！';
3. grade 不在区间[0,10]
$status = 1
$message = '价格区间超出范围!';

4. addCategory 上传成功
$status = 0
$message = 'cat add succed!';
5. addCategory 上传失败
$status = 1
$message = 'cat add Error!';

提交更新商品分类信息

权限 :admin_priv(‘cat_manage’);
Table: catgory,cat_recommend
HOST:URL/admin/category/updateCategory

请求方式：POST

参数

cat_id
old_cat_name
parent_id
sort_order
keywords
cat_desc
measure_unit
cat_name
is_show
show_in_nav
grade

cat_recommend     精品：1  最新：2  热门：3      //Table：cat_recommend

返回值

1. cat_name 已经存在
$status = 1
$message = '该分类已经存在，请直接编辑分类！';
2. cat_name 为空
$status = 1
$message = '该分类为空，请填写后提交！';
3. grade 不在区间[0,10]
$status = 1
$message = '价格区间超出范围!';

4. addCategory 上传成功
$status = 0
$message = 'cat add succed!';
5. addCategory 上传失败
$status = 1
$message = 'cat add Error!';

删除商品分类信息

HOST:URL/admin/category/removeCategory

请求方式：POST

参数

cat_id

返回值

1. 当删除的分类下面有产品时，禁止删除操作
$status = 1
$message = '不是末级分类或者此分类下还存在有商品,您不能删除!';

2. 商品分类删除成功
$status = 0
$message = '商品分类删除成功';

上级分类 parent_id

HOST:URL/admin/category/catParentIdMenu

请求方式：POST
参数

无参数

返回值
默认加上0：顶级分类

1 2	cat_id ：分类ID>=1 cat_name ：分类名字

选择后前端取cat_id值，传输给parent_id

1	parent_id = cat_id

编辑商品分类

HOST：URL/admin/category/editCategory

请求方式：POST
参数

cat_id

返回值

{
    "cat_info": {
        "cat_id": "2",
        "cat_name": "图传",
        "keywords": "",
        "cat_desc": "",
        "parent_id": "0",
        "sort_order": "1",
        "template_file": "",
        "measure_unit": "个",
        "show_in_nav": "1",
        "style": "",
        "is_show": "0",
        "grade": "5",
        "filter_attr": ""
    },
    "cat_recommend": [
        {
            "cat_id": "2",
            "recommend_type": "1"
        },
        {
            "cat_id": "2",
            "recommend_type": "2"
        }
    ]
}

获取商品分类列表

HOST：URL/admin/category/listCategory

请求方式：POST
参数

无参

返回值

cat_id,
cat_name,
measure_unit,
is_show,
show_in_nav,
grade,
sort_order

注：缺少商品数量，此项参数，后续再处理。

获取商品分类菜单

HOST：URL/admin/category/menuCategory

请求方式：POST
参数

无参

返回值

1
2
3

cat_id,
cat_name,
parent_id

数量单位在线修改

HOST：URL/admin/category/measureUnitChange

请求方式：POST
参数

1 2	cat_id measure_unit

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

导航栏在线修改

HOST：URL/admin/category/isShowChange

请求方式：POST
参数

1	cat_id,is_show

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

是否显示在线修改

HOST：URL/admin/category/showInNavChange

请求方式：POST
参数

1	cat_id,show_in_nav

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

价格分级在线修改

HOST：URL/admin/category/gradeChange

请求方式：POST
参数

1 2	cat_id grade 取值范围[0,10]

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

status  = 1;
$message = '价格区间超出范围!';

排序在线修改

HOST：URL/admin/category/sortOrderChange

请求方式：POST
参数

1	cat_id,sort_order

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

[TOC]

商品管理

商品基本信息说明

主要数据表介绍：

mmc_goods：商品的基本信息表
mmc_goods_attr：存储商品的属性信息
mmc_goods_type：存储商品扩展分类，选择商品的所属类型，进而完善此商品的属性
mmc_attribute:存储扩展分类，详细属性列表，value在mmc_goods_attr中存储
mmc_brand：商品品牌，目前只是写入了科比特品牌，未来可能有其他品牌列入

通用信息

商品名称:goods_name
mmc_goods
商品货号:goods_sn
商品分类:cat_id
mmc_catgory
HOST：URL/admin/category/menuCategory
扩展分类del
商品品牌:brand_id
mmc_brand
HOST：URL/admin/brand/menuBrand
本店售价：shop_price
市场售价：market_price
上传商品图片:goods_img
上传商品缩略图：goods_thumb

详细描述

详细描述：goods_desc

其他信息

商品重量：goods_weight 两位小数
商品库存数量：goods_number
库存警告数量del
加入推荐：
精品：is_best
新品：is_new
热销：is_hot
能作为普通商品销售del
是否为免运费商品del
上架:is_on_sale
商品关键词：keywords
商品简单描述: goods_brief
商家备注：seller_note

商品属性

列表选择商品的所属类型

商品类型：goods_type
mmc_goods_type
HOST：URL/admin/goodstype/menuGoodstype

商品相册

mmc_goods_gallery

goods_id

img_url

img_desc

thumb_url

img_original

关联商品

table：mmc_link_goods

goods_id

link_goods_id

is_double

admin_id

配件

table: mmc_group_goods

parent_id 父类ID：本商品goods_id

goods_id 配件商品ID：mmc_goods

goods_price 配件价格

admin_id

备用

add_goods_article goodsId
drop_goods_article goodsId

添加商品按钮

这部分做初始化操作，目的是删除缓存的关联数据

HOST：URL/admin/goods/goodsAddInit

请求方式：POST
参数

void

返回值

void

确定添加商品

权限：goods_manage

HOST：URL/admin/goods/goodsAdd

请求方式：POST

参数

goods_id
goods_name
goods_sn:可为空，系统自动生成SN
cat_id          
brand_id        
shop_price
market_price

goods_img:文件类型
goods_thumb:文件类型

is_make_thumb 【新增，是否自动生成缩略图】

goods_desc

goods_weight ：两位小数
goods_number
is_best      
is_new       
is_hot 
        
is_on_sale
keywords
goods_brief
seller_note

goods_type

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';


其他错误信息：
status  = 1;
message = '文件类型不符合要求!';

商品提交更新

权限：goods_manage

HOST：URL/admin/goods/goodsUpdate

请求方式：POST

参数

goods_id
goods_name
goods_sn:可为空，系统自动生成SN
cat_id
user_id  【新增】产品负责人          
brand_id        
shop_price
market_price

goods_img:保留，暂不提交
goods_thumb:保留，暂不提交

【新增】is_make_thumb :是否生成缩略图  0：手动提交缩略图  1：自动生成缩略图

goods_desc

goods_weight ：两位小数
goods_number
is_best      
is_new       
is_hot 
        
is_on_sale
keywords
goods_brief
seller_note

goods_type

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品编辑

说明：商品的添加界面
HOST：URL/admin/goods/goodsEdit
参数来源：

参数

1 2	goods_id 商品Id session_id 用户session_id

返回值

goods_param_list 产品参数列表
linked_goods_list 关联商品列表
group_goods_list 关联配件列表
goods_gallery_list 产品相册列表

{
    "goods_param_list": [
        {
            "goods_id": "1",
            "cat_id": "3",
            "goods_sn": "SN_000001",
            "goods_name": "MC6-1550" 
        }
    ],
    "linked_goods_list": [
        {
            "value": "1",
            "text": "MC6-1550 -- [单向关联]",
            "data": ""
        },
        {
            "value": "2",
            "text": "MC6-1200 -- [单向关联]",
            "data": ""
        },
        {
            "value": "3",
            "text": "T80 -- [单向关联]",
            "data": ""
        }
    ],
    "group_goods_list": []
    
    "goods_gallery_list":[img_id,image_url,img_desc,thumb_url]
}

移除产品到回收站

注：此种删除方式只是将产品移动到回收站列表，并不是真正的删除此产品，如果将此产品完全删除需要调用goodsDrop接口。

HOST:URL/admin/goods/goodsRemove

请求方式：POST

参数

good_id

返回值

1. 删除失败
$status = 1
$message = '删除失败!';

2. 商品分类删除成功
$status = 0
$message = '商品删除成功';

从回收站彻底删除产品

注：此种删除方式将此产品彻底删除，不可逆转。

HOST:URL/admin/goods/goodsDrop

请求方式：POST

参数

good_id

返回值

1. 删除失败
$status = 1
$message = '删除失败!';

2. 商品分类删除成功
$status = 0
$message = '商品删除成功';

删除商品

HOST:URL/admin/goods/dropGallery

请求方式：POST

参数

1	img_id 图片ID

返回值

1. 删除失败
$status = 1
$message = '删除失败!';

2. 删除成功
$status = 0
$message = '商品删除成功';

商品列表

权限：goods_manage

HOST：URL/admin/goods/listGoods

请求方式：POST
参数

* @param   cat_id     分类ID
* @param   brand_id   品牌
* @param   keywords   关键字
* @param   sort_by    排序方式      不赋值默认g.goods_id  还有：g.cat_id  g.is_on_sale
* @param   sort_order 顺序还是倒序   不赋值默认倒序排列，    sort_order =1 时为顺序
* @param   page_size  分页大小
* @param   page       第几页
* @return  array

返回值

参数说明：
goods_id,编号
goods_name,商品名称
goods_sn,货号
name_cn,产品负责人【新增】
shop_price,价格
is_on_sale,上架
is_best,精品
is_new,新品
is_hot,热销
sort_order,推荐排序
goods_number库存

{
    "list": [
        {
            "goods_id": "2",
            "goods_name": "MC6-1200",
            "goods_sn": "SN_000002",
            "name_cn": "实验室",
            "shop_price": "120000.00",
            "is_on_sale": "1",
            "is_best": "1",
            "is_new": "1",
            "is_hot": "1",
            "sort_order": "102",
            "goods_number": "10"
        }
    ],
    "filter": {
        "sort_by": "g.goods_id",  按照goods_id 排序
        "sort_order": "DESC",  倒序/顺序
        "record_count": "1",   一共多少条记录
        "page_size": 10,       分页大小
        "page": 1,             第几页
        "page_count": 1,       总页数
        "start": 0             从第几条记录开始
    },
    "page_count": 1,        
    "record_count": "1"     
}

注：删除虚拟销量virtual_sales标签；

商品名称在线修改

权限：goods_manage

HOST：URL/admin/goods/goodsNameChange

请求方式：POST
参数

1 2	goods_id,编号 goods_name,商品名称

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品货号在线修改

权限：goods_manage
注：商品货号为唯一识别码，修改前先进性查重操作。

HOST：URL/admin/goods/goodsSnChange

请求方式：POST
参数

1 2	goods_id,编号 goods_sn,货号

返回值

status = 501;
message= 该条数据存在；

status = 777；
message= 权限；

status  = 1;
message = '数据更新成功!';

status  = 0;
message = '数据更新失败！';

商品价格在线修改

权限：goods_manage

HOST：URL/admin/goods/shopPriceChange

请求方式：POST
参数

1 2	goods_id,编号 shop_price,价格

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品预售在线修改

HOST：URL/admin/goods/isPresaleStatusChange

请求方式：POST
参数

1 2	goods_id,编号 is_new,新品, 0:取消 1：选中

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品上架在线修改

权限：goods_manage

HOST：URL/admin/goods/onSaleStatusChange

请求方式：POST
参数

1 2	goods_id,编号 is_on_sale,上架, 0:取消 1：选中

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品精品在线修改

HOST：URL/admin/goods/isBestStatusChange

请求方式：POST
参数

1 2	goods_id,编号 is_best,精品, 0:取消 1：选中

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品新品在线修改

HOST：URL/admin/goods/isNewStatusChange

请求方式：POST
参数

1 2	goods_id,编号 is_new,新品, 0:取消 1：选中

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品热销在线修改

HOST：URL/admin/goods/isHotStatusChange

请求方式：POST
参数

1 2	goods_id,编号 is_hot,热销, 0:取消 1：选中

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品推荐排序在线修改

HOST：URL/admin/goods/sortOrderChange

请求方式：POST
参数

1 2	goods_id,编号 sort_order,推荐排序

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

商品库存在线修改

HOST：URL/admin/goods/goodsNumberChange

请求方式：POST

参数

1 2	goods_id,编号 goods_number，库存

返回值

status  = 0;
message = '数据更新成功!';

status  = 1;
message = '数据更新失败！';

单个商品属性值获取

HOST：URL/admin/goods/getGoodsAttr

请求方式：POST

参数

1 2	goods_id attr_id 属性唯一识别ID

返回值

1	attr_value 属性值

单个商品属性提交更新

HOST：URL/admin/goods/goodsAttrUpdate

请求方式：POST

参数

1
2
3

goods_id
attr_id
attr_value

返回值

void

关联商品页面搜索按钮

HOST：URL/admin/goods/searchGoodsList

请求方式：POST

参数

过滤条件
* cat_id      int     分类ID
* brand_id    int     品牌ID
* keyword     string  关键字
* exclude     arry    商品ID数组     [goods_id]  目的：除了本商品外的商品

返回值

返回值列表：
[
    {
        "goods_id": "1",
        "goods_name": "MC6-1550",
        "shop_price": "1000000.00"
    },
    {
        "goods_id": "2",
        "goods_name": "MC6-1200",
        "shop_price": "120000.00"
    },
    {
        "goods_id": "3",
        "goods_name": "T80",
        "shop_price": "0.00"
    }
]

关联商品页添加商品关联

此接口支持单产品绑定，支持多产品绑定。

HOST：URL/admin/goods/addLinkGoods

请求方式：POST

参数

* @param   array   add_ids    要关联的商品ID  例子：[1,2,5]
* @param   int     goods_id   操作的商品ID
* @param   int     is_double  是否双向绑定    0：否；1：是
* @param   string  session_id 用户session ID
* @return  JSON [{value},{text},{data}]

返回值

[
    {
        "value": "1",
        "text": "MC6-1550 -- [单向关联]",
        "data": ""
    },
    {
        "value": "2",
        "text": "MC6-1200 -- [单向关联]",
        "data": ""
    }
]

关联商品页删除商品关联

此接口支持单产品删除，支持多产品删除。

HOST：URL/admin/goods/dropLinkGoods

请求方式：POST

参数

* @detail 支持多商品一次性删除
* @param   array   drop_ids    要删除关联的商品ID  例子：[1,2,5]
* @param   int     goods_id   操作的商品ID
* @param   int     is_double  是否双向绑定    0：否；1：是
* @param   string  session_id 用户session ID

返回值

@return JSON [{value},{text},{data}]

[
    {
        "value": "1",
        "text": "MC6-1550 -- [单向关联]",
        "data": ""
    },
    {
        "value": "2",
        "text": "MC6-1200 -- [单向关联]",
        "data": ""
    }
]

###添加配件页面选择产品价格输入框

HOST：URL/admin/goods/getGoodsPrice

请求方式：POST

参数

1 2	* @detail 添加配件页面选择产品价格输入框 * @param int goods_id 操作的商品ID

返回值

* @return   string  shop_price 
[
    {
        "shop_price": "120000.00"
    }
]

添加配件关联

HOST：URL/admin/goods/addGroupGoods

请求方式：POST
参数

* @detail 支持多配件一次添加
* @param   array   add_ids    要关联的配件ID       例子：[1,2,5]
* @param   int     goods_id   操作的商品ID
* @param   int     shop_price 商品填写框中的价格
* @param   string  session_id 用户session ID

返回值

@return JSON [{value},{text},{data}]

[
    {
        "value": "2",
        "text": "MC6-1200 -- [50000.00]",
        "data": ""
    },
    {
        "value": "3",
        "text": "T80 -- [50000.00]",
        "data": ""
    }
]

关联配件页删除配件关联

HOST：URL/admin/goods/dropGroupGoods

请求方式：POST

参数

* @detail 支持多配件一次性删除
* @param   array   drop_ids    要删除关联的商品ID  例子：[1,2,5]
* @param   int     goods_id   操作的商品ID
* @param   string  session_id 用户session ID

返回值

@return JSON [{value},{text},{data}]

[
    {
        "value": "2",
        "text": "MC6-1200 -- [50000.00]",
        "data": ""
    }
]

批量上传图片

HOST：URL/admin/goods/uploadMassGallery

请求方式：POST

参数

1	* @param int goods_id 商品ID

返回值

void

商品审批操作日志表及状态显示

数据表：mmc_approve_action

action_id       mediumint 流水号
goods_id        mediumint 被操作的商品ID
action_user     varchar   操作该次的人员
test_status     tinyint   测试状态。0，未确认；1，已确认；
finance_status  tinyint   财务状态。0，未定价；1，已定价；
lab_status      tinyint   实验室审批状态。0，未审批; 1，已审批;
goods_status    tinyint   商品状态。0，未上架；1，已上架；2，预研项目；3，取消（红色）；4，已提交；
action_note     varchar   操作备注
log_time        int       操作时间

商品数据管理

主要数据表介绍：

mmc_data：商品数据的状态表
mmc_data_file: 商品数据表
mmc_data_type: 商品文件名称列表

表结构说明

返回值

1 2	file_id: 序号ID goods_id:产品ID -> goods_name：产品名字 //从goods表中获取

商品数据列表

HOST：URL/admin/data/dataList
请求方式：POST
参数
1
void

返回值

//成功
goods_id
goods_name
goods_sn
is_brief_ch  商品简页
is_brief_en
is_userguide_ch 用户手册
is_userguide_en
is_openvideo  开箱视频
is_installvideo  安装视频
is_debugvideo 测试视频
is_project 立项书

//错误提示
status  = 1;
message = '数据获取失败！';

商品数据编辑

HOST：URL/admin/data/dataList

请求方式：POST

参数

goods_id

返回值

1
2

商品数据数据类型

HOST：URL/admin/data/getDataCat

请求方式：POST

参数

void

返回值

[
    {
        "dcat_id": "1",
        "dcat_name": "产品简页(中文)",
        "enabled": "1"
    }
]

商品数据编辑按钮

HOST：URL/admin/data/editDataBtn

请求方式：POST
参数

1	* @param string goods_id 商品ID

返回值

@return array

[
    {
        "dcat_id": "2",
        "file_version": "100",
        "file_name": "MC6-1550S用户手册V1.0.pdf",
        "file_ext": "pdf",
        "file_url": "http://192.168.4.222/mmcshop/file/1/document/1_P_2_100_1524493791754.pdf"
    }
]

上传商品数据文件

HOST：URL/admin/data/uploadDataFile

请求方式：POST
参数

* 上传商品数据文件
* @param   string  goods_id      商品ID
* @param   string  file_type     目标文件类型  可供选择：media 、pdf
* @param   int     dcat_id       数据类型ID
* @param   int     file_version  文件版本号    三位表示法，如100：标识版本1.0 ； 205：标识2.5版本
* @param   _FILES  data_file     文件
* @param   string  file_desc     文件描述，可为空
* @return  array

返回值

//更新失败
status  =1
message = '数据更新失败!',
//更新成功
status  =0
message = '数据更新成功!',

// goods_id为空错误
status  =1
message = 商品id为空，请重新操作！
// dcat_id为空错误
// file_version为空错误
// data_file为空错误

获取商品名字

HOST：URL/admin/data/getGoodsName

请求方式：POST

参数

goods_id

返回值

[
    {
        "goods_name": "1550"
    }
]

商品品牌

商品品牌：mmc_brand

商品品牌菜单

HOST：URL/admin/brand/menuBrand

请求方式：POST

参数

void

返回值

[
    {
        "brand_id":"1",
        "brand_name":"\u79d1\u6bd4\u7279"
    }
]

商品类型分类

商品类型：mmc_goods_type

商品类型菜单

HOST：URL/admin/goodstype/menuGoodstype

请求方式：POST

参数

void

返回值

1 2	cat_id cat_name

商品参数属性菜单

HOST：URL/admin/goodstype/menuAttribute

请求方式：POST

参数

cat_id

返回值

1 2	"attr_id": "1", "attr_name": "最大起飞重量"

用户管理

权限角色管理在表 mmc_role，主要以部门划分，每个部门划分权限。
mmc_admin_user 管理员用户列表

产品负责人列表

HOST：URL/admin/user/goodsOwnList

请求方式：POST

参数

void

返回值

[
    {
        "user_id": "2",
        "name_cn": "基础用户"
    },
    {
        "user_id": "3",
        "name_cn": "基础用户"
    },
    {
        "user_id": "8",
        "name_cn": "000"
    }
]

管理员用户列表

HOST：URL/admin/user/getAdminUserList

请求方式：POST
参数

void

返回值

user_id, 
user_name, 登录名
name_cn,用户名
email, 
add_time, 
last_login

删除管理员

HOST：URL/admin/user/dropAdminUser

请求方式：POST

参数

1 2	id : 管理员id session_id: 当前session_id

返回值

1 2	status 0，成功 1. 登录失败

编辑管理员

HOST：URL/admin/user/editAdminUser

请求方式：POST

参数

1	id : 管理员id

返回值

user_id, 
user_name, 
name_cn , 
email, 
role_id

添加管理员用户

HOST：URL/admin/user/addAdminUser

请求方式：POST

参数

* @param   string user_name         用户名
* @param   string name_cn           中文名
* @param   string email
* @param   string password          密码
* @param   string pwd_confirm       确认密码
* @param   ing    select_role       选择角色id

返回值

1 2	status 0，成功 1. 登录失败

编辑更新管理员

注：新增中文名表单，name_cn。

HOST：URL/admin/user/updateAdminUser

请求方式：POST

参数

* @param   int    id                图片ID
* @param   string user_name         用户名
* @param   string name_cn           中文名
* @param   string email
* @param   string old_password      旧密码
* @param   string new_password      新密码
* @param   string pwd_confirm       确认密码
* @param   ing    select_role       选择角色id

返回值

1 2	status 0，成功 1. 登录失败

管理员角色管理列表

HOST：URL/admin/user/getRoleList

请求方式：POST

参数

void

返回值

role_id, 
role_name, 
action_list, 
role_describe

获取管理员角色名称列表菜单

管理员角色菜单列表，第一个默认：

role_id=0
role_name = 请选择

HOST：URL/admin/user/roleMenu

请求方式：POST

参数

void

返回值

[
    {
        "role_id": "1",
        "role_name": "商品添加权限"
    }
]

添加角色按钮

删除角色确定按钮

编辑角色按钮

获取角色的基本信息

更新角色确定按钮

提交更新角色

管理员日志

获取IP列表

HOST：URL/admin/log/getIpList

请求方式：POST

参数

void

返回值

[
    {
        "ip_address": "127.0.0.1"
    },
    {
        "ip_address": "192.168.4.203"
    },
    {
        "ip_address": "192.168.4.241"
    }
]

获取日志列表

支持分页。

HOST：URL/admin/log/getIpList

请求方式：POST

参数

* @param   id         用户ID
* @param   ip         用户IP
* @param   sort_by    排序方式      不赋值默认al.log_id；  sort_by = al.log_time 或者 al.user_id
* @param   sort_order 顺序还是倒序   不赋值默认倒序排列；    sort_order = 1 时为顺序
* @param   page_size  分页大小
* @param   page       第几页

返回值

@return array

{
    "list": [
        {
            "log_time": "2018-04-20 15:09:34",
            "log_id": "100",
            "user_id": "1",
            "log_info": "删除权限管理: 123",
            "ip_address": "127.0.0.1",
            "user_name": "admin"
        },
        {
            "log_time": "2018-04-20 14:34:36",
            "log_id": "99",
            "user_id": "1",
            "log_info": "编辑权限管理: mmc",
            "ip_address": "127.0.0.1",
            "user_name": "admin"
        }
    ],
    "filter": {
        "sort_by": "al.log_id",
        "sort_order": "DESC",
        "record_count": "100",
        "page_size": 2,
        "page": 1,
        "page_count": 50,
        "start": 0
    },
    "page_count": 50,
    "record_count": "100"
}

HTML功能

文件上传

<form action="http://www.store.com/home/Tools/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="image"/>
    <input type="submit" value="上传" id="button">
</form>

pdf预览

<object classid="clsid:CA8A9780-280D-11CF-A24D-444553540000" width="500" height="1000" border="0">
<param name="_Version" value="65539">
<param name="_ExtentX" value="20108">
<param name="_ExtentY" value="10866">
<param name="_StockProps" value="0">
<param name="SRC" value="http://47.104.31.20/mmcdms/MMCDMSystemInstructionsV1.1.pdf">
<object data="http://47.104.31.20/mmcdms/MMCDMSystemInstructionsV1.1.pdf" type="application/pdf" width="1000" height="1200">
</object>
</object>

错误返回

返回例子：

{status: int; message:”string” }

|名称|类型|

status: int 消息ID
    0：默认值  表示正常消息
    210：
    404：不存在

    500：数据库操作消息
    501：数据重复
    777：权限操作错误
    
    400:session_id 失效

message: string 消息描述

[TOC]

前端

文件获取路径

URL = http://192.168.4.222/mmcshop/Uploads/
相对路径：20180408/01.jpg
绝对路径：http://192.168.4.222/mmcshop/Uploads/20180408/01.jpg

主界面

显示标题栏

HOST：URL/home/public/showTopNav

请求方式：POST

参数

void

返回值

1 2	"cat_id": "1", "cat_name": "无人机"

显示侧边栏顶级分类

HOST：URL/home/public/showLeftNav

请求方式：POST

参数

void

返回值

1 2	cat_id 节点cat_id cat_name 节点cat_name

首页分类格子铺

HOST：URL/home/public/indexCategoryGrid

请求方式：POST

参数

cat_id

返回值

goods_id
shop_price
goods_thumb
goods_brief

首页精品推荐

HOST：URL/home/public/indexBestGoods

请求方式：POST

参数

void

返回值

goods_id
goods_name
shop_price
goods_thumb
goods_brief

畅销推荐

HOST：URL/home/public/indexHotGoods

请求方式：POST

参数

void

返回值

goods_id
goods_name
shop_price
goods_thumb
goods_brief

首页新品推荐

HOST：URL/home/public/indexNewGoods

请求方式：POST

参数

void

返回值

goods_id
goods_name
shop_price
goods_thumb
goods_brief

首页预售推荐

HOST：URL/home/public/indexPreSaleGoods

请求方式：POST

参数

void

返回值

goods_id
goods_name
shop_price
goods_thumb
goods_brief

单产品页面信息

获取分类名字

HOST：URL/home/goods/getCatName

请求方式：POST

参数

cat_id

返回值

1
2
3

{
    "cat_name": "挂载"
}

选择产品单页信息

HOST：URL/home/goods/selectGoodsPage

请求方式：POST

参数

goods_id

返回值

{
    "goods_info": [
        {
            "goods_sn": "SN_000001",
            "goods_name": "MC6-1550",
            "click_count": "32",
            "goods_number": "1",
            "market_price": "130000.00",
            "shop_price": "120000.00",
            "add_time": "1523261083",
            "goods_weight": "6.200",
            "goods_thumb": "http://192.168.4.222/mmcshop/MSimage/201804/thumb_img/1_thumb_G_1524661096218.jpg",
            "goods_img": "http://192.168.4.222/mmcshop/MSimage/201804/source_img/1_G_1524661096639.jpg"
        }
    ],
    "goods_gallery": [
        {
            "img_id": "17",
            "img_url": "http://192.168.4.222/mmcshop/MSimage/201804/source_img/1_G_1524661096639.jpg",
            "thumb_url": "http://192.168.4.222/mmcshop/MSimage/201804/thumb_img/1_thumb_G_1524661096218.jpg"
        },
        {
            "img_id": "18",
            "img_url": "http://192.168.4.222/mmcshop/MSimage/201804/source_img/1_P_1524659682457.jpg",
            "thumb_url": "http://192.168.4.222/mmcshop/MSimage/201804/thumb_img/1_thumb_P_1524659682730.jpg"
        },
        {
            "img_id": "19",
            "img_url": "http://192.168.4.222/mmcshop/MSimage/201804/source_img/1_P_1524659682612.jpg",
            "thumb_url": "http://192.168.4.222/mmcshop/MSimage/201804/thumb_img/1_thumb_P_1524659682752.jpg"
        }
    ],
    "goods_data": [
        {
            "goods_id": "1",
            "dcat_id": "1",
            "file_version": "102",
            "file_name": "MC6-1550S用户手册V1.0.pdf",
            "file_ext": "pdf",
            "file_url": "http://192.168.4.222/mmcshop/MSfile/1/document/1_P_1_102_1524635196828.pdf"
        },
        {
            "goods_id": "1",
            "dcat_id": "5",
            "file_version": "100",
            "file_name": "mmc.mp4",
            "file_ext": "mp4",
            "file_url": "http://192.168.4.222/mmcshop/MSfile/1/media/1_M_5_100_1524569429101.mp4"
        },
        {
            "goods_id": "1",
            "dcat_id": "4",
            "file_version": "100",
            "file_name": "MC6-1550S用户手册V1.0.pdf",
            "file_ext": "pdf",
            "file_url": "http://192.168.4.222/mmcshop/MSfile/1/document/1_P_4_100_1524628467471.pdf"
        },
        {
            "goods_id": "1",
            "dcat_id": "3",
            "file_version": "100",
            "file_name": "MC6-1550S用户手册V1.0.pdf",
            "file_ext": "pdf",
            "file_url": "http://192.168.4.222/mmcshop/MSfile/1/document/1_P_3_100_1524637852110.pdf"
        },
        {
            "goods_id": "1",
            "dcat_id": "2",
            "file_version": "101",
            "file_name": "MC6-1550S用户手册V1.0.pdf",
            "file_ext": "pdf",
            "file_url": "http://192.168.4.222/mmcshop/MSfile/1/document/1_P_2_101_1524637903327.pdf"
        }
    "goods_attr": [
        {
            "attr_id": "1",
            "attr_name": "机身重量"
            "attr_value": ""            
        },
        {
            "attr_id": "2",
            "attr_name": "最大起飞重量"
            "attr_value": ""
        },
        {
            "attr_id": "3",
            "attr_name": "标准载荷重量"
            "attr_value": ""
        },
        {
            "attr_id": "4",
            "attr_name": "最大载荷重量"
            "attr_value": ""
            
        }]
    ]
}

比较两个商品是否可以进行对比

HOST：URL/home/goods/checkIfCompare

请求方式：POST

参数

1	@param array goods_id_array [goods_id,goods_id]

返回值

{
    "status": 0,
    "message": "可以进行对比!"
}

{
     "status": 1,
     "message": "不同类别，无法对选择的商品进行对比!"
 }

开始进行产品对比

HOST：URL/home/goods/beginCompare

请求方式：POST

参数

1	@param array goods_id_array [1,2,3……]

返回值

[
    {
        "goods_info": {
            "goods_id": "1",
            "goods_sn": "SN_000001",
            "goods_name": "MC6-1550",
            "goods_type": "1",
            "shop_price": "120000.00",
            "onsale_time": "1524737357",
            "goods_weight": "6.200",
            "goods_thumb": "http://192.168.4.222/mmcshop/MSimage/no_photo_1200.png",
            "brand_name": "科比特"
        },
        "goods_attr": [
            {
                "attr_id": "1",
                "attr_name": "轴距",
                "attr_value": "1550mm"
            },
            {
                "attr_id": "2",
                "attr_name": "翼展",
                "attr_value": "2265mm"
            },
            {
                "attr_id": "3",
                "attr_name": "高度",
                "attr_value": "510mm"
            }
        ]
    },
    {
        "goods_info": {
            "goods_id": "2",
            "goods_sn": "SN_000002",
            "goods_name": "MC6-1200",
            "goods_type": "1",
            "shop_price": "120000.00",
            "onsale_time": "1524737356",
            "goods_weight": "5.600",
            "goods_thumb": "http://192.168.4.222/mmcshop/MSimage/no_photo_1200.png",
            "brand_name": "科比特"
        },
        "goods_attr": [
            {
                "attr_id": "1",
                "attr_name": "轴距",
                "attr_value": "1200mm"
            },
            {
                "attr_id": "2",
                "attr_name": "翼展",
                "attr_value": "1760mm"
            }
            
        ]
    }
]

更新内容

20180420

listGoods接口增加 name_cn 产品负责人。

20180423

增加商品管理 uploadDocument接口；
更新商品文件上传接口 HOST：URL/admin/data/uploadDataFile；
增加商品数据编辑按钮接口 HOST：URL/admin/data/editDataBtn

20180427

新增商品预售在线修改：URL/admin/goods/isPresaleStatusChange
新增比较两个商品是否可以进行对比：HOST：URL/home/goods/checkIfCompare
新增开始进行产品对比： HOST：URL/home/goods/beginCompare

MMC HelperShop API 2018-04-02

常用地址访问

后台

登录

checkLogin

验证登录

login

退出登录

商品种类列表

添加商品分类

提交更新商品分类信息

删除商品分类信息

上级分类 parent_id

编辑商品分类

获取商品分类列表

获取商品分类菜单

数量单位在线修改

导航栏在线修改

是否显示在线修改

价格分级在线修改

排序在线修改

商品管理

商品基本信息说明

通用信息

详细描述

其他信息

商品属性

商品相册

关联商品

配件

备用

添加商品按钮

确定添加商品

商品提交更新

商品编辑

移除产品到回收站

从回收站彻底删除产品

删除商品

商品列表

商品名称在线修改

商品货号在线修改

商品价格在线修改

商品预售在线修改

商品上架在线修改

商品精品在线修改

商品新品在线修改

商品热销在线修改

商品推荐排序在线修改

商品库存在线修改

单个商品属性值获取

单个商品属性提交更新

关联商品页面搜索按钮

关联商品页添加商品关联

关联商品页删除商品关联

添加配件关联

关联配件页删除配件关联

批量上传图片

商品审批操作日志表及状态显示

商品数据管理

表结构说明

商品数据列表

商品数据编辑

商品数据数据类型

商品数据编辑按钮

上传商品数据文件

获取商品名字

商品品牌

商品品牌菜单

商品类型分类

商品类型菜单

商品参数属性菜单

用户管理

产品负责人列表

管理员用户列表

删除管理员

编辑管理员

添加管理员用户

编辑更新管理员

管理员角色管理列表

获取管理员角色名称列表菜单