Changes between Initial Version and Version 1 of price_api_2.3.0

Timestamp:

11/27/2015 09:59:57 AM (10 years ago)

Author:

oujianqiang

Comment:

--

price_api_2.3.0

@@ +1 @@
+[[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
+
+
+}}}