wiki:price_api_2.2.0

Version 2 (modified by oujianqiang, 10 years ago) (diff)

--

Table of Contents

  1. 一.基本约定
  2. 二.接口列表
  3. 1 一键海淘
    1. 1.1优惠、海淘、发现、晒物、经验列表数据接口
    2. 1.2爆料详情终端页
    3. 1.3商品信息编辑wap页
    4. 1.4根据商品编码获取商品信息
    5. 1.5获取默认收货地址
    6. 1.6校验订单
    7. 1.7提交订单
    8. 1.8支付结果wap页
    9. 1.9官方代购服务条款wap页
    10. 1.10一键海淘须知wap页
    11. 1.8支付结果wap页
  4. 2 地址管理
    1. 2.1添加收货地址
    2. 2.2上传身份证
    3. 2.3收货地址列表
    4. 2.4设置默认收货地址
    5. 2.5删除收货地址
    6. 2.6修改收货地址
  5. 3 订单管理
    1. 3.1订单列表
    2. 3.2取消订单
    3. 3.3确认收货
    4. 3.4订单详情wap页
    5. 3.5物流详情wap页
    6. 3.6退款详情wap页

聚超值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优惠、海淘、发现、晒物、经验列表数据接口


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.2爆料详情终端页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.3商品信息编辑wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.4根据商品编码获取商品信息


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.5获取默认收货地址


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.6校验订单


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.7提交订单


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.8支付结果wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.9官方代购服务条款wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

1.10一键海淘须知wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

1.8支付结果wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

2 地址管理

2.1添加收货地址


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

2.2上传身份证


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

2.3收货地址列表


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

2.4设置默认收货地址


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

2.5删除收货地址


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

2.6修改收货地址


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

3 订单管理

3.1订单列表


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

3.2取消订单


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

3.3确认收货


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

3.4订单详情wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

3.5物流详情wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}

3.6退款详情wap页


需求：
1、；

mrobot接口

后端接口

说明

缓存时间

提交方式

GET

是否需要登录

参数

参数名 参数含义 类型 默认值 是否必须 备注
v版本号int0否2.2.0版本传v=2.2.0
inReview审核状态int0否1-是，0-不是

返回 

{
  status: 1,
  msg: "请求成功"
  
}