Changes between Initial Version and Version 1 of pconline_4.2.0/interface

Timestamp:

07/27/2015 10:12:02 AM (11 years ago)

Author:

luzhentao

Comment:

--

pconline_4.2.0/interface

@@ +1 @@
+[[TOC]]
+
+== 1.基本约定 ==
+{{{
+接口通用参数
+req_enc=utf-8(必须放url后面)
+resp_enc=utf-8(必须放url后面)
+common_session_id=xxxx(以cookies中的优先)
+
+接口URL: 接口URL
+必填参数：参数名=xxx(多种情况用括号解析)
+非必填参数：参数名=xxx(多种情况用括号解析)
+说明文档参数：添加某特定参数可以直接看接口文档
+是否需要登录：是,否
+返回格式：json,ssi,xml
+缓存方式：接口缓存，对象缓存
+缓存时间：缓存时间
+返回结果：结果可能情况
+}}}
+
+== 2.接口列表 ==
+=== 2.1 [=#point201 广告接口] ===
+{{{
+
+ URI：http://mrobot.pconline.com.cn/v3/ad
+        请求方式：HTTPS GET
+        说明：广告接口
+参数：
+ 1). device ：设备名
+ 2). resolution ：设备分辨率
+返回(json格式)：
+           {
+    “xxx.xxx.xxx.610”: {
+        "cc-uri": "",
+        "image": "http://imgad0.pconline.com.cn/ivy/image/30.jpg",
+        "informationType": 7,
+        "pubDate": "2015-7-22",
+        "seq": 3,
+        "title": "标题标题标题",
+        "to-uri": "http://ivy.pconline.com.cn/xxxxx",
+        "vc-uri": "http://ivy.pconline.com.cn/xxx"
+    },
+    "pc.khd.zx.qdtdh.":
+       {
+         "ad":
+       {
+        "cc-uri":"",
+        "cc3d-uri":"",
+        "img":"http://imgad0.pconline.com.cn/ivy/image/20157/20/14373778828460.jpg",
+        "to-uri":”http://www.baidu.com”,    //广告跳转链接
+        "vc-uri":"http://ivy.pconline.com.cn/adpuba/show?adid=376153&id=pc.khd.qdt.&media=js",
+        "vc3d-uri":""
+       },
+         "rule":
+       { 
+        "age":3,
+        "delay":0,
+        "interval":1
+        }
+      }
+    }
+
+注：“xxx.xxx.xxx”是广告标识类型，由广告系统自定义名称，后面610是栏目ID，如apple栏目是610。
+
+}}}
+
+=== 2.2 [=#point202 首页文章列表特型展示] ===
+{{{
+   URL: http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1
+       请求方式：HTTP GET
+       说明：首页资讯列表 - 头条
+返回（json格式）:
+普通文章类型：
+
+   {
+
+        "bigImage": “http://img0.pconline.com.cn/pconline/c_thumb.jpg",
+
+        "cmtCount": 0,
+
+        "id": “1234567”,
+
+        "image": “http://img0.xxx/123.jpg”,  //兼容旧版，原字段保留
+
+        "imageHor": “http://img0.xxx/1.jpg”, //横图情况，若没有横图这个字段去掉
+
+       "informationType": 1,
+
+        "pubDate": "2015-7-22",
+
+        "title": "标题标题标题",
+
+        "url": “http://ivy.pconline.com.cn/xxxxx.html",
+
+   }
+
+
+
+
+
+图集类型：
+
+   {
+
+        "image": “http://imgxxx/c_thumb.jpg”, //兼容旧版，原字段保留
+
+        “imgUrls”: [
+
+                    “http://imgxxx/c_thumb1.jpg”,
+
+                    “http://imgxxx/c_thumb2.jpg”,   //图集三张缩略图情况
+
+                    “http://imgxxx/c_thumb3.jpg”
+
+                   ],
+
+        "imgCount": 15,
+
+        "informationType": 1,
+
+        "isExtend": “0”,
+
+        "preView": “文字文字文字”,
+
+        "pubDate": “2015-7-22",
+
+        "seq": 7,
+
+        "title": "文字文字文字",
+
+        “to-uri": “pconlinebrowser://album-photo/14686”,
+
+        "updateAt": 1437494400000
+
+   }
+
+
+
+直播类型：
+
+   {
+
+       "cmtCount": 333,
+
+        "id": “471”,
+
+        "image": “http://img0.xxx/123.jpg”,  //兼容旧版，原字段保留
+
+        "imageHor": “http://img0.xxx/1.jpg”, //横图
+
+        "informationType": 4,
+
+        "seq": 7,
+
+        "pubTime": “2015年6月2日至6日",
+
+        "status": "直播已结束",
+
+        "title": "标题标题标题",
+
+        "url": “http://ivy.pconline.com.cn/xxxxx.html",
+
+   }
+
+
+
+专题类型：
+
+   {
+
+        "image": “http://imgxxx/c_thumb.jpg”, //兼容旧版，原字段保留
+
+        "imageHor": “http://img0.xxx/1.jpg”, //横图情况
+
+       "informationType": 5,
+
+        "isExtend": “0”,
+
+        "preView": “文字文字文字”,
+
+        "pubDate": “2015-7-22",
+
+        "seq": 7,
+
+        "title": "文字文字文字",
+
+        “to-uri": “pconlinebrowser://album-photo/14686”,
+
+        "updateAt": 1437494400000
+
+   }
+
+}}}
+
+=== 2.3 [=#point203 产品库 - 排行榜列表] ===
+{{{
+URI：
+        请求方式：HTTP GET
+        说明：产品库 - 排行榜列表
+       返回(json格式)
+{
+"data":
+[{
+      "id":576986,                                 //产品id
+      "idxPic":"http://img.pconline.com.cn/images/product/5769/576986/q_cn.jpg”,   //图片
+      "price":5288,                                 //价格
+      "shortName":"三星Galaxy S6”,     //名称
+      "commentScore”:90,                     //评分
+      “cmtNum”:12”,                              //评价数
+}
+]
+}
+
+读取数据：
+
+ 手机排行：http://product.pconline.com.cn/hot/mobile/
+
+相机排行：http://product.pconline.com.cn/hot/dc/
+
+笔记本排行：http://product.pconline.com.cn/hot/notebook/
+
+超极本排行：http://product.pconline.com.cn/hot/notebook/c12087/
+
+平板排行：http://product.pconline.com.cn/hot/tabletpc/
+
+
+
+不需要分页，一次性获取排行榜列表。列表参数参考普通产品列表页，去掉详细参数，改成评价数。
+
+}}}
+
+=== 2.4 [=#point204 栏目列表] ===
+{{{
+   iOS: http://mrobot.pconline.com.cn/configs/pconline_v7_cms_iphone_channel_tree
+       请求方式：HTTP GET
+       说明：获取栏目列表
+       返回(json格式)
+       {
+ "news":
+[
+      ["1","头条","609”],
+      ["5","Apple","610”],
+      ["2","新闻","611”],
+      ["4","评测","613”],
+      ["11","图赏","859”],
+      ["200","手机","614"],
+      ["10","直播","612"],
+      ["xx”,”视听","xxx”],
+      ["300","笔记本","618”],
+      ["400","平板","619"],
+      ["120",”DIY外设","621”],
+      ["500","相机","620”],
+      ["xx”,”无人机","xxx”],
+      ["600","家电","622"],
+      ["xx”,"智能科技","xxx”],
+      [“xx”,"软件”,"xxx"],
+      ["xx”,”企业圈”,"xxx”],
+      ["xx”,”网络圈”,"xxx”],
+      ["3","导购","616"],
+],
+  "events":
+  [],
+ "product":
+  [],
+ "area":
+  [
+      ["100000", "全国", "6978"],
+      ["110000", "北京", "6978"],
+      ["310000", "上海", "6978"],
+      ["440100", "广州", "6978"],
+      ["440300", "深圳", "6978"],
+      ["500000", "重庆", "6978"],
+      ["210000", "辽宁", "6978"],
+      ["350000", "福建", "6978"],
+      ["330000", "浙江", "6978"],
+      ["450000", "广西", "6978"],
+      ["510100", "成都", "6978"],
+      ["420100", "武汉", "6978"],
+      ["120105", "河北", "6978"],
+      ["230000", "黑龙江", "6978"],
+      ["220403", "西安", "6978"],
+      ["370000", "山东", "6978"],
+      ["430000", "湖南", "6978"],
+      ["410000", "河南", "6978"],
+      ["360000", "江西", "6978"],
+      ["810000", "香港", "6978"],
+      ["440400", "珠海", "6978"],
+      ["340000", "安徽", "6978"],
+      ["460000", "海南", "6978"],
+      ["320000", "江苏", "6978"],
+      ["441900", "东莞", "6978"],
+      ["120000", "天津", "6978"],
+      ["330200", "宁波", "6978"],
+      ["440600", "佛山", "6978"],
+      ["210200", "大连", "6978"],
+      ["130600", "保定", "6978"],
+      ["441700", "阳江", "6621"]
+ ]
+}
+安卓：
+
+安卓端默认定制排序：
+
+ 头条 新闻 评测  图赏 手机 直播 视听(新增) 
+
+ 安卓端备选定制排序：
+
+ 笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件 企业圈(新增) 网络圈(新增) 导购
+
+iOS：
+
+iOS端默认定制排序：
+
+ 头条  Apple 新闻 评测  图赏 手机 直播  视听(新增) 
+
+iOS端备选定制排序：
+
+笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件(iOS端新增) 企业圈(新增) 网络圈(新增) 导购
+
+删除：
+
+需要删除的：
+
+ 行情、超级本、电视、摄像机、MID、企业
+
+}}}