手机接口 - cdut · 手机接口 目录 手机接口 ..... 1
TRANSCRIPT
-
手机接口
目录
手机接口 ................................................................................................................................... 1
1、 登陆................................................................................................................................... 4
2、 退出登陆........................................................................................................................... 4
3、 首页图片轮播 ................................................................................................................... 4
4、 首页分类........................................................................................................................... 5
5、 首页商品列表 ................................................................................................................... 5
6、 条件搜索商品 ................................................................................................................... 6
7、 配送地区列表 ................................................................................................................... 7
8、 获取当前区域 ................................................................................................................... 8
9、 更改配送地区 ................................................................................................................... 9
10、 商品一级分类 ................................................................................................................ 9
11、 商品二级分类 ................................................................................................................ 9
12、 分类商品 ...................................................................................................................... 10
13、 商品特性 ...................................................................................................................... 11
14、 商品详情(ID) .............................................................................................................. 12
15、 商品详情(ID、特征)................................................................................................... 13
-
16、 购物车统计信息 .......................................................................................................... 15
17、 购物车列表 .................................................................................................................. 15
18、 购物车-加入物品 ........................................................................................................ 16
19、 购物车-更改物品数量 ................................................................................................ 17
20、 购物车-删除物品 ........................................................................................................ 17
21、 收货人地址列表 .......................................................................................................... 18
22、 收货人地址信息 .......................................................................................................... 18
23、 新增收货地址 .............................................................................................................. 19
24、 删除收货地址 .............................................................................................................. 20
25、 修改收货地址 .............................................................................................................. 20
26、 设置默认地址 .............................................................................................................. 21
27、 账户充值 ...................................................................................................................... 21
28、 订单支付 ...................................................................................................................... 21
29、 用户基础资料查询 ...................................................................................................... 22
30、 用户基础资料修改 ...................................................................................................... 23
31、 用户密码修改 .............................................................................................................. 23
32、 配送方式 ...................................................................................................................... 23
33、 支付方式 ...................................................................................................................... 24
34、 提交订单 ...................................................................................................................... 25
-
35、 我的订单 ...................................................................................................................... 25
36、 订单详情 ...................................................................................................................... 26
37、 订单商品列表 .............................................................................................................. 28
38、 历史采购 ...................................................................................................................... 29
39、 新闻公告栏目 .............................................................................................................. 30
40、 新闻公告列表 .............................................................................................................. 30
41、 新闻公告内容 .............................................................................................................. 31
注: ......................................................................................................................................... 32
附(接口例子): ................................................................................................................. 32
-
1、 登陆
链接:http://域名/loginControl/login
参数:username(用户名)、password(密码)
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
2、 退出登陆
链接:http://域名/loginControl/logout
参数:无
请求:GET
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
3、 首页图片轮播
链接:http://域名/homeControl/carousel
参数:无
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 name varchar(128) 128
-
图片地址 pic varchar(128) 128
链接地址 url varchar(128) 128
数据格式:
{"carousel":[{"id":id,"name":name,"pic":pic,"url":ur},……前面尖括号循环……]}
4、 首页分类
链接:http://域名/categoryControl/classify
参数:无
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 title varchar(200) 200
数据格式:
{"classify":[{"id":id," title ": title },……前面尖括号循环……]}
5、 首页商品列表
链接:http://域名/homeControl/classifyGoods
参数:无
请求:GET
返回:
Name Code Data Type Length
类型 ID category_id int(11) 11
分类标题 category_title varchar(200) 200
商品详细 ID goods_id bigint(20) 20
商品 ID bb_goods_id int(11) 11
商品名称 title varchar(45) 45
商品副标题 subtitle varchar(200) 200
商品编码 goods_sn varchar(45) 45
条码 barcode varchar(128) 128
销售标准价格 sales_price decimal(8,2) 8
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
-
商品主图原始图 original_img varchar(500) 500
是否推荐的 is_best tinyint(1) 1
是否新商品 is_new tinyint(1) 1
数据格式:
{"category":[{
"category_id": category_id,
"category_title": category_title,
"goods": [
{
"goods_id":goods_id,
"bb_goods_id":bb_goods_id,
"title":title,
"subtitle":subtitle,
"goods_sn":goods_sn,
"barcode":barcode,
"sales_price":sales_price,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img,
"is_best":is_best,
"is_new":is_new
} ……更多商品重复前面尖括号……
]
}……更多分类重复前面尖括号……
]}
6、 条件搜索商品
链 接 : http:// 域 名 /homeControl/search?search= 搜 索 条 件 &type= 搜 索 类 型
&sortField=排序属性&sort=排序方式&s=开始序号&e=结束序号
参数:
search:(搜索条件)
type:(搜索类型 1:首页搜索。2:每日精选。3:最新上架。4:分类栏目)
sortField:排序属性,最新(new)、销量(sale)、推荐(reco)、价格(price)
sort:排序方式,降序(desc)、升序(asc)
s:开始序号
-
e:结束序号
注:
sortField 和 sort 可以为空
对应关系:1:“商品名称或条码”。2:“0”。3:“0”。4:“栏目 ID”
请求:GET
返回:
Name Code Data Type Length
商品详细 ID goods_id bigint(20) 20
商品 ID bb_goods_id int(11) 11
商品名称 title varchar(45) 45
商品副标题 subtitle varchar(200) 200
商品编码 goods_sn varchar(45) 45
条码 barcode varchar(128) 128
销售标准价格 sales_price decimal(8,2) 8
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
是否最好的 is_best tinyint(1) 1
是否新商品 is_new tinyint(1) 1
数据格式:
{"goods": [
{
"goods_id":goods_id,
"bb_goods_id":bb_goods_id,
"title":title,
"subtitle":subtitle,
"goods_sn":goods_sn,
"barcode":barcode,
"sales_price":sales_price,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img,
"is_best":is_best,
"is_new":is_new
} ……更多商品重复前面尖括号……
]}
7、 配送地区列表
-
链接:http://域名/homeControl/disregion
参数:无
请求:GET
返回:
Name Code Data Type Length
区域 id id int
区域名称 area varchar(128) 128
市级 city varchar(64) 64
数据格式:
{"disregion":[
{
"city": city,
"area":[
{
" id ": id,
" area ": area
}……更多区域循环前面尖括号内容……
]
}……更多市级循环前面尖括号内容……
]
}
8、 获取当前区域(X)
链接:http://域名/homeControl/curDisregion
参数:无
请求:GET
返回:
Name Code Data Type Length
区域 id id int
区域名称 area varchar(128) 128
市级 city varchar(64) 64
省级 province varchar(64) 64
数据格式:
-
{
"id":id,
"area":area,
"city":city,
"province":province
}
9、 更改配送地区(X)
链接:http://域名/homeControl/setDisregion
参数:id(区域 ID)
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
10、 商品一级分类
链接:http://域名/categoryControl/FCategory
参数:无
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 title varchar(200) 200
数据格式:
{"fcategory":[{"id":id," title ": title },……前面尖括号循环……]}
11、 商品二级分类
链接:http://域名/categoryControl/SCategory?fc=一级分类 ID
参数:fc (一级分类 ID)
-
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 title varchar(200) 200
数据格式:
{"scategory ":[{"id":id," title ": title },……前面尖括号循环……]}
12、 分类商品
链接:http://域名/goodsControl/categoryGoods? sc=二级分类 ID&sortField=排
序属性&sort=排序方式&s=开始序号&e=结束序号
参数:
sc:二级分类 ID
sortField:排序属性,最新(new)、销量(sale)、推荐(reco)、价格(price)
sort:排序方式,降序(desc)、升序(asc)
s:开始序号
e:结束序号
请求:GET
返回:
Name Code Data Type Length
商品详细 ID goods_id bigint(20) 20
商品 ID bb_goods_id int(11) 11
商品名称 title varchar(45) 45
商品副标题 subtitle varchar(200) 200
商品编码 goods_sn varchar(45) 45
条码 barcode varchar(128) 128
库存 number BIGINT(20) 20
方案价格 plan_price DECIMAL(8) 8
零售价格 retail_price decimal(8,2) 8
销售标准价格 sales_price decimal(8,2) 8
-
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
是否推荐的 is_best tinyint(1) 1
是否新商品 is_new tinyint(1) 1
数据格式:
{"goods": [
{
"goods_id":goods_id,
"bb_goods_id":bb_goods_id,
"title":title,
"subtitle":subtitle,
"goods_sn":goods_sn,
"barcode":barcode,
"number": number,
"plan_price": plan_price,
"retail_price":retail_price,
"sales_price":sales_price,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img,
"is_best":is_best,
"is_new":is_new
} //更多商品重复前面尖括号……
]}
13、 商品特性
链接:http://域名/goodsControl/inventory?goodsId=商品 ID
参数:goodsId(商品 ID)
请求:GET
返回:
Name Code Data Type Length
特性 ID id int(11) 11
标题 title varchar(45) 45
数据格式:
{
"inventory1_name":” inventory2_name”,
"inventory1":[
-
{
"id":id," title ": title
},……前面尖括号循环……
],
"inventory2_name":” inventory2_name”,
"inventory2":[
{
"id":id," title ": title
},……前面尖括号循环……
]
}
14、 商品详情(ID)
链接:http://域名/goodsControl/goodsInfo?goodsfullId=商品详情 ID
参数:
goodsfullId:商品详情 ID
请求:GET
返回:
Name Code Data Type Length
商品详细 ID goods_id bigint(20) 20
商品 ID bb_goods_id int(11) 11
商品特征 1ID goods_inventory1_id int(11) 11
商品特征 2ID goods_inventory2_id int(11) 11
商品名称 title varchar(45) 45
商品副标题 subtitle varchar(200) 200
商品编码 goods_sn varchar(45) 45
条码 barcode varchar(128) 128
零售价格 retail_price decimal(8,2) 8
包装清单 packlist text
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
是否推荐的 is_best tinyint(1) 1
是否新商品 is_new tinyint(1) 1
商品介绍 goods_desc text
销售标准价格 sales_price decimal(8,2) 8
属性值 attribule_value varchar(500) 500
属性标题 attribule _title varchar(100) 100
-
数据格式:
{"goods": {
"goods_id":goods_id,
"bb_goods_id":bb_goods_id,
"goods_inventory1_id":goods_inventory1_id,
"goods_inventory2_id":goods_inventory2_id,
"title":title,
"subtitle":subtitle,
"goods_sn":goods_sn,
"barcode":barcode,
"retail_price":retail_price,
"packlist":packlist,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img,
"is_best":is_best,
"is_new":is_new,
"goods_desc":goods_desc,
"sales_price": sales_price,
"attribule":[
{
"attribule _title": attribule _title,
"attribule_value": attribule_value
}……更多商品属性重复前面尖括号……
]
}
}
15、 商品详情(ID、特征)
链接:http://域名/goodsControl/goodsDetail?id=商品 ID& inventory1=商品特征
1& inventory2=商品特征 2
参数:
id:商品 ID(bb_goods_Id)
inventory1:商品特征 1(goods_inventory1_id)
inventory2:商品特征 2(goods_inventory2_id)
请求:GET
-
返回:
Name Code Data Type Length
商品详细 ID goods_id bigint(20) 20
商品 ID bb_goods_id int(11) 11
商品特征 1ID goods_inventory1_id int(11) 11
商品特征 2ID goods_inventory2_id int(11) 11
商品名称 title varchar(45) 45
商品副标题 subtitle varchar(200) 200
商品编码 goods_sn varchar(45) 45
条码 barcode varchar(128) 128
零售价格 retail_price decimal(8,2) 8
包装清单 packlist text
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
是否最好的 is_best tinyint(1) 1
是否新商品 is_new tinyint(1) 1
商品介绍 goods_desc text
销售标准价格 sales_price decimal(8,2) 8
属性值 attribule_value varchar(500) 500
属性标题 attribule _title varchar(100) 100
数据格式:
{"goods": {
"goods_id":goods_id,
"bb_goods_id":bb_goods_id,
"goods_inventory1_id":goods_inventory1_id,
"goods_inventory2_id":goods_inventory2_id,
"title":title,
"subtitle":subtitle,
"goods_sn":goods_sn,
"barcode":barcode,
"retail_price":retail_price,
"packlist":packlist,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img,
"is_best":is_best,
"is_new":is_new,
"goods_desc":goods_desc,
"sales_price": sales_price,
"attribule":[
-
{
"attribule _title": attribule _title,
"attribule_value": attribule_value
}……更多商品属性重复前面尖括号……
]
}
}
16、 购物车统计信息
链接:http://域名/cartControl/cartCount
参数:cart_ids(已选商品的购物车 ID 集合,以下划线”_”拼接,例:22_11_33,查询
所有统计参数 cart_ids=0
请求:GET
返回:
Name Code Data Type Length
已选商品种类总数 totalkind int(11) 11
已选商品总件数 totalpiece int(11) 11
总额 totalprice decimal(8,2) 8
数据格式:
{ totalkind: "totalkind", totalpiece: "totalpiece", totalprice: "totalprice"}
17、 购物车列表
链接:http://域名/cartControl/cartInfo
参数:无
请求:GET
返回:
Name Code Data Type Length
购物车 ID card_id int(11) 11
商品详细 ID goods_id bigint(20) 20
商品 ID bb_goods_id int(11) 11
商品名称 title varchar(45) 45
商品副标题 subtitle varchar(200) 200
-
商品编码 goods_sn varchar(45) 45
特性 1 Inventory1 varchar(45) 45
特性 2 inventory2 varchar(45) 45
条码 barcode varchar(128) 128
零售价格 retail_price decimal(8,2) 8
销售标准价格 sales_price decimal(8,2) 8
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
是否推荐的 is_best tinyint(1) 1
是否新商品 is_new tinyint(1) 1
商品数量 num int(11) 11
商品总额 totalprice decimal(8,2) 8
数据格式:
{"goods": [
{
"card_id": card_id,
"goods_id":goods_id,
"bb_goods_id":bb_goods_id,
"title":title,
"subtitle":subtitle,
"goods_sn":goods_sn,
"barcode":barcode,
"retail_price":retail_price,
"sales_price":sales_price,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img,
"is_best":is_best,
"is_new":is_new,
"num": num,
"totalprice": totalprice
} //更多商品重复前面尖括号……
]}
18、 购物车-加入物品
链接:http://域名/cartControl/cartAdd
参数:
id:商品详细 ID
-
num:商品数量
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
19、 购物车-更改物品数量
链接:http://域名/cartControl/cartUp
参数:
cart_id:购物车 ID
num:数量
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
20、 购物车-删除物品
链接:http://域名/cartControl/cartDel
参数:cart_id(购物车 ID)
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
-
数据格式:{ code: " code ","msg": msg}
21、 收货人地址列表
链接:http://域名/consigneeControl/consigneeList
参数:无
请求:GET
返回:
Name Code Data Type Length
收货人地址 id id int(11) 11
消费者 ID consumer_id bigint(20) 20
收货人名称 name varchar(45) 45
手机号码 phone varchar(11) 11
座机电话 tel varchar(32) 32
是否默认 isdef tinyint(1) 1
省/州 province varchar(64) 64
城市 city varchar(64) 64
区县 area varchar(128) 128
地址 addr varchar(200) 200
备注 remark text 200
数据格式:
{" consignee ": [
{
"id":id,
"consumer_id": consumer_id,
"name":name,
"phone": phone,
"tel":tel,
"isdef": isdef,
"province":province,
"city":city,
"area":area,
"addr":addr,
"remark": remark
} //更多收货人地址重复前面尖括号……
]}
22、 收货人地址信息
-
链接:http://域名/consigneeControl/consigneeInfo
参数:consignee_id(收货人地址 ID)
请求:GET
返回:
Name Code Data Type Length
收货人地址 id id int(11) 11
消费者 ID consumer_id bigint(20) 20
收货人名称 name varchar(45) 45
手机号码 phone varchar(11) 11
座机电话 tel varchar(32) 32
是否默认 isdef tinyint(1) 1
省/州 province varchar(64) 64
城市 city varchar(64) 64
区县 area varchar(128) 128
地址 addr varchar(200) 200
备注 remark text 200
数据格式:
{
"id":id,
"consumer_id": consumer_id,
"name":name,
"phone": phone,
"tel":tel,
"isdef": isdef,
"province":province,
"city":city,
"area":area,
"addr":addr,
"remark": remark
}
23、 新增收货地址
链接:http://域名/consigneeControl/consigneeAdd
参数:
参数 Name
name 收货人名称
phone 手机号码
-
tel 座机电话
province 省/州
city 城市
area 区县
remark 备注
addr 地址
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
24、 删除收货地址
链接:http://域名/consigneeControl/consigneeDel
参数:id(收货人地址 ID)
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
25、 修改收货地址
链接:http://域名/consigneeControl/consigneeUp
参数:
参数 Name
id 收货人地址 id
name 收货人名称
phone 手机号码
tel 座机电话
province 省/州
city 城市
-
area 区县
remark 备注
addr 地址
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
26、 设置默认地址
链接:http://域名/consigneeControl/consigneeDefault
参数:id(收货人地址 ID)
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
27、 账户充值
链接:
参数:
请求:
返回:
数据格式:
28、 订单支付
链接:
-
参数:
请求:
返回:
数据格式:
29、 用户基础资料查询
链接:http://域名/userControl/userInfo
参数:无
请求:GET
返回:
Name Code Data Type Length
用户 ID id bigint(20) 20
用户名 user_name varchar(45) 45
姓名 name varchar(32) 32
邮箱 email varchar(100) 100
手机 mobile varchar(11) 11
性别 sex varchar(6) 6
生日 birthday date
余额 balance decimal(8,2) 8
积分 score int(11) 11
数据格式:{
"id":id,
"user_name":user_name,
"name": name,
"email":email,
"mobile":mobile,
"sex": sex,
"birthday": birthday,
"balance":balance,
"score":score
-
}
30、 用户基础资料修改
链接:http://域名/userControl/userUp
参数:
参数 Name
email 邮箱
mobile 手机
birthday 生日
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
31、 用户密码修改
链接:http://域名/userControl/userPsdUp
参数:
参数 Name
oldPsd 旧密码
newPsd 新密码
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
32、 配送方式
链接:http://域名/systemControl/delivery
http://dict.youdao.com/w/delivery/
-
参数:无
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 title varchar(50) 50
Logo 路径 logo_path varchar(200) 200
数据格式:
{"delivery":[
{
"id":id,
" title ": title,
"logo_path": logo_path
},……前面尖括号循环……
]}
33、 支付方式
链接:http://域名/systemControl/payment
参数:无
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 title varchar(50) 50
Logo 路径 logo_path varchar(200) 200
数据格式:
{"payment":[
http://dict.youdao.com/w/delivery/
-
{
"id":id,
" title ": title,
"logo_path": logo_path
},……前面尖括号循环……
]}
34、 提交订单
链接:http://域名/orderControl/submit
参数:cart_ids(已选商品的购物车 ID 集合,以下划线”_”拼接,例:22_11_33)
参数 Name
consignee_id 收货地址 ID
payment_id 支付方式 ID
delivery_id 配送方式 ID
cart_ids 已选商品的购物车 ID 集合,以下”_”拼接,例:22_11_33
请求:POST
返回:
Name Code Data Type Length
返回代码 code String 32
返回信息 msg String 64
数据格式:{ code: " code ","msg": msg}
35、 我的订单
链接:http://域名/orderControl/orderList?s=开始序号&e=结束序号
参数:s(开始序号)、e(结束序号)
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
http://dict.youdao.com/w/delivery/
-
订单编号 order_sn char(32) 32
订单状态 order_status tinyint(1) 1
发货状态 shipping_status tinyint(1) 1
支付状态 pay_status tinyint(1) 1
创建时间 create_time datetime
总价 total_price decimal(8,2) 8
订单备注 order_note varchar(500) 500
数据格式:
{"orderList": [
{
"id":id,
"order_sn":order_sn,
"order_status":order_status,
"shipping_status":shipping_status,
"pay_status":pay_status,
"create_time":create_time,
"total_price":total_price,
"order_note":order_note
} //更多订单重复前面尖括号……
]}
36、 订单详情
链接:http://域名/orderControl/orderDetail?id=订单 ID
参数:id(订单 ID)
请求:GET
返回:
Name Code Data Type Length
订单 id id int(11) 11
订单编号 order_sn char(32) 32
状态 order_status tinyint(1) 1
发货状态 shipping_status tinyint(1) 1
支付状态 pay_status tinyint(1) 1
付款时间 pay_time datetime
订单备注 order_note varchar(500) 500
配送方式 ID bb_shipping_id int(11) 11
付款方式 ID bb_payment_id int(11) 11
总价 total_price decimal(6,2) 6
-
收货人名称 name varchar(45) 45
手机号码 mobile varchar(11) 11
座机电话 tel varchar(32) 32
省/州 province varchar(64) 64
城市 city varchar(64) 64
区县 area varchar(128) 128
地址 address varchar(200) 200
超市 ID marketid int(11) 11
配送超市 marketname varchar(128) 128
创建时间 create_time datetime
数据格式:
{
"id":id,
"order_sn":order_sn,
"order_status":order_status,
"shipping_status":shipping_status,
"pay_status":pay_status,
"pay_time":pay_time,
"order_note":order_note,
"bb_shipping_id":bb_shipping_id,
"bb_payment_id":bb_payment_id,
"total_price":total_price,
"name":name,
"mobile":mobile,
"tel":tel,
"province":province,
"city":city,
"area":area,
"address":address,
"marketid": marketid,
"marketname": marketname,
-
"create_time":create_time
}
37、 订单商品列表
链接:http://域名/orderControl/orderGoodsList?id=订单 ID
参数:id(订单 ID)
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
订单 ID order_id int(11) 11
商品详细 ID goods_full_id int(11) 11
商品编码 goods_sn varchar(45) 45
商品名称 title varchar(200) 200
商品价格 goods_price decimal(8,2) 8
订单价格 order_price decimal(8,2) 8
创建时间 create_time datetime
下单数量 order_number int(11) 11
发货数量 send_number int(11) 11
配送中心 ID discenter int(11) 11
商品特征 1 goods_inventory1 varchar(45) 45
商品特征 2 goods_inventory2 varchar(45) 45
单位名称 FName varchar(32) 32
默认单位 defaultFUnitId varchar(32) 32
换算关系 FCoefficient varchar(32) 32
商品副标题 subtitle varchar(200) 200
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
数据格式:
{"orderGoods": [
{
"id":id,
"order_id":order_id,
"goods_full_id":goods_full_id,
"goods_sn":goods_sn,
"title":title,
"goods_price":goods_price,
-
"order_price":order_price,
"create_time":create_time,
"order_number":order_number,
"send_number":send_number,
"discenter":discenter,
"goods_inventory1":goods_inventory1,
"goods_inventory2":goods_inventory2,
"FName": FName,
"defaultFUnitId": defaultFUnitId,
"FCoefficient": FCoefficient,
"subtitle":subtitle,
"retail_price":retail_price,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img
} //更多订单商品重复前面尖括号……
]}
38、 历史采购
链接:http://域名/orderControl/historyGoods?s=开始序号&e=结束序号
参数:s(开始序号)、e(结束序号)
请求:GET
返回:
Name Code Data Type Length
商品详细 ID goods_full_id int(11) 11
商品 ID goods_id int(11) 11
商品编码 goods_sn varchar(45) 45
商品名称 title varchar(200) 200
配送中心 ID discenter int(11) 11
商品特征 1 goods_inventory1 varchar(45) 45
商品特征 2 goods_inventory2 varchar(45) 45
单位名称 FName varchar(32) 32
默认单位 defaultFUnitId varchar(32) 32
换算关系 FCoefficient varchar(32) 32
商品副标题 subtitle varchar(200) 200
商品主图缩略图 goods_thumb varchar(500) 500
商品主图大图 goods_img varchar(500) 500
商品主图原始图 original_img varchar(500) 500
数据格式:
-
{"orderGoods": [
{
"goods_full_id":goods_full_id,
"goods_sn":goods_sn,
"title":title,
"discenter":discenter,
"goods_inventory1":goods_inventory1,
"goods_inventory2":goods_inventory2,
"subtitle":subtitle,
"FName": FName,
"defaultFUnitId": defaultFUnitId,
"FCoefficient": FCoefficient,
"goods_thumb":goods_thumb,
"goods_img":goods_img,
"original_img":original_img
} //更多历史商品重复前面尖括号……
]}
39、 新闻公告栏目
链接:http://域名/articleControl/articleColumn
参数:无
请求:GET
返回:
Name Code Data Type Length
id id int(11) 11
标题 title varchar(200) 200
副标题或别名 subtitle varchar(200) 200
数据格式:
{"column": [
{
"id":id,
"title":title,
"subtitle":subtitle
} //更多文章栏目重复前面尖括号……
]}
40、 新闻公告列表
链接:http://域名/articleControl/articleList?id=栏目 ID&s=开始序号&e=结束序号
-
参数:id(栏目 ID)、s(开始序号)、e(结束序号)
请求:GET
返回:
Name Code Data Type Length
文章 id id int(11) 11
内容标题 title varchar(100) 100
内容副标题 subtitle varchar(500) 500
发布时间 publish_time datetime
数据格式:
{"column": [
{
"id":id,
"title":title,
"subtitle":subtitle,
"publish_time":publish_time
} //更多文章重复前面尖括号……
]}
41、 新闻公告内容
链接:http://域名/articleControl/articleContent?id=文章 ID
参数:id(文章 ID)
请求:POST
返回:
Name Code Data Type Length
文章 id id int(11) 11
内容标题 title varchar(100) 100
内容副标题 subtitle varchar(500) 500
内容 contents longtext
附件 ID attachment_id int(11) 11
发布时间 publish_time datetime
附件格式 format varchar(45) 45
附件路径 path varchar(200) 200
数据格式:
{
"id":id,
-
"title":title,
"subtitle":subtitle,
"contents":contents,
"attachment_id":attachment_id,
"publish_time":publish_time,
"format":format,
"path":path
}
注:
1、 成功返回数据格式:
{code: "SUCCESS",msg: "msg"}
2、 报错返回数据格式:
{code: "错误代码",msg: "msg"}
2、订单代码
订单状态 发货状态 支付状态
0无效
1付款状态(待付款)
2配货发货(待发货)
3交易完成
4取消
7售后状态
0 未发货
1 配货中
2 部分发货
3 已发货
4 部分收货
5 已收货
0 未付款
1 已付款
附(接口例子):
1:手机登录
错误
{"code":"L10001","msg":"用户名或密码错误"}
正确
{"code":"SUCCESS","msg":"操作成功"}
2:退出登录
-
{"result":true}
3: 首页图片轮播
{"carousel":[{"id":3,"name":"各种打折
","pic":"/upload/abc.jpg","url":"http://www.baidu.com"},{"id":5,"name":"51促销
","pic":"/upload/abc.jpg","url":"http://www.baidu.com"},{"id":2,"name":"超级牛
肉","pic":"/upload/abc.jpg","url":"http://www.baidu.com"},{"id":4,"name":"这里
是广告","pic":"/upload/abc.jpg","url":"http://www.baidu.com"},{"id":7,"name":"
春节抢购
","pic":"/upload/abc.jpg","url":"http://www.baidu.com"},{"id":1,"name":"好吃就
来每日够","pic":"/upload/abc.jpg","url":"http://www.baidu.com"}]}
来源:
4:首页分类和 5 一起的
5:首页商品列表
{"category":[{"category_id":1,"category_title":"酒水饮料
","goods":[{"goods_id":1,"bb_goods_id":1,"goods_title":"德芙三口味碗装巧克力
","subtitle":"200G 装
","goods_sn":"20140506xcvxz","retail_price":30.00,"sales_price":1.31,"goods_thu
mb":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/upload/a.jpg",
"is_best":"true","is_new":"true","barcode":"6907992810263"}]},{"category_id":2,
"category_title":"休闲食品
","goods":[{"goods_id":5,"bb_goods_id":2,"goods_title":"白巧克力
","subtitle":"204G 装
","goods_sn":"20140510xcvxz","retail_price":5040.00,"sales_price":0.61,"goods_t
humb":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/upload/a.jpg
","is_best":"true","is_new":"true","barcode":"6907992821344"}]},{"category_id":
3,"category_title":"生活用品
","goods":[{"goods_id":9,"bb_goods_id":3,"goods_title":"DANISA/皇冠
","subtitle":"208G 装
","goods_sn":"20140514xcvxz","retail_price":3800.00,"sales_price":1.16,"goods_t
humb":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/upload/a.jpg
","is_best":"false","is_new":"false","barcode":"6907992816296"},{"goods_id":13,
"bb_goods_id":3,"goods_title":"曲奇饼干","subtitle":"212G 装
","goods_sn":"20140518xcvxz","retail_price":8000.00,"sales_price":2.19,"goods_t
humb":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/upload/a.jpg
","is_best":"false","is_new":"false","barcode":"6907992820064"}]},{"category_id
":4,"category_title":"副食调料","goods":[]},{"category_id":5,"category_title":"
生鲜果蔬","goods":[{"goods_id":17,"bb_goods_id":5,"goods_title":"棒棒娃
","subtitle":"216G 装
","goods_sn":"20140522xcvxz","retail_price":1.00,"sales_price":2.42,"goods_thum
http://localhost:8080/homeControl/carousel
-
b":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/upload/a.jpg","
is_best":"false","is_new":"true","barcode":"6907992819600"}]},{"category_id":6,
"category_title":"办公用品","goods":[]},{"category_id":7,"category_title":"母婴
护理","goods":[]},{"category_id":8,"category_title":"饮料
","goods":[]},{"category_id":9,"category_title":"冲调饮料
","goods":[]},{"category_id":10,"category_title":"酒
","goods":[]},{"category_id":11,"category_title":"香烟代购
","goods":[]},{"category_id":12,"category_title":"脉动
","goods":[]},{"category_id":13,"category_title":"鲜橙多
","goods":[]},{"category_id":14,"category_title":"咖啡
","goods":[]},{"category_id":15,"category_title":"茅台
","goods":[]},{"category_id":16,"category_title":"泸州老窖
","goods":[]},{"category_id":17,"category_title":"中华
","goods":[]},{"category_id":18,"category_title":"天子
","goods":[]},{"category_id":19,"category_title":"黄鹤楼
","goods":[]},{"category_id":20,"category_title":"梅花","goods":[]}]}
来源:
6:条件搜索商品
{"goods":[{"goods_id":1,"bb_goods_id":1,"title":"德芙三口味碗装巧克力
","subtitle":"200G 装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","retail_price":30.00,"sa
les_price":1.31,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","orig
inal_img":"/upload/a.jpg","is_best":true,"is_new":true},{"goods_id":5,"bb_goods
_id":2,"title":"白巧克力","subtitle":"204G装
","goods_sn":"20140510xcvxz","barcode":"6907992821344","retail_price":5040.00,"
sales_price":0.61,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","or
iginal_img":"/upload/a.jpg","is_best":true,"is_new":true},{"goods_id":9,"bb_goo
ds_id":3,"title":"DANISA/皇冠","subtitle":"208G 装
","goods_sn":"20140514xcvxz","barcode":"6907992816296","retail_price":3800.00,"
sales_price":1.16,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","or
iginal_img":"/upload/a.jpg","is_best":false,"is_new":false},{"goods_id":17,"bb_
goods_id":5,"title":"棒棒娃","subtitle":"216G装
","goods_sn":"20140522xcvxz","barcode":"6907992819600","retail_price":1.00,"sal
es_price":2.42,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","origi
nal_img":"/upload/a.jpg","is_best":false,"is_new":true}]}
来源:
{"goods":[{"goods_id":1,"bb_goods_id":1,"title":"德芙三口味碗装巧克力
","subtitle":"200G 装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","retail_price":30.00,"sa
http://localhost:8080/homeControl/classifyGoodshttp://localhost:8080/homeControl/search?search=9&type=1
-
les_price":1.31,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","orig
inal_img":"/upload/a.jpg","is_best":true,"is_new":true},{"goods_id":5,"bb_goods
_id":2,"title":"白巧克力","subtitle":"204G装
","goods_sn":"20140510xcvxz","barcode":"6907992821344","retail_price":5040.00,"
sales_price":0.61,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","or
iginal_img":"/upload/a.jpg","is_best":true,"is_new":true}]}
来源:
{"goods":[{"goods_id":1,"bb_goods_id":1,"title":"德芙三口味碗装巧克力
","subtitle":"200G 装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","retail_price":30.00,"sa
les_price":1.31,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","orig
inal_img":"/upload/a.jpg","is_best":true,"is_new":true},{"goods_id":5,"bb_goods
_id":2,"title":"白巧克力","subtitle":"204G装
","goods_sn":"20140510xcvxz","barcode":"6907992821344","retail_price":5040.00,"
sales_price":0.61,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","or
iginal_img":"/upload/a.jpg","is_best":true,"is_new":true},{"goods_id":17,"bb_go
ods_id":5,"title":"棒棒娃","subtitle":"216G装
","goods_sn":"20140522xcvxz","barcode":"6907992819600","retail_price":1.00,"sal
es_price":2.42,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","origi
nal_img":"/upload/a.jpg","is_best":false,"is_new":true}]}
来源:
{"goods":[{"goods_id":1,"bb_goods_id":1,"title":"德芙三口味碗装巧克力
","subtitle":"200G 装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","retail_price":30.00,"sa
les_price":1.31,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","orig
inal_img":"/upload/a.jpg","is_best":true,"is_new":true,"category_id":1,"hierarc
hical":""}]}
来源:
7:配送地区
http://localhost:8080/homeControl/search?search=0&type=2http://localhost:8080/homeControl/search?search=0&type=3http://localhost:8080/homeControl/search?search=1&type=4
-
{"disregion":[{"city":"四川省成都市","areaList":[{"id":1,"area":"武侯区
"},{"id":2,"area":"龙泉驿区"},{"id":5,"area":"金牛区"},{"id":6,"area":"武侯区
"},{"id":8,"area":"温江区"},{"id":9,"area":"成华区"}]},{"city":"河北省张家口市
","areaList":[{"id":3,"area":"宣化区"}]},{"city":"河北省秦皇岛市
","areaList":[{"id":4,"area":"昌黎镇"}]},{"city":"四川省广元市
","areaList":[{"id":7,"area":"朝天区"}]}]}
来源:
8:获取当前区域
{"id":1,"area":"武侯区","city":"成都市","province":"四川省"}
来源:
9:更改配送地区
{"code":"SUCCESS","msg":"操作成功"}
来源:
10:商品一级分类
{"fcategory":[{"id":1,"title":"酒水饮料"},{"id":2,"title":"休闲食品
"},{"id":3,"title":"生活用品"},{"id":4,"title":"副食调料"},{"id":5,"title":"生
鲜果蔬"},{"id":6,"title":"办公用品"},{"id":7,"title":"母婴护理"}]}
来源:
11:商品二级分类
{"scategory ":[{"id":8,"title":"饮料"},{"id":9,"title":"冲调饮料
"},{"id":10,"title":"酒"},{"id":11,"title":"香烟代购"}]}
来源:
12:分类商品
http://localhost:8080/homeControl/disregionhttp://localhost:8080/homeControl/disregionhttp://localhost:8080/homeControl/disregionhttp://localhost:8080/homeControl/disregionhttp://localhost:8080/categoryControl/SCategory?fc=1
-
{"goods":[{"goods_id":13,"bb_goods_id":3,"title":"曲奇饼干","subtitle":"212G 装
","goods_sn":"20140518xcvxz","barcode":"6907992820064","retail_price":8000.00,"
sales_price":2.19,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","or
iginal_img":"/upload/a.jpg","is_best":false,"is_new":false,"category_id":3,"pla
n_price":null},{"goods_id":9,"bb_goods_id":3,"title":"DANISA/皇冠
","subtitle":"208G 装
","goods_sn":"20140514xcvxz","barcode":"6907992816296","retail_price":3800.00,"
sales_price":1.16,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","or
iginal_img":"/upload/a.jpg","is_best":false,"is_new":false,"category_id":3,"pla
n_price":null}]}
来源:
13:商品特性
{"inventory1":[{"id":1,"title":"五香"},{"id":2,"title":"蒜味
"},{"id":3,"title":"香辣"}],"inventory2":[{"id":1,"title":"红色
"},{"id":2,"title":"白色"},{"id":3,"title":"蓝色"},{"id":4,"title":"黑色"}]}
来源:
14:商品详情
{"goods":{"goods_id":1,"bb_goods_id":1,"goods_inventory1_id":1,"goods_inventory
2_id":1,"title":"德芙三口味碗装巧克力 ","subtitle":"200G 装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","retail_price":30.00,"sa
les_price":1.31,"packlist":"这是 HTML代码,表示商品详情
","goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/up
load/a.jpg","is_best":true,"is_new":true,"category_id":1,"goods_desc":"这里是商
品介绍","number":30,"attribule":[],"plan_price":20}}
来源:
15:商品详情(ID,特性)
{"goods":{"goods_id":1,"bb_goods_id":1,"goods_inventory1_id":1,"goods_inventory
2_id":1,"title":"德芙三口味碗装巧克力 ","subtitle":"200G 装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","retail_price":30.00,"sa
les_price":1.31,"packlist":"这是 HTML代码,表示商品详情
","goods_thumb":"/upload/a.jpg","goods_img":"/upload/a.jpg","original_img":"/up
load/a.jpg","is_best":true,"is_new":true,"category_id":1,"goods_desc":"这里是商
品介绍","number":30,"attribule":[],"plan_price":20}}
http://localhost:8080/goodsControl/categoryGoods?sc=3&sortField=salesprice&sort=desc&s=0&e=10http://localhost:8080/goodsControl/categoryGoods?sc=3&sortField=salesprice&sort=desc&s=0&e=10http://localhost:8080/goodsControl/categoryGoods?sc=3&sortField=sales_price&sort=deschttp://localhost:8080/goodsControl/goodsInfo?goodsfullId=1
-
来源:
16:购物车统计信息
{"totalprice":11.09,"totalpiece":9,"totalkind":2}
来源:
17:购物车列表
{"goods":[{"cart_id":1,"goods_id":1,"bb_goods_id":1,"title":"德芙三口味碗装巧克
力 ","subtitle":"200G装
","goods_sn":"20140506xcvxz","barcode":"6907992810263","number":30,"retail_pric
e":30.00,"sales_price":1.31,"goods_thumb":"/upload/a.jpg","goods_img":"/upload/
a.jpg","original_img":"/upload/a.jpg","is_best":true,"num":8,"plan_price":null,
"totalprice":10.48},{"cart_id":2,"goods_id":5,"bb_goods_id":2,"title":"白巧克力
","subtitle":"204G 装
","goods_sn":"20140510xcvxz","barcode":"6907992821344","number":3880,"retail_pr
ice":5040.00,"sales_price":0.61,"goods_thumb":"/upload/a.jpg","goods_img":"/upl
oad/a.jpg","original_img":"/upload/a.jpg","is_best":true,"num":1,"plan_price":n
ull,"totalprice":0.61}]}
来源:
18:加入购物车
{"code":"C10003","msg":"商品库存不够"}
来源:
19:购物车数量更改
{"code":"SUCCESS","msg":"操作成功"}
来源:
20:删除购物车
http://localhost:8080/goodsControl/goodsDetail?id=1&inventory1=1&inventory2=1http://localhost:8080/goodsControl/goodsDetail?id=1&inventory1=1&inventory2=1http://localhost:8080/cartControl/cartInfohttp://localhost:8080/goodsControl/goodsDetail?id=1&inventory1=1&inventory2=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1
-
{"code":"SUCCESS","msg":"操作成功"}
来源:
21、收货人地址列表
{"consignee":[{"id":1001,"name":"陈
1","mobile":"13880018901","tel":"02868755648","is_default":false,"province":"四
川省","city":"成都市","area":"武侯区","address":"测试地址
1","user_id":1},{"id":1002,"name":"11","mobile":"22","tel":"02868755649","is_de
fault":false,"province":"四川省","city":"眉山市","area":"东坡区","address":"测
试地址 2","user_id":1},{"id":1003,"name":"陈
3","mobile":"13880018903","tel":"02868755650","is_default":false,"province":"河
南","city":"郑州","area":"无立区","address":"测试地址
3","user_id":1},{"id":1004,"name":"陈
4","mobile":"13880018904","tel":"02868755651","is_default":false,"province":"四
川省","city":"成都市","area":"高新区","address":"测试地址
4","user_id":1},{"id":1005,"name":"陈
5","mobile":"13880018905","tel":"02868755652","is_default":false,"province":"四
川省","city":"邛崃市","area":"火星村","address":"测试地址
5","user_id":1},{"id":1006,"name":"陈
6","mobile":"13880018906","tel":"02868755653","is_default":false,"province":"四
川省","city":"乐山市","area":"高新区","address":"测试地址
6","user_id":1},{"id":1020,"name":"0001测试
","mobile":"13999999990","tel":"02844444440","is_default":true,"province":"四川
省 1","city":"成都市 1","area":"高新区 1","address":"环球中心 1","user_id":1}]}
来源:
22:收货人地址信息
"result":{"id":1008,"name":"陈
8","mobile":"13880018908","tel":"02868755655","is_default":false,"province":"广
东","city":"深圳","area":"丽洁村","address":"测试地址 8","user_id":2}}
来
源:
http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1
-
23:新增收货人地址信息
{"code":"SUCCESS","msg":"操作成功"}
来源:
24:删除收货地址
{"code":"SUCCESS","msg":"操作成功"}
来源:
25:修改收货地址
{"code":"SUCCESS","msg":"操作成功"}
来
源:
26:设置默认地址
{"code":"SUCCESS","msg":"操作成功"}
来源:
http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1http://localhost:8080/cartControl/cartUp?&cart_id=2&num=1