[[TOC]] = 聚超值2.1.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、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.2爆料详情终端页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.3商品信息编辑wap页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.4根据商品编码获取商品信息 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.5获取默认收货地址 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!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-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.7提交订单 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.8支付结果wap页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.9官方代购服务条款wap页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** === 1.10一键海淘须知wap页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 1.8支付结果wap页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- == 2 地址管理 == === 2.1添加收货地址 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!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-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.3收货地址列表 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.4设置默认收货地址 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.5删除收货地址 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 2.6修改收货地址 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- == 3 订单管理 == === 3.1订单列表 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 3.2取消订单 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 3.3确认收货 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ---------- === 3.4订单详情wap页 === [[BR]] **需求：**[[BR]] 1、；[[BR]] **mrobot接口** > **后端接口** > **说明** > **缓存时间** > **提交方式** > GET **是否需要登录** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| ||inReview||审核状态||int||0||否||1-是，0-不是|| **返回** {{{#!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-不是|| **返回** {{{#!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-不是|| **返回** {{{#!java { status: 1, msg: "请求成功" } }}} ----------