Changes between Version 15 and Version 16 of price_api_2.2.0

Timestamp:

10/29/2015 12:14:47 PM (10 years ago)

Author:

oujianqiang

Comment:

--

price_api_2.2.0

@@ -839 +839 @@
 **后端接口文档**
 
-> 
-
-**说明**
-
-> 
-
-**缓存时间**
-
-> 
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#获取用户的地址列表 获取用户的地址列表]
+
+**说明**
+
+> 获取用户的地址列表
+
+**缓存时间**
+
+> 无
 
 **提交方式**
@@ -855 +855 @@
 **是否需要登录**
 
-> 
-
-**参数**
-
-||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
-||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
-||inReview||审核状态||int||0||否||1-是，0-不是||
-
-**返回格式**
-> html
-
-**返回数据**
-
-{{{#!java
-{
-  status: 1,
-  msg: "请求成功"
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || ||
+
+**返回格式**
+> html
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功",
+  data: [
+            {
+             addrId: 123456,            //地址Id
+             name: rico,                //用户名
+             province: 13-河北,         //省
+             city: 1303-秦皇岛,         //城市
+             county: 130324-卢龙县,    //县，区
+             phone: 15952352365,        //电话 
+             detail: 广州市天河区天河软件园高普路115号太平洋网络,      //详细地址
+             idcardNo: 445185455623562955,                             //身份证号码
+             idcardImga: http://img.pconline.com.cn/images/upload/upc/tx/pcbest_buy/a.jpg,     //身份证正面
+             idcardImgb: http://img.pconline.com.cn/images/upload/upc/tx/pcbest_buy/b.jpg,     //身份证反面
+             postcode: 510006,        //邮政编码
+             isdefault: 0            //是否默认地址 1是，0否
+           }
+        ]
   
 }
@@ -891 +906 @@
 **后端接口**
 
-> 
-
-**后端接口文档**
-
-> 
-
-**说明**
-
-> 
-
-**缓存时间**
-
-> 
-
-**提交方式**
-
-> GET
-
-**是否需要登录**
-
-> 
-
-**参数**
-
-||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
-||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
-||inReview||审核状态||int||0||否||1-是，0-不是||
+> http://best.pconline.com.cn/appIntf/useraddress/setDefaultAddress.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#设置默认地址 设置默认地址]
+
+**说明**
+
+> 设置用户的默认地址
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> POST
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| addrId || 用户地址id || string || "" || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || ||
 
 **返回格式**
@@ -972 +987 @@
 
 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| addrId || 用户地址id || string || "" || 是 ||  ||
 || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || ||
-|| addrId || 用户地址id || string || "" || 是 ||  ||
 
 **返回格式**
@@ -1071 +1086 @@
 **后端接口**
 
+> http://best.pconline.com.cn/appIntf/order/orderList.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/order#用户订单列表 用户订单列表]
+
+**说明**
+
+> 请求用户的订单列表
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| pageNo || 第几页 || int || 1 || 是 ||  ||
+|| pageSize || 一页的数据量 || int || 10 || 是 ||  ||
+|| type || 0全部订单；1待付款订单；2待发货订单；3待收货订单；4已完成订单 || int || 0 || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> html
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+  
+    pageNo: 1,
+    pageSize: 10,
+    total: 20,
+    pageTotal: 2,
+    serviceDate: 2015-11-11 11:11:10
+    data: [
+        {
+           orderId: 123456,         //订单id
+           orderNo: 20151111123321, //订单编号
+           enName: "ECCO Men's Dress Moccasin Penny Loafer",        //商品标题
+           property: "Size: 42 M EU / 8-8.5 D(M) US|Color: Black",  //商品参数 有些商品没有参数  此项为""
+           imgUrl: xxx.xxxx...,           //商品图片
+           cnPrice: 123.00,               //人民币单价
+           frPrice: 20.00,                //美元单价
+           tariffAmountprice: 120.00,     //关税
+           expAmountprice: 123.00,        //运费
+           amountPrice: 100000.00,        //订单总价
+           status: 1,                     //订单状态
+           pastDate: 2015-11-11 11:11:11, //付款过期时间
+           mallId: 123,                   //电商id
+           mallName: "美国亚马逊"         //电商名称
+        }
+    ]
+}
+}}}
+
+
+----------
+
+
+=== 3.2取消订单 ===
+[[BR]]
+**需求：**[[BR]]
+1、新接口；[[BR]]
+
+**mrobot接口**
+
+> （待补充）
+
+**后端接口**
+
+> http://best.pconline.com.cn/appIntf/order/cancelOrder.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/order#取消订单 取消订单]
+
+**说明**
+
+> 取消用户某个订单 订单状态为未付款（status == 0）或官方未审核（status == 1）的订单才能够取消
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> POST
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| orderId || 订单id || int || 0 || 是 || ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> html
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功",
+  data: {
+            orderId:123456 //取消订单的id
+        }
+  
+}
+}}}
+
+
+----------
+
+
+=== 3.3确认收货 ===
+[[BR]]
+**需求：**[[BR]]
+1、新接口；[[BR]]
+
+**mrobot接口**
+
+> （待补充）
+
+**后端接口**
+
+> http://best.pconline.com.cn/appIntf/order/confirmReceive.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/order#确认收货 确认收货]
+
+**说明**
+
+> 将订单状态改为已收货 订单发货后（status == 7）才能以确认收货
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> POST
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| orderId || 订单id || int || 0 || 是 || ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> html
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功",
+  data: {
+            orderId:123456 //修改的订单id
+        }
+  
+}
+}}}
+
+
+----------
+
+
+=== 3.4订单详情wap页 ===
+[[BR]]
+**需求：**[[BR]]
+1、新接口；[[BR]]
+
+**mrobot接口**
+
+> （待补充）
+
+**后端接口**
+
 > 
 
