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

word
word
1 / 22
word
购物流程接口需求描述
目录
1 提交订单1
2 取消订单2
3 删除订单3
4 查询订单详情〔根据订单id〕4
5 获得用户的订单信息。6
6 根据订单id查询物流。7
7 商品参加购物车。8
8 获得购物车条目列表〔根据用户id〕。9
9 删除购物车中的条目〔根据cartid〕。10
10 修改购物车中某条目的数量。11
11 购物车结算。12
12 获取用户收货地址列表。14
13 收货地址增删改查。14
14设置默认收货地址。14
15获取用户浏览商品的历史记录列表。14
16获取推荐应用列表。14
17意见反应。14
18版本更新。15
1 提交订单
a、HTTP请求方式
word
word
2 / 22
word
POST
b、是否需要登录
ture
c、支持格式
JSON
e、请求参数
参数名称
是否必须
类型
描述
mod
true
string
模块名称
code
true
string
方法名称
productid
true
string
商品id
productnum
true
string
商品数量
attressid
true
string
收货地址id
message
true
string
客户留言
attribute1
true
string
商品可选参数1
attribute2
true
string
商品可选参数2
attribute3
true
string
商品可选参数3
……
……
f、说明
提交一个订单…
g、返回结果与数据字段说明
word
word
3 / 22
word
{
"ret":0,
"msg":"ok",
"data":{
"orderid":"1",
}
}
{
"ret":1,
"msg":"商品参数错误，没有这个参数选项。"
}
{
"ret":1,
"msg":"商品参数错误,没有这个参数值。"
}
2 取消订单
a、HTTP请求方式
POST
b、是否需要登录
ture
c、支持格式
JSON
word
word
4 / 22
word
e、请求参数
参数名称
是否必须
类型
描述
mod
true
string
模块名称
code
true
string
方法名称
orderid
true
string
订单id
f、说明
取消掉没有完成〔与没有确定收货〕订单。
g、返回结果与数据字段说明
{
"ret":0,
"msg":"ok",
"data":{
" orderid ":"1",
}
}
3 删除订单
a、HTTP请求方式
POST
b、是否需要登录
ture
word
word
5 / 22
word
c、支持格式
JSON
e、请求参数
参数名称
是否必须
类型
描述
mod
true
string
模块名称
code
true
string
方法名称
orderid
true
string
订单id
f、说明
删除掉已经完成的订单(即已经付过款的商品)。
g、返回结果与数据字段说明
{
"ret":0,
"msg":"ok",
"data":{
" orderid ":"1",
}
}
4 查询订单详情〔根据订单id〕
a、HTTP请求方式
GET
word
word
6 / 22
word
b、是否需要登录
ture
c、支持格式
JSON
e、请求参数
参数名称
是否必须
类型
描述
mod
true
string
模块名称
code
true
string
方法名称
orderid
true
string
商品id
f、说明
根据订单的id查询订单的详细信息。返回数据包括订单id、是否付过款、数量、可选属性的数组以与商品的详细信息。
g、返回结果与数据字段说明
{
"ret":0,
"msg":"ok",
"data":{
{
" orderid ":"1",
" productnum ":"1",
" ispaid ":"false",
" attribut