[[TOC]]

= 聚超值2.2.0接口文档 = 

== 一.基本约定 ==

{{{
  1.开发机、测试机代理地址：
  mrobot开发机代理：192.168.10.199  端口：1080
  mrobot测试机代理：192.168.10.198  端口：1080
  电脑网应用端测试环境域名  v72.pconline.com.cn:8002
  电脑网应用端线上环境域名  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 跳转协议 ==

{{{

聚超值V2.3.0跳转协议

说明：花括号代表参数值位置，使用时记得去掉花括号并填上对应值。

跳转协议——————————————————————————

---跳至 爆料终端
pconlinebestbuy://best-buy-article/{topicId}?type={type}&isOfficialPurchasing={isOfficialPurchasing}
跳转参数说明：
topicId：爆料id
type：爆料类型  //0优惠，1海淘，2 发现，3 晒物，4经验
isOfficialPurchasing：是否支持官方代购  //0不支持，1支持


---跳至 优惠券详情
pconlinebestbuy://best-coupon-detail/{giftId}
跳转参数说明：
giftId:礼品id（注意，这里是礼品id而不是优惠券id）

---跳至 代购商家
pconlinebestbuy://best-shop-list/{topicId}
跳转参数说明：
topicId：爆料id

---跳至 公共webView
pconlinebestbuy://best-outer-web/?url={url}
跳转参数说明：
url：外链链接

---跳至 大图浏览
pconlinebestbuy://best-big-photo/{topicId}?curIndex={curIndex}&imgUrl={imgUrl}
跳转参数说明：
topicId：爆料id
curIndex：所点击图片的序号（从0算起）
imgUrl：所点击图片的地址链接


操作协议——————————————————————
---关闭页面
pcaction://close

---确认商品
pcaction://finish-choosing?outerId={outerId}
参数说明：
outerId：商品编号

-—-立即付款
pcaction://buy-now?orderId={orderId}&amountPrice={amountPrice}
参数说明：
orderId：订单id
totalPrice：订单总价

---取消订单
pcaction://cancel-order?orderId={orderId}&status={status}
参数说明：
orderId：订单id
status：订单状态

---确认收货
pcaction://confirm-receipt?orderId={orderId}
参数说明：
orderId：订单id

---退款详情
pcaction://see-refund?orderId={orderId}
参数说明：
orderId：订单id

---查看税单
pcaction://see-taxBill?taxBillImageUrl={taxBillImageUrl}
参数说明：
taxBillImageUrl：税单图片链接

---查看 订单详情
pcaction://see-indent-detail?orderId={orderId}
跳转参数说明：
orderId：订单id

---查看 物流详情
pcaction://see-transfer-detail?orderId={orderId}
参数说明：
orderId：订单id

---查看 全部订单
pcaction://see-my-indents?type={type}
参数说明：
type：订单类型 //0全部订单；1待付款订单；2待发货订单；3待收货订单；4已完成订单

---查看 关于关税
pcaction://about-tariff?text={text}
参数说明：
text：关税提示文案

--- 弹窗
pcaction://show-alert?title={title}&msg={msg}
参数说明：
title：弹窗标题（可选）
msg：弹窗内容（必填）

--- 查看 搜索结果
pcaction://search-result?searchType={searchType}&searchCondition={searchCondition}&sectionId={sectionId}
参数说明：
searchType：搜索类型。1 按分类搜索, 2 按电商搜索, 3 按标签搜索, 4 按关键词搜索
searchCondition：搜索条件。1(分类id), 2(电商名称),3(标签名称),4（关键词）
sectionId：默认选择的列表类型。 0优惠，1海淘，2 发现，3 晒物，4经验

--- 查看 爆料相关优惠券
pcaction://show-topic-coupons?topicId={topicId}
参数说明：
topicId：爆料id


}}}