pconline_4.2.0/interface – iphone

Wiki

wiki:pconline_4.2.0/interface

Context Navigation

Version 7 (modified by chenziyang, 11 years ago) (diff)
--

Table of Contents

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

1）mrobot接口url： http://mrobot.pconline.com.cn/v3/ad
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：否
请求参数：
      platform   //平台标识；android平台，platform=android；ios平台，platform=ios
      deviceModel   //设备机型 

返回参数：
           {
    “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 首页文章列表特型展示

备注：首页资讯列表 - 头条
1）mrobot接口url：http://mrobot.pconline.com.cn/v2/cms/channels/1?pageSize=20&pageNo=1
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
缓存时间：5分钟
请求参数：

返回参数：
{
"articleList”:
 [
   //普通文章类型
 {
 "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
   }
 ],
"focus":
[],
"pageNo":
1,
"pageSize":
20,
"topArticle":
[],
"topFocus":
[],
"total":
200
}

2.3 产品库 - 排行榜列表

（mrobot已完成开发，请连开发机进行测试）

备注：产品库 - 排行榜列表。不需要分页，一次性获取排行榜列表。列表参数参考普通产品列表页，去掉详细参数，改成评价数。
数据来源：
    手机排行：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/

1）mrobot接口url：http://mrobot.pconline.com.cn/v3/product/rankList
2）后端接口：http://pdhot.pconline.com.cn/api/rankList.jsp
HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：有
缓存时间：1小时
请求参数：
    rlid：分类id，手机701，相机696，笔记本702，超级本697，平板703
返回参数：
{
"data":[
{
      "productId":576986,  //产品id
      "idx2PictureUrl":"http://img.pconline.com.cn/images/product/5769/576986/q_cn.jpg”,  //图片
      "price":5288, //价格
      "name":"三星Galaxy S6”,   //名称
      "commentScore”:90, //评分
      “cmtNum”:12”,  //评价数
}
]
}

2.4 栏目列表

备注：获取栏目列表
需求说明：
（1）安卓：
          安卓端默认定制排序：头条 新闻 评测  图赏 手机 直播 视听(新增) 
          安卓端备选定制排序：笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件 企业圈(新增) 网络圈(新增) 导购
（2）iOS：
          iOS端默认定制排序：头条  Apple 新闻 评测  图赏 手机 直播  视听(新增) 
          iOS端备选定制排序：笔记本 平板 DIY外设(改名) 相机 无人机(新增) 家电 智能科技(新增) 软件(iOS端新增) 企业圈(新增) 网络圈(新增) 导购
（3）删除：
          需要删除的：行情、超级本、电视、摄像机、MID、企业
 
1）mrobot接口url
        iOS：http://mrobot.pconline.com.cn/configs/pconline_v7_cms_iphone_channel_tree
        Android：http://mrobot.pconline.com.cn/configs/pconline_v7_cms_android_channel_tree

HTTP请求方式：get
是否需要登录：否
返回格式：JSON
是否有缓存：无
请求参数：无
返回参数（iOS）：  
 {
 "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"]
 ]
}

2.5 文章终端页

备注：文章终端页有mrobot插入的广告：pc.khd.zx.wztl，需要做广告定向，因此客户端传定向相关参数给mrobot。
1）mrobot接口url：http://mrobot.pconline.com.cn/v3/cms/articles/6681159?articleTemplate=3.6.0&size=20&picRule=2&app=pconlinebrowser&template=(null)&channelId=0&serialId=0&appVersion=4.1.0
2）后端接口：
HTTP请求方式：get
是否需要登录：否
返回格式：html
是否有缓存：
请求参数：
      appVersion  //客户端版本，4.2.0
      platform   //平台标识；android平台，platform=android；ios平台，platform=ios
      deviceModel   //设备机型 
返回参数：略

Download in other formats:

Plain Text