Changes between Version 5 and Version 6 of pconline_chanpingku/intf

Timestamp:

08/02/2012 11:00:41 AM (14 years ago)

Author:

daiyuwen

Comment:

--

pconline_chanpingku/intf

@@ -58 +58 @@
 
 ===  2. [=#point200 mrobot的接口 ] ===
-{{{
-
-}}}
+mrobot自身的接口，由客户端调用
 
 ===  2.1 [=#point201 产品终端页报价 ] ===
 {{{
+　　HTTP请求方式：get
+    是否需要登录：否
+    请求参数：productID: 类型id
+        areaName：地区名，该参数需要url编码
+        http://mrobot.pconline.com.cn/v2/product/price/priductid
+　　
+        返回参数{
+            报价html:
+                添加“网上比价”按钮，链接：pcaction://comparePrice/{$productId}
+        }
 
 }}}
@@ -70 +78 @@
 {{{
 
+        HTTP请求方式：get
+    是否需要登录：否
+    请求参数：productID: 类型id
+http://mrobot.pconline.com.cn/v2/product/comparePrice/priductid
+        返回参数{
+                网上比价html
+　　每个商城添加一个“购买”按钮，链接到对应商城的产品终端页
+        }
+        
+
+        
+　　类似于
+　　      产品终端-查看所有经销商报价： http://mrobot.pconline.com.cn/v2/product/dealers/{产品id} 
+　　例子： http://mrobot.pconline.com.cn/v2/product/dealers/485270 
 }}}
 
 ===  2.3 [=#point203 产品终端页概述 ] ===
 {{{
-
+HTTP请求方式：get
+    是否需要登录：否
+    请求参数：productID: 类型id
+http://mrobot.pconline.com.cn/v2/product/abstact/priductid
+         返回参数｛·
+             产品概述的html;
+                 添加“进入论坛”按钮：pcaction://bbs-topics/{$bbsid}
+
+         ｝
 }}}
 
 ===  2.4 [=#point204 产品终端页报参数] ===
 {{{
-
+　　 是否需要登录：否
+　　    请求参数：productID: 类型id
+　　http://mrobot.pconline.com.cn/v2/product/detail/priductid
+　　       返回参数｛·
+　　           产品具体参数的html;
+　　       ｝
 }}}
 
@@ -85 +120 @@
 {{{
 
+请求方式：get
+是否需要登录：否
+请求参数：
+　　Id1和id2：是需要对比的两个产品
+　　hideSameParams：真为true，假为false；真则隐藏相同的参数，否则显示所有参数。
 }}}
 
 ===  2.6 [=#point206 请求产品资讯 ] ===
 {{{
-
+getArticleListBySerialId
+http://mrobot.pconline.com.cn/v2/product/information/priductid&ordreId=1&fmt=json 
+
+请求方式：get 
+是否需要登录：否 
+请求参数： 
+
+productId：产品id 
+orderId:排序方式，1为按热度倒序，2为按热度正序，3为按价格倒序，4为按价格正序，5为按日期倒序，6为按日期正序    
+
+返回参数{
+   "productId":1021,
+    "total":20,
+        "orderId":1,
+        "fmt":json,
+        "articleList":[
+       {
+            "id ":1234,
+                "title":"苦逼0",
+                "channel":"评测",
+        
+           }，
+             {
+              "id ":1234,
+                "title":"苦逼0",
+                "channel":"评测",
+      
+           }
+    ]   
+}
+
+id 文章id
+title 标题
+channel 文章栏目
+commentNum 评论数
 }}}
 
 ===  2.7 [=#point207 某产品类型的品牌列表 ] ===
 {{{
-
+ HTTP请求方式：get
+ 是否需要登录：否
+ 请求参数：
+typeID: 产品类型id
+                http://mrobot.pconline.com.cn/v2/product/brand/41234
+            
+        返回参数：
+        {
+        "type":2,
+        
+        "partition":{
+           "recommondBrands":{
+                  "total":3,
+               “brands”:[
+                {
+                    "id": 693,
+                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto
+
+\/1112\/07\/1743776_ACS5050.png",
+                    "letter": "A",
+                    "name": "af"
+                },
+......
+            ]
+           },
+           "totalBrands":{
+                        "total":20,
+                         "sections": [
+        {
+            "brands": [
+                {
+                    "id": 693,
+                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto
+
+\/1112\/07\/1743776_ACS5050.png",
+                    "letter": "A",
+                    "name": "AC瀹濋┈"
+                },
+......
+            ],
+            "index": "A",
+            "rowNum": 3
+        },
+        {
+            "brands": [
+                {
+                    "id": 723,
+                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto
+
+\/1203\/27\/1875156_babosi5050png.png",
+                    "letter": "B",
+                    "name": "宸村崥鏂?"
+                },
+......
+            ],
+            "index": "B",
+            "rowNum": 15
+        },
+                {
+            "brands": [
+                {
+                    "id": 723,
+                    "logo": "http:\/\/img0.pcauto.com.cn\/pcauto
+
+\/1203\/27\/1875156_babosi5050png.png",
+                    "letter": "Z",
+                    "name": "宸村崥鏂?"
+                },
+......
+                
+            ],
+            "index": "Z",
+            "rowNum": 2
+        }
+           }
+        }
+        }
+                
+    type :请求的类型
+        partition-order-by：A,B,C等块内部，品牌的次序；目前没有参数，默认为空
+        partition：分块集
+        recommondBrands：推荐版块集合，
+        totalBrands;品牌的总集合
+        total：版块集合内部元素的总数
+        brands:版块内品牌集合
+        id:品牌id
+        logo:品牌logo图片url
+        letter；品牌名称首字母
+        name:品牌名称
+        sections:品牌的总集合的分块，按字母顺序分
+        index：分块所属的字母
+        rowNum:分块内品牌数量
 }}}
 
 ===  2.8 [=#point208 产品列表 ] ===
 {{{
+类似于老版本分类产品列表： http://mrobot.pconline.com.cn/v2/product/types/{产品分类id}?pageNo=1&orderId=1&fmt=json 
+例子： http://mrobot.pconline.com.cn/v2/product/types/20937?pageNo=1&orderId=1&fmt=json 
+
+　　请求方式：get 
+　　是否需要登录：否 
+　　请求参数： 
+　　
+　　typeID:产品分类id
+　　pageNo：页码 
+　　orderId:排序方式，1为按热度倒序，2为按热度正序，3为按价格倒序，4为按价格正序，5为按日期倒序，6为按日期正序 
+　　fmt：返回格式 
+　　需要添加请求参数 brandID:品牌id
+
 
 }}}
@@ -104 +282 @@
 ===  2.9 [=#point209 产品点评界面 ] ===
 {{{
-
+    HTTP请求方式：get
+    是否需要登录：否
+　　请求参数：productID: 类型id
+　　   http://mrobot.pconline.com.cn/v2/product/comment/productId
+        {
+                添加“我要点评”按钮：pcaction://postComment/{$productId} 
+        }
 }}}
 
 ===  2.10 [=#point210 产品发送评论 ] ===
 {{{
-
+发送参数类似于文章，论坛发送评论。
+    HTTP请求方式：post
+    是否需要登录：都可以
+    请求参数：
+        productid:产品id
+        producturl；产品url
+        score:评分数值
+    content:评论内容
+   isanonymous 是否匿名
+    common_session_Id:用户的author_token
+        
 }}}
 
 ===  2.11 [=#point211 搜索产品（品牌分类统计） ] ===
 {{{
+ HTTP请求方式：get
+    是否需要登录：否
+　　请求参数：kw：查询关键字
+
+Uri :http://mrobot.pcauto.com.cn/v2/price/models/search-type?kw=%E5%AE%9D%E9%A9%AC
+    返回参数：
+        {
+        "kw":"sony",
+        "totle":1000,
+        "types":[
+   {
+   "sid":42123,
+   "name":"手机",
+   "num":100
+ },{
+   "sid":42123,
+　　"name":"笔记本",
+   "num":10
+0
+},{
+   "sid":42123,
+"name":"平板电脑",
+   "num":100
+},{
+   "sid":42123,
+"name":"数码相机",
+   "num":100,
+
+},{
+   "sid":42123,
+"name":"超级本",
+   "num":10
+}
+]
+        }
+
+        kw:搜索关键字(采用UTF-8方式编码),
+        totle:结果集的总数，
+        types:类型的集合,
+        
+        (可以为 产品类型id)
 
 }}}
@@ -119 +354 @@
 ===  2.12 [=#point212 搜索产品（结果列表）] ===
 {{{
-
+        HTTP请求方式：get
+    是否需要登录：否
+    请求参数：kw：查询关键字
+                  type:查询的类型id
+                  pageNo:显示的页码，默认为1；
+              orderId：排序方式，1为按热度倒序，2为按热度正序，3为按价格倒序，4为按价格正序，5为按日期倒序，6为按日期正序 
+http://ks.pconline.com.cn/search.jsp?appName=product&returnType=json&return=smalltype_id,category,shortName,hot_new,id,title,pub_url,pic,summary,price&sort=score:desc,access:desc&perPage=25&pageNo=1&highlight=false&q=55&clusterQuery=cluster_smalltype%3A%B1%CA%BC%C7%B1%BE 
+
+
+Uri:http://mrobot.pconline.com.cn/v2/product/models/search?kw=fa&type=4234&pageNo=1&order=1
+    返回参数：
+        {
+        "kw":"sony",
+        "type":4
+        "pageNo": "1",
+        "orderId":1,
+    "total": 113,
+    "pageCount": 5,
+    "pageSize": 25,
+    "data": [
+         {
+    "is-ultrabook": 0,
+    "id": "503012",
+    "hotNew": "2",
+    "price": "4599",
+    "items": [
+        "相机类型",
+        "卡片数码相机",
+        "有效像素",
+        "1210万像素",
+        "变焦倍数",
+        "无光学变焦",
+        "传感器尺寸",
+        "1\/2.3英寸",
+        "等效焦距",
+        "21mm",
+        "液晶屏尺寸",
+        "3英寸",
+        "高清视频",
+        "1080p 1920×1080逐行",
+        "存储介质",
+        "SD卡,SDHC卡",
+        "重量",
+        "157g(包含存储卡),155g(不包含存储卡)"
+    ],
+    "idxPic": "http:\/\/img.pconline.com.cn\/images\/product\/5030\/503012\/dc_casio_tr150_1_sn.jpg",
+    "shortName": "卡西欧 EXILIM EX-TR150",
+    "url": "http:\/\/mrobot.pconline.com.cn\/v2\/product\/models\/503012"
+                }
+                ..
+        ,{
+    "is-ultrabook": 0,
+    "id": "471231",
+    "hotNew": "0",
+    "price": "288",
+    "items": [
+        "适用类型",
+        "台式机",
+        "电源标准",
+        "ATX,2.31",
+        "额定功率",
+        "350W",
+        "CPU供电接口",
+        "4+4pin",
+        "大4Pin接口",
+        "4个",
+        "SATA接口",
+        "3个",
+        "PFC类型",
+        "被动式PFC",
+        "风扇描述",
+        "一个12CM风扇,散热片"
+    ],
+    "idxPic": "http:\/\/img.pconline.com.cn\/images\/product\/4712\/471231\/pow_tt_450-1_sn.jpg",
+    "shortName": "TT TR2-450",
+    "url": "http:\/\/mrobot.pconline.com.cn\/v2\/product\/models\/471231"
+        }
+       ]
+
+        }
+
+类似于搜索超极本：http://mrobot.pconline.com.cn/v2/product/models/search_ultrabook?keyword=%E8%81%94%E6%83%B3&pageNo=1&order=1
+请求方式：get是否需要登录：否请求参数：
+keyword：搜索关键字，需要url编码pageNo：请求页码order：同产品分类列表
 }}}
 
 ===  2.13 [=#point213 产品搜索热点推荐 ] ===
 {{{
-
+    HTTP请求方式：get
+　　是否需要登录：否
+　　请求参数：
+                fmt:返回格式
+Uri:http://mrobot.pconline.com.cn/v2/product/hotspot
+        
+        返回参数：
+        {
+            "total":3，
+                "fmt":"json",
+                "words":[
+                  {
+                    "name": "三星",
+                  },
+......
+                ]
+                
+        }
+
+
+
+说明：
+total:热点推荐总数
+fmt:返回的格式
+words:热点集合
+name:热点名字
+image:热点名字
 }}}
 
 ===  2.14 [=#point214 产品首页 ] ===
 {{{
-
+HTTP请求方式：get
+　　是否需要登录：否
+Uri:
+http://mrobot.pconline.com.cn/v2/product/information
+分类下方外显该分类排名前三的品牌的名称（例如http://product.pconline.com.cn/mobile/ 页面中，品牌分类的前三个品牌“三星 HTC 诺基亚”）；
 }}}
 
@@ -380 +728 @@
 
 == 5. [=#point500 修改历史 ] ==
+
+2012-08-02:
+    -接口第一版