cart.txt
7.06 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
1. 选择或取消购物车商品
POST:
/cart/index/select
PARAM:
string skuList 商品sku列表 如[{"product_sku":744403,"selected":"N","buy_number":1,"goods_type":"ordinary"},{"product_sku":744402,"selected":"N","buy_number":2,"goods_type":"advance"}]
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"选择成功"}
COMMENT:
product_sku : 通过对应PHP传给模板的id参数
selected: 通过对应PHP传给模板的isChecked参数, 当isChecked为true时传值"N", false时传值"Y"
buy_number: 通过对应PHP传给模板的productNum参数
goods_type: 通过对应PHP传给模板的goodsType参数
code=200成功之后需要刷新页面,否则提示message
2. 删除或批量删除购物车商品
POST:
/cart/index/remove
PARAM:
string skuList 商品sku列表,json格式,如{"744403":1,"777777":3}
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"删除成功"}
COMMENT:
744403 : 通过对应PHP传给模板的id参数
1: 通过对应PHP传给模板的productNum参数
code=200成功之后需要刷新页面,否则提示message
3. 修改购物车商品数量
POST:
/cart/index/modify
PARAM:
string sku 商品的SKU, 如 "744403"
int increaseNum 增加数量
int decreaseNum 减少数量
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"修改成功"}
COMMENT:
increaseNum 和 decreaseNum 只需要传一个
code=200成功之后需要刷新页面,否则提示message
4. 移入收藏夹, 支持批量移入收藏夹
POST:
/cart/index/fav
PARAM:
string skuList 商品sku列表,json格式,如{"744403":1,"777777":3}
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"收藏成功"}
COMMENT:
744403: 通过对应PHP传给模板的id参数
1: 通过对应PHP传给模板的productNum参数
code=200成功之后需要刷新页面,否则提示message
5. 获取用户的地址信息
GET:
/cart/index/getAddress
PARAM:
无
RESPONSE:
{
"code": 200,
"data": {
"list": [
{
"id": "4107395",
"user": "洪飞",
"address": "江苏省 南京市 建邺区国家广告产业园 13809048541",
"addressDesc":"国家广告产业园",
"checked": true,
"areaCode": 120101,
"mobile":13809088888,
"phone":"",
"phoneCode":"",
"phoneNum":"",
"zipCode": 210000,
"email":""
},
{
"id": "3544817",
"user": "测试",
"address": "江苏省 南京市 建邺区测试 13809048541",
"checked": false,
"areaCode": 120101,
"mobile":13809088888,
"phone":"",
"phoneCode":"",
"phoneNum":"",
"zipCode": 210000
}
]
},
"message": "地址信息"
}
COMMENT:
default: 默认地址, 如果该参数为空,则展示list数据
list: 用户的地址列表
6. 设置为默认的地址
GET:
/cart/index/setDefaultAddress
PARAM:
id int 地址ID
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"设置成功"}
COMMENT:
id 通过对应PHP传给模板的id参数
7. 获取 省 市 区 县
GET:
/cart/index/getAreaList
PARAM:
id int 地区ID, 省份值传0
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"地区信息"}
COMMENT
caption: 信息
id: 编号
8. 获取优惠券列表
GET:
/cart/index/getCouponList
PARAM:
无
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"优惠券信息"}
COMMENT
code: 优惠码
price: 优惠券价值
desc: 描述信息
9. 选择支付、送货、快递,使用优惠券,使用有货币这些操作,重新运算订单数据
POST:
/cart/index/orderCompute
PARAM:
string cartType 购物车类型,ordinary表示普通, advance表示预售
int deliveryWay 配送方式,1表示普通快递,2表示顺丰速运
int paymentType 支付方式,1表示在线支付,2表示货到付款
string couponCode 优惠码
mixed yohoCoin 使用的有货币数量
int redEnvelopes 红包, 使用的时候传,不使用时可不传
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"操作成功"}
COMMENT:
code=200成功之后需要刷新页面,否则提示message
10. 加入购物车或撤销删除操作
POST:
/cart/index/add
PARAM:
string productSku 商品的SKU
int buyNumber 购买数量
int promotionId 促销ID, 加价购有关
int isEdit 是否是编辑商品SKU,0表示不是编辑, 非必须
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"操作成功"}
COMMENT:
code=200成功之后需要刷新页面,否则提示message
11. 结算下订单
POST:
/cart/index/orderSub
PARAM:
int addressId 地址ID
int cartType 购物车类型ID
int deliveryTimeId 寄送时间ID
int deliveryWayId 寄送方式ID
string invoiceTitle 发票抬头
int invoiceId 发票类型ID
int paymentId 支付方式ID
int paymentType 支付类型ID
string remark 留言
string couponCode 优惠券码
mixed yohoCoin 使用的有货币数量或为空
int isPreContact 送货前是否联系 true:是, false:否
int isPrintPrice 是否打印价格 true:是, false:否
int redEnvelopes 红包, 使用的时候传,不使用时可不传
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"下单成功"}
COMMENT:
payUrl: 当code为200时,data参数下会返回此参数,跳转到支付中间页
12. 保存地址信息
POST:
/cart/index/saveAddress
PARAM:
int id 地址ID ,当修改操作的时候需要传,添加时候不需要传
string address 地址信息
int areaCode 城市码
string consignee 收货人
string email 邮箱地址
string mobile 手机号码
string zipCode 邮编
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"设置成功"}
COMMENT:
id 通过对应PHP传给模板的id参数
13. 检查一组商品SKN列表是否已收藏
POST:
/cart/index/checkFav
PARAM:
string sknList 商品SKN列表,如["123123123","12341234"]
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"是否收藏"}
COMMENT:
14. 删除用户的收货地址
POST:
/cart/index/delAddress
PARAM:
int id 地址ID
RESPONSE:
{"code":200,"data":[],"md5":"d751713988987e9331980363e24189ce","message":"删除地址成功"}
COMMENT:
JAVA相关的凑单和YOHOGIFT接口
http://git.dev.yoho.cn/yoho30/yoho-gateway/wikis/Order#
http://git.dev.yoho.cn/yoho30/yoho-gateway/wikis/Product