@@ -1116 +1330 @@
 
 
-=== 3.2取消订单 ===
+=== 3.5物流详情wap页 ===
 [[BR]]
 **需求：**[[BR]]
@@ -1172 +1386 @@
 
 
-=== 3.3确认收货 ===
+=== 3.6退款详情wap页 ===
 [[BR]]
 **需求：**[[BR]]
@@ -1226 +1440 @@
 
 ----------
-
-
-=== 3.4订单详情wap页 ===
-[[BR]]
-**需求：**[[BR]]
-1、新接口；[[BR]]
-
-**mrobot接口**
-
-> （待补充）
-
-**后端接口**
-
-> 
-
-**后端接口文档**
-
-> 
-
-**说明**
-
-> 
-
-**缓存时间**
-
-> 
-
-**提交方式**
-
-> GET
-
-**是否需要登录**
-
-> 
-
-**参数**
-
-||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
-||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
-||inReview||审核状态||int||0||否||1-是，0-不是||
-
-**返回格式**
-> html
-
-**返回数据**
-
-{{{#!java
-{
-  status: 1,
-  msg: "请求成功"
-  
-}
-}}}
-
-
-----------
-
-
-=== 3.5物流详情wap页 ===
-[[BR]]
-**需求：**[[BR]]
-1、新接口；[[BR]]
-
-**mrobot接口**
-
-> （待补充）
-
-**后端接口**
-
-> 
-
-**后端接口文档**
-
-> 
-
-**说明**
-
-> 
-
-**缓存时间**
-
-> 
-
-**提交方式**
-
-> GET
-
-**是否需要登录**
-
-> 
-
-**参数**
-
-||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
-||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
-||inReview||审核状态||int||0||否||1-是，0-不是||
-
-**返回格式**
-> html
-
-**返回数据**
-
-{{{#!java
-{
-  status: 1,
-  msg: "请求成功"
-  
-}
-}}}
-
-
-----------
-
-
-=== 3.6退款详情wap页 ===
-[[BR]]
-**需求：**[[BR]]
-1、新接口；[[BR]]
-
-**mrobot接口**
-
-> （待补充）
-
-**后端接口**
-
-> 
-
-**后端接口文档**
-
-> 
-
-**说明**
-
-> 
-
-**缓存时间**
-
-> 
-
-**提交方式**
-
-> GET
-
-**是否需要登录**
-
-> 
-
-**参数**
-
-||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
-||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
-||inReview||审核状态||int||0||否||1-是，0-不是||
-
-**返回格式**
-> html
-
-**返回数据**
-
-{{{#!java
-{
-  status: 1,
-  msg: "请求成功"
-  
-}
-}}}
-
-
-----------