购物流程接口需求描述.docx

购物流程接口需求描述
目录
1 提交订单ﻩ１
2 取消订单ﻩ2
3 删除订单ﻩ３
4 查询订单详情（根据订单ｉd)ﻩ4
5 获得用户的订单信息。ﻩ6
6　根据订单iｄ查询物流。ﻩ７
7 商品加入购物车。 ８
８ 获得购物车条目列表(根据用户ｉｄ）。 9
９ 删除购物车中的条目（根据cartiｄ）。ﻩ１０
1０ 修改购物车中某条目的数量。ﻩ11
１１ 购物车结算。 １2
１２ 获取用户收货地址列表。 14
１３ 收货地址增删改查。ﻩ14
1４设置默认收货地址。ﻩ14
1５获取用户浏览商品的历史记录列表。ﻩ14
16获取推荐应用列表。ﻩ14
17意见反馈。ﻩ１４
18版本更新。ﻩ15
１ 提交订单
a、ＨTTP请求方式
ＰOST
b、是否需要登录
ﻩtｕre
ｃ、支持格式
ﻩJＳON
e、请求参数
参数名称
是否必须
类型
描述
ｍoｄ
trｕe
ｓtring
模块名称
cｏde
tｒue
sｔring
方法名称
prｏｄｕctiｄ
trｕe
sｔrinｇ
商品ｉd
prｏductnuｍ
tｒｕe
strｉng
商品数量
attｒeｓｓiｄ
tｒue
ｓｔrｉng
收货地址iｄ
ｍeｓsａｇe
ｔｒｕe
ｓtring
客户留言
atｔriｂuｔe1
ｔrue
strinｇ
商品可选参数1
atｔribuｔe2
true
sｔring
商品可选参数2
aｔｔｒiｂute３
ｔrue
stｒinｇ
商品可选参数3
……
……
f、说明
ﻩ提交一个订单…
g、返回结果及数据字段说明
ﻩ｛
　　"ret":0,
　"ｍsg":"ok",
　　 "ｄata":｛
　 "ordｅrｉｄ＂:"1",
　 }
｝
ﻩ｛
　 "ｒeｔ":1,
　 　"mｓｇ":"商品参数错误,没有这个参数选项。＂
}
ﻩ{
　　 ＂rｅt＂:１,
＂ｍsｇ":＂商品参数错误,没有这个参数值。"
}
２ 取消订单
a、ＨTＴＰ请求方式
POSＴ
b、是否需要登录
ｔuｒe
c、支持格式
ﻩJSON
e、请求参数
参数名称
是否必须
类型
描述
moｄ
true
ｓtｒing
模块名称
code
true
string
方法名称
oｒderiｄ
true
ｓtriｎg
订单iｄ
f、说明
ﻩ取消掉没有完成(及没有确定收货)订单。
g、返回结果及数据字段说明
ﻩ{
　 　 ＂rｅt":0,
　 ＂msg＂:"ｏk",
＂dａtａ":｛
ﻩﻩﻩ 　"　orｄerid ":＂1",
ﻩﻩ}
}
3 删除订单
ａ、HTTP请求方式
ＰＯST
b、是否需要登录
ﻩtuｒｅ
ｃ、支持格式
ﻩJＳＯＮ
e、请求参数
参数名称
是否必须
类型
描述
ｍod
tｒue
stｒiｎg
模块名称
ｃode
tｒｕe
ｓtrinｇ
方法名称
orｄｅrid
ｔrue
stｒing
订单ｉd
f、说明
删除掉已经完成的订单(即已经付过款的商品)。
g、返回结果及数据字段说明
{
　 　 "reｔ＂:０,
　 "msg":＂ok＂,
　 "data":｛
ﻩﻩ " ｏrderid ":"１＂,
ﻩﻩ}
}
4 查询订单详情(根据订单iｄ）
ａ、ＨTTP请求方式
GEＴ
b、是否需要登录
ﻩｔｕｒe
ｃ、支持格式
ＪSON
ｅ、请求参数
参数名称
是否必须
类型
描述
mod
true
ｓｔrｉnｇ
模块名称
ｃｏde
true
strｉｎg
方法名称
orderiｄ
truｅ
string
商品id
f、说明
根据订单的iｄ查询订单的详细信息。返回数据包括订单id、是否付过款、数量、可选属性的数组以及商品的详细信息。
g、返回结果及数据字段说明
｛
　 "ｒｅt":０,
　 "msg":"ok＂,
　 ＂ｄata":｛
ﻩﻩ{
ﻩﻩ ＂　ｏrderiｄ ":＂1＂,
ﻩﻩ " prodｕｃtnum　":"1",
" ispａｉd　＂:"falｓe",
" atｔributes ＂:　[
　 　　　 ﻩﻩ ｛
　 　　　 ﻩ ﻩﻩ＂ａttrｉbutｅid": "１",
　　　 ﻩ "ａttribｕｔｅｎ