[[TOC]] = 聚超值2.2.0接口文档 = == 一.基本约定 == {{{ 1.开发机、测试机代理地址： mrobot开发机代理：192.168.10.199 端口：1080 mrobot测试机代理：192.168.10.198 端口：1080 电脑网应用端测试环境域名 v42.pconline.com.cn 电脑网应用端线上环境域名 best.pconline.com.cn mrobot线上环境域名：mrobot.pconline.com.cn mrobot测试环境域名：v80.pconline.com.cn mrobot开发环境域名：dev40.pconline.com.cn 2.当接口处理正常时，HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 3.当接口处理异常时，HTTP STATUS CODE 返回非200，并且给出具体的错误信息。 { "desc":"给用户的提示放在这里" } 4.接口默认的字符编码是UTF-8，接口需要实现对req-enc和resp-enc参数的支持。 5.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。 6.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号 7.需要分页的接口，统一返回以下字段: pageNo,pageSize,total }}} == 二.接口列表 == == 1 一键海淘 == === 1.1优惠、海淘、发现、晒物、经验列表数据接口 === [[BR]] **需求：**[[BR]] 1、topic实体新增一个字段 isOfficialPurchasing，用于区分爆料是否支持官方代购；[[BR]] **mrobot接口** > http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp eg：http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp?sectionId=0&pageNo=2&pageSize=20&v=2.2.0 [[BR]] **后端接口** > [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#栏目爆料列表 栏目爆料列表] eg：http://best.pconline.com.cn/app/topic/cache/getTopicList.do?pageNo=0&pageSize=20§ionId=0 [[BR]] **说明** > 根据传入的栏目id，获取对应的爆料列表 **缓存时间** > 300s **提交方式** > GET **是否需要登录** > 否 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||sectionId||栏目id：0 优惠 1 海淘 2 发现 3 晒物 4 经验 5 海淘晒物 6 海淘经验 7 试用体验 8 专题||int||0||是|||| ||pageNo||页数||int||1||是|||| ||pageSize||页面大小||int||10||是|||| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" , pageNo: 1, pageSize: 20, pageTotal: 2168, total: 43357 data:[ {//from $topic topicId: 2395585, title: "有钱你就来", //标题 shortTitle: "超值商品推荐" // 短标题 section: 1, // 栏目：0 优惠 1 海淘 2 发现 3 晒物 4 经验 5 海淘晒物 6 海淘经验 7 试用体验 8 专题 topSection: 1 // 顶级的栏目id：0优惠，1海淘，2 发现，3 晒物，4经验 mallName: "京东", // 电商名称 mallId: 1, // 电商id price: "五折对低价199", // 价格描述 pubDate: 13215412512000, // 发布时间,时间戳 毫秒 overdueStatus: 1, // 是否过期 endTime: 13251245121000, // 优惠截止时间 channelId: 12, // 计数器栏目id imagesForList: "http://www.a.b/a.png", hasCoupon: 0, // 是否有优惠券，适用于 优惠，海淘 cover: "http://www.google.com/1.png", hdCover: "http://www.google.com/1_hd.png", // 高清图，适用于晒物，经验，试用体验 showPicForApp: 1 // 是否白菜价合集 createName: "Jason@qq.com", // 创建者名称 createNamePrefix: "Jason", // 创建者名称，邮箱前缀 isOfficialPurchasing: 0 //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】 } ... ] } }}} ---------- === 1.2爆料详情终端页 === [[BR]] **需求：**[[BR]] 1、页面附加信息：新增一个标签字段isOfficialPurchasing，用于标记爆料是否支持代购；[[BR]] 2、APP上线后（根据请求参数的inReview字段判断，0——已上线，1——正在审核），隐藏页面的举报按钮；[[BR]] **mrobot接口** > http://mrobot.pconline.com.cn/s-1800/best/cms/topicDetail.xsp?topicId=125405&platform=iOS&v=2.2.0&resVer=21000&inReview=0 **后端接口** > [http://trac.pc.com.cn/pc_best/wiki/app2.0/01_topic#爆料详细信息 爆料详细信息] eg：http://best.pconline.com.cn/app/topic/getTopicInfo.do?topicId=125405&fontSize=17&hd=0 [[BR]] > 评论数接口 eg：http://cmt.pconline.com.cn/action/topic/get_data.jsp?url=http://best.pconline.com.cn/discovery_art.jsp?topicId=125405 [[BR]] **说明** > 爆料详情终端页 **缓存时间** > 1800s **提交方式** > GET **是否需要登录** > 否 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||topicId||爆料id||int||0||是|| || ||fontSize||字体大小||int||17||是|| || ||hd||是否显示高清图：0 否 1 是||int||0||否|| || ||platform||平台标识。android平台，platform=android；iOS平台，platform=iOS||String||""||是|| || ||v||版本号||String||"0.0.0"||是|| || ||resVer||资源包版本号||int||0||是|| || ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回格式** > html **返回数据** html页面，内嵌JSON格式的附加信息，以及点击交互的跳转协议[[BR]] 附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾[[BR]] 附加信息： ||= 爆料类型 =||= 附加信息内容 =|| ||优惠、海淘、发现||#见data1#|| ||晒物、经验||#见data2#|| {{{ #data1#包含： { topicId: 13253,//爆料id topicType: 1,//0优惠，1海淘，2 发现 url: http://best.pconline.com.cn/discovery_art.jsp?topicId=$topic.topicId //用于评论数 artUrl:"http://best.pconline.com.cn/youhui/125405.html",//pc地址，用于分享 title: $topic.shortTitle + $topic.price + $topic.sectionDesc wxTitle:【今日聚超值_栏目】+$topic.title||topic.shortTitle+" "+$topic.price（其中栏目为具体的typeName,0,1,2时显示title,3,4时显示为shortTitle）, date: $topic.pubDate author: $topic.createNamePrefix purchasingNum: $topic.purchasingCount.totalCount firstPic: $topic.cover(获取350x350大小的) bestBuyLink:"bestbuy://topic-1.cc", //直达链接，可能是自定义的协议或者普通的url commentCount:245 //评论数 commentId:45 //评论id iphoneResVer:21000 //模板版本号（iOS请求时返回） androidResVer:21000 //模板版本号（Android请求时返回） isOfficialPurchasing: 0 //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】 } #data2#包含： { topicId: 13253, //爆料id topicType: 3, //3 晒物，4经验 url: http://best.pconline.com.cn/discovery_art.jsp?topicId=$topic.topicId artUrl:"http://best.pconline.com.cn/youhui/125405.html",//pc地址，用于分享 title: $topic.shortTitle + $topic.price + $topic.sectionDesc wxTitle:【今日聚超值_栏目】+$topic.title||topic.shortTitle+" "+$topic.price（其中栏目为具体的typeName,0,1,2时显示title,3,4时显示为shortTitle）, date: $topic.pubDate author: $topic.createNamePrefix purchasingNum: $topic.purchasingCount.totalCount firstPic: $topic.cover,(获取350x350大小的) commentCount:245 //评论数 commentId:45 //评论id iphoneResVer:21000 //模板版本号（iOS请求时返回） androidResVer:21000 //模板版本号（Android请求时返回） isOfficialPurchasing: 0 //0不支持官方代购，1支持官方代购【V2.2.0需求:新增字段】 } }}} 跳转协议：[[BR]] 优惠/海淘/发现 详情终端页:[[BR]] 正文字号的问题，跟前端和设计确认了，设计稿的尺寸到制作稿时要减半，所以正文的大中小字号应该分别为19、17、15 ||=协议=||=参数说明=||=触发事件=|| ||pconlinebestbuy://best-coupon-detail/giftId||giftId：优惠券id||点击爆料详情终端页的"优惠券"内时触发，进入优惠券详情|| ||pconlinebestbuy://best-big-photo/topicId?curIndex={curIndex}||topicId：爆料id；curIndex：图片序号||点击爆料详情终端页的任一张图片时触发，浏览大图 || ||pconlinebestbuy://best-shop-list/topicId||topicId：爆料id||点击爆料详情终端页的"有**家商家可代购"时触发，进入商家列表|| ||pconlinebestbuy://best-outer-web/?url={url}||url：代购地址||点击爆料详情终端页底部的"推荐代购商家"时触发，进入商家淘宝商品外链（此处需要计数器，此url尾加对应的类型，计数由app做，url添加尾字符由best提供，代购页面跳转协议中的url后带上#Purchase，商家购买页面跳转协议中的url后带上#GoSeeIt）|| [[BR]] 晒物详情终端页:[[BR]] ||=协议=||=参数说明=||=触发事件=|| ||pconlinebestbuy://best-big-photo/topicId?curIndex={curIndex}||topicId：爆料id；curIndex：图片序号||点击爆料详情终端页的任一张图片时触发，浏览大图 || ||pconlinebestbuy://best-outer-web/?url={url}||url：代购地址||点击爆料详情终端页底部的"推荐代购商家"时触发，进入商家淘宝商品外链|| 经验详情终端页:[[BR]] ||=协议=||=参数说明=||=触发事件=|| ||pconlinebestbuy://best-big-photo/topicId?curIndex={curIndex}||topicId：爆料id；curIndex：图片序号||点击爆料详情终端页的任一张图片时触发，浏览大图 || [[BR]] 晒物及经验详情页面，头图采用hdCover,按hd=0则取hdCover的400x200尺寸,hd=1则取hdCover的600x300尺寸 ---------- === 1.3商品选择wap页 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/goods/showGoods.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/goods#商品选择 商品选择] **说明** > 商品选择页面 **缓存时间** > 无 **提交方式** > GET **是否需要登录** > 否 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || topicId || 爆料id || string || "" || 是 || || ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| **返回格式** > html **返回数据** > html页面 操作协议：[[BR]] 关闭页面点击协议：pcaction://close-webpage [[BR]] 确认商品点击协议：pcaction://finish-choosing/商品outerId （不直接采用页面跳转协议，因为进入订单确认页需要先登录） [[BR]] ---------- === 1.4根据商品编码获取商品信息 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/goods/checkGoods.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/goods#商品信息确认 商品信息确认] **说明** > 根据商品编码获取商品信息 **缓存时间** > 无 **提交方式** > GET **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || outerId || 商品outerId || string || "" || 是 || || || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" data: { goodsItemId: 123456, outerId: BO1234564, //outerId enName: "ECCO Men's Dress Moccasin Penny Loafer", //商品标题 parameter: "Size: 42 M EU / 8-8.5 D(M) US|Color: Black", //商品参数 有些商品没有参数 此项为"" imgUrl: xxx.xxxx..., //商品图片 cnPrice: 123.00, //人民币单价 frPrice: 20.00, //美元单价 tariffCharge: 120.00, //关税 expCharge: 123.00, //运费 totalPrice: 100000.00, //订单总价 mallId: 123, //电商id mallName: "美国亚马逊" //电商名称 } } }}} ---------- === 1.5获取默认收货地址 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/useraddress/getDefaultAddress.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#获取默认收货地址 获取默认收货地址] **说明** > 获取默认收货地址 **缓存时间** > 无 **提交方式** > GET **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.6校验订单 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > **后端接口文档** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.7提交订单 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > - **后端接口** > http://best.pconline.com.cn/appIntf/order/createOrder.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/order#提交订单 提交订单] **说明** > 提交订单 **缓存时间** > 无 **提交方式** > POST **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || outerId || 商品outerId || string || "" || 是 || || || addrId || 用户地址id || string || "" || 是 || || **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" data: { orderId: 123456//订单id } } }}} ---------- === 1.8支付反馈wap页 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/pay/feedback.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/pay#支付反馈 支付反馈] **说明** > 提示用户支付成功或失败的页面 **缓存时间** > 无 **提交方式** > POST **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || orderId || 订单id || int || 0 || 是 || || || success || 支付是否成功 0失败， 1成功 || int || 0 || 是 || || || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || **返回格式** > html **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.9官方代购服务条款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: "请求成功" } }}} === 1.10一键海淘须知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: "请求成功" } }}} ---------- == 2 地址管理 == === 2.1添加收货地址 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/useraddress/addUserAddress.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#添加收货地址 添加收货地址] **说明** > 添加收货地址 **缓存时间** > 无 **提交方式** > POST **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || || name || 收货人名字 || string || "" || 是 || || || province || 省份 || string || "" || 是 || || || city || 城市 || string || "" || 是 || || || county || 县区 || string || "" || 是 || || || phone || 手机号码 || string || "" || 是 || || || detail || 详细地址 || string || "" || 是 || || || idcardNo || 身份证号码 || string || "" || 是 || || || idcardImga || 身份证正面链接 || string || "" || 是 || || || idcardImgb || 身份证反面链接 || string || "" || 是 || || || postcode || 邮政编码 || string || "" || 是 || || || isdefault || 默认地址 || int || 0 || 否 || || **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.2上传身份证 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > **后端接口文档** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.3收货地址列表 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/useraddress/listUserAddress.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#获取用户的地址列表 获取用户的地址列表] **说明** > 获取用户的地址列表 **缓存时间** > 无 **提交方式** > GET **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || **返回格式** > json **返回数据** {{{#!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否 } ] } }}} ---------- === 2.4设置默认收货地址 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > 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 || "" || 是 || || **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.5删除收货地址 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/useraddress/deleteUserAddress.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#删除地址 删除地址] **说明** > 删除地址 **缓存时间** > 无 **提交方式** > POST **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || addrId || 用户地址id || string || "" || 是 || || || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.6修改收货地址 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > http://best.pconline.com.cn/appIntf/useraddress/updateUserAddress.jsp **后端接口文档** > [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/useraddress#修改收货地址 修改收货地址] **说明** > 修改收货地址 **缓存时间** > 无 **提交方式** > POST **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || || addrId || 用户地址id || string || "" || 是 || || || name || 收货人名字 || string || "" || 是 || || || province || 省份 || string || "" || 是 || || || city || 城市 || string || "" || 是 || || || county || 县区 || string || "" || 是 || || || phone || 手机号码 || string || "" || 是 || || || detail || 详细地址 || string || "" || 是 || || || idcardNo || 身份证号码 || string || "" || 是 || || || idcardImga || 身份证正面链接 || string || "" || 是 || || || idcardImgb || 身份证反面链接 || string || "" || 是 || || || postcode || 邮政编码 || string || "" || 是 || || || isdefault || 默认地址 || int || 0 || 否 || || **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- == 3 订单管理 == === 3.1订单列表 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > 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 || "" || 是 || || **返回格式** > json **返回数据** {{{#!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 || "" || 是 || || **返回格式** > json **返回数据** {{{#!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 || "" || 是 || || **返回格式** > json **返回数据** {{{#!java { status: 1, msg: "请求成功", data: { orderId:123456 //修改的订单id } } }}} ---------- === 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: "请求成功" } }}} ---------- == 4 服务协议与举报 == === 4.1服务协议wap页 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > （待补充） **后端接口文档** > （待补充） **说明** > 太平洋网络服务条款及使用协议 **缓存时间** > 无 **提交方式** > GET **是否需要登录** > 否 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| **返回格式** > html **返回数据** > html页面 ---------- === 4.2举报wap页 === [[BR]] **需求：**[[BR]] 1、新接口；[[BR]] **mrobot接口** > （待补充） **后端接口** > （待补充） **后端接口文档** > （待补充） **说明** > 太平洋网络服务条款及使用协议 **缓存时间** > 无 **提交方式** > GET **是否需要登录** > 是 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| || type || 入口 0爆料终端页， 1评论列表 || int || 0 || 否 || 按需求决定是否需要 || || common_session_id(cookie参数) || 登录sessionId || string || "" || 是 || || **返回格式** > html **返回数据** > html页面 ----------