wiki:pconline_4.2.0/interface

Version 1 (modified by luzhentao, 11 years ago) (diff)

--

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 广告接口

 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 首页文章列表特型展示

   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 产品库 - 排行榜列表

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 栏目列表

   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、企业