Changes between Initial Version and Version 1 of pconline_3.7.0/interface

Timestamp:

01/05/2015 12:06:07 PM (11 years ago)

Author:

tianjie

Comment:

电脑网4.0.0接口文档地址迁移到pconline_3.7.0；第一版内容来自pconline_4.0.0地址中37版本（最后修改者wuchangbo）

pconline_3.7.0/interface

@@ +1 @@
+== 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 首页 - 资讯列表] ===
+{{{
+备注：此接口返回资讯消息列表，在返回字段里增加资讯类型
+ informationType = 0,     //其他
+ informationType = 1,     //文章
+ informationType = 2,     //帖子
+ informationType = 3,     //图集
+ informationType = 4,     //新增直播类型
+ informationType = 5,     //新增专题类型
+ informationType = 6,     //新增聚超值类型
+ informationType = 7      //推广类型(广告)要求：1、17-18.5字， 2、加“推广”标签，3、要求能打开自己文章页也可以用webview打开客户指定网页。
+ 专题类型时，to-uri字段指定专题页网址，且必须包含“type=zt”(旧版本就已经规定过);而且必须包含“browser=commonWebView”参数（表示用专题webview打开）;参数“showShareButton={0或者1}”表示是否显示分享按钮，0不显示，1显示
+ mrobot接口：http://mrobot.pconline.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20
+ 文章页，需要提供只读字段（readonly  true表示只读,false表示可读可评），以前接口就应该有该字段
+
+ 后端接口：无
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+         pageNo=页码
+         pageSize=一页条数，默认20，最大500
+ 返回参数：
+ {
+     "articleList": [   //备注：此处无专题类型
+        {
+            "bigImage": "http://img0.pconline.com.cn/pconline/1409/19/5460676_51_1k6tu9yn_thumb.jpg",
+            "cmtCount": 文章评论数,
+            "id": 文章id,
+            "image": 文章图片地址,
+            "pubDate": 发布时间,
+            "title": 标题,
+            "url": 文章详情地址,
+            "readonly":true, 
+            "informationType": 资讯类型
+        }
+    ],
+    "focus": [      //备注：此处无专题类型
+        {
+            "counter": "",
+            "id":  文章id,
+            "image": 文章图片地址,,
+            "pubDate": 发布时间,
+            "title": 标题,
+            "url": 文章详情地址,
+            "readonly":true, 
+            "informationType": 资讯类型
+        }
+    ],
+    "topArticle": [     //备注：只有这里有专题类型
+        {
+            "image": "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/19/c2/38772308_1411119899458_width600.jpg",
+            "preView": "其他类型的资讯，用全屏webview打开，类似聚超值类型",
+            "pubDate": "2014-10-09",
+            "seq": 7,
+            "title": "LG G3移动版仅售3199元 Acer游戏本5K5历史新低",
+            "to-uri": "http://g.pconline.com.cn/best/list_288.html?isShowHeader=0&ad=7265",
+            "updateAt": 1412784000000,
+            "informationType": 0    //其他类型
+        },
+        {
+            "cmtCount": 26,
+            "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c4/39422400_1412824208134_1024x1024.jpg",
+            "preView": "64位双4G快时代！酷比魔方&联发科技4G战略发布会",
+            "pubDate": "2014-10-09",
+            "seq": 8,
+            "title": "快时代！酷比魔方&联发科技4G战略发布会 参与互动送平板",
+            "to-uri": "pconlinebrowser://information-article/322?template=live",
+            "updateAt": 1412784000000,
+            "informationType": 1    //文章类型
+        },
+        {
+            "floorCount": 9,
+            "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c3/39418150_1412820169882_1024x1024.jpg",
+            "preView": "HTC发布的奇特造型RE相机新品，你喜欢吗？",
+            "pubDate": "2014-10-09",
+            "seq": 5,
+            "title": "HTC发布的奇特造型RE相机新品，你喜欢吗？",
+            "to-uri": "pconlinebrowser://bbs-topic/51812318",
+            "updateAt": 1412784000000,
+            "informationType": 2    //论坛类型
+        },
+        {
+            "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/09/c5/39426075_1412827383297_1024x1024.jpg",
+            "imgCount": 17,
+            "preView": "HTC Desire Eye手机和RE相机图赏\t",
+            "pubDate": "2014-10-09",
+            "seq": 6,
+            "title": "HTC Desire Eye手机和RE相机图赏\t",
+            "to-uri": "pconlinebrowser://album-photo/13404",
+            "updateAt": 1412784000000,
+            "informationType": 3    //图集类型
+        },
+        {
+            "cmtCount": 279,
+            "image": "http://img.pconline.com.cn/images/upload/upc/tx/itbbs/1410/08/c6/39379595_1412740065734_1024x1024.jpg",
+            "preView": "[图文直播]HTC自拍神器旗舰新品发布会",
+            "pubDate": "2014-10-09",
+            "seq": 12,
+            "title": "HTC自拍神器旗舰新品发布会回顾  Desire Eye手机及RE相机发布",
+            "to-uri": "pconlinebrowser://information-article/323?template=live",
+            "updateAt": 1412784000000,
+            "informationType": 4    //直播类型
+        },
+        {
+            "image": "http://img0.pcauto.com.cn/pcauto/1410/03/g_5242861_1412322026811_240x160.jpg",
+            "preView": "2014巴黎车展：12款重磅SUV/即将引进",
+            "pubDate": "2014-10-09",
+            "seq": 17,
+            "title": "2014巴黎车展：12款重磅SUV/即将引进",
+            "to-uri": "http://www1.pcauto.com.cn/app/cheshi/index.html?type=zt&fromapp=1&browser=commonWebView",
+            "updateAt": 1412784000000,
+            "informationType": 5    //专题类型 
+        },
+        {
+            "image": "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/19/c2/38772308_1411119899458_width600.jpg",
+            "preView": "今日聚超值",
+            "pubDate": "2014-10-09",
+            "seq": 7,
+            "title": "LG G3移动版仅售3199元 Acer游戏本5K5历史新低",
+            "to-uri": "http://g.pconline.com.cn/best/list_288.html?isShowHeader=0&ad=7265",
+            "updateAt": 1412784000000,
+            "informationType": 6    //聚超值类型
+        }
+    ],
+     "topFocus": [      //备注：此处无专题类型
+        {
+            "cc-uri": "",
+            "image": "http://imgad0.pconline.com.cn/ivy/image/20149/25/14116394470770.jpg",
+            "seq": 3,
+            "title": "广告",
+            "to-uri": "http://ivy.pconline.com.cn/adpuba/click?adid=334508&id=pc.khd.zx.jdt.",
+            "updateAt": 1412824722772,
+            "vc-uri": "http://ivy.pconline.com.cn/adpuba/show?adid=334508&id=pc.khd.zx.jdt.&media=js"
+        }
+    ],
+    ...
+    "total": 文章总数量  
+ }
+}}}
+
+
+=== 2.2 [=#point202 首页 - 评论列表] ===
+{{{
+备注：获取文章评论（需要提供户头像字段,userImg）
+ 请求URL：http://mrobot.pconline.com.cn/v3/cmt/new_topics/13118127?reverse=0&pageNo=1&pageSize=20
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        topicId：主题ID
+        articleId：文章ID
+        reverse：排序方式：0  倒序； 1 正序
+        pageNo：页码
+        pageSize：每页行数
+ 返回参数:
+{
+    "comments": [
+        {
+            "1": {
+                "client": "1",                      //客户端标识
+                "content": "1499  我买！",          //评论内容
+                "floor": "25",                      //楼层
+                "id": "38918354",                   //评论id
+                "name": "amumuANZ",                 //显示名称
+                "time": "2014-12-30 11:39:32",      //评论时间
+                "userId": "34444661",               //用户ID
+                "userImg": "http://****"            //用户头像
+            },
+            "current": "1",                         
+            "expand": false,                        //是否展开
+            "support": "0"                          //顶的数量
+        },
+        {
+            "1": {
+                "client": "2",
+                "content": "带通话功能就买。",
+                "floor": "24",
+                "id": "38918344",
+                "name": "来自Android客户端网友",
+                "time": "2014-12-30 11:39:22",
+                "userId": "0"
+                "userImg": "http://****"            //用户头像
+            },
+            "current": "1",
+            "expand": false,
+            "support": "0"
+        }
+    ],
+    "pageCount": 2,
+    "pageNo": 1,
+    "total": 25
+}
+ 
+}}}
+
+
+=== 2.3 [=#point203 首页 - 评论顶踩] ===
+{{{
+备注：顶踩评论(评论取消顶踩接⼝，如果⽤户登录，则传common_session_id，如果⽤户没登录，则不传)
+ 请求URL：http://cmt.pconline.com.cn/action/comment/support_json.jsp?cid=26821494&sp=1&common_session_id=****
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        cid：评论ID
+        sp＝1（顶数量＋1）  sp=-1(顶数量-1)
+ 返回参数:
+{
+    "support": 3,                     //顶数量
+    "floor": 3,                       //楼层   
+    "status": 0,                      //状态，0表示成功
+    "topicId": 13118127,             //
+    "postId": 26821494
+}
+ 
+}}}
+
+
+=== 2.4 [=#point204 产品库-品牌筛选列表] ===
+{{{
+ 备注:推荐品牌列表
+ 请求URL:http://mrobot.pconline.com.cn/v2/product/models/criterion/{分类id}  (筛选接口需要持新的筛选功能；⽀持“品牌选项”、 “更多选项”使多选； “价格选项”、 “排序选项”使单选)
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：无
+返回参数：
+{
+    "criterion": [
+        {
+            "cris": [
+                {
+                    "cId": "22586",
+                    "count": "220",
+                    "name": "三星",
+                    "value": 22586
+                },
+                {
+                    "cId": "46291",
+                    "count": "95",
+                    "name": "HTC",
+                    "value": 46291
+                }
+            ],
+            "name": "品牌",
+            "value": "品牌"
+        },
+        {
+            "cris": [
+                {
+                    "count": "1000",
+                    "criId": "167",
+                    "name": "1000元以下",
+                    "value": "1 TO 999"
+                },
+                {
+                    "count": "435",
+                    "criId": "169",
+                    "name": "1000-1500元",
+                    "value": "1000 TO 1500"
+                },
+                {
+                    "count": "337",
+                    "criId": "170",
+                    "name": "1500-2000元",
+                    "value": "1500 TO 2000"
+                },
+                {
+                    "count": "202",
+                    "criId": "171",
+                    "name": "2000-3000元",
+                    "value": "2000 TO 3000"
+                },
+                {
+                    "count": "93",
+                    "criId": "173",
+                    "name": "3000-4000元",
+                    "value": "3000 TO 4000"
+                },
+                {
+                    "count": "86",
+                    "criId": "3268",
+                    "name": "4000元以上",
+                    "value": "4001 TO 9999999"
+                }
+            ],
+            "name": "价格",
+            "value": "price_100"
+        },
+        {
+            "cris": [
+                {
+                    "count": "1000",
+                    "criId": "4927",
+                    "name": "GSM",
+                    "value": "GSM"
+                },
+                {
+                    "count": "731",
+                    "criId": "4931",
+                    "name": "TD-SCDMA(移动3G)",
+                    "value": "TD-SCDMA(移动3G)"
+                },
+                {
+                    "count": "1000",
+                    "criId": "4929",
+                    "name": "WCDMA(联通3G)",
+                    "value": "WCDMA(联通3G)"
+                },
+                {
+                    "count": "345",
+                    "criId": "4930",
+                    "name": "CDMA2000(电信3G)",
+                    "value": "CDMA EV-DO(电信3G)"
+                },
+                {
+                    "count": "90",
+                    "criId": "4934",
+                    "name": "双模(CDMA+GSM)",
+                    "value": "双模"
+                }
+            ],
+            "name": "更多",
+            "value": "更多"
+        },
+        {
+            "cris": [
+                {
+                    "count": "634",
+                    "criId": "12747",
+                    "name": "按价格",
+                    "value": "按价格"
+                },
+                {
+                    "count": "608",
+                    "criId": "14266",
+                    "name": "按字母",
+                    "value": "按字母"
+                }
+            ],
+            "name": "排序",
+            "value": "排序"
+        }
+    ]
+}
+}}}
+
+
+=== 2.5 [=#point205 产品库-品牌筛选列表] ===
+{{{
+  备注:进入找产品页，选择产品分类，进入品牌列表，选择筛选，选择筛选条件之后查询
+ 请求URL:http://mrobot.pconline.com.cn/v3/product/models/search/{分类id}?pageNo=1&orderId=1
+ HTTP请求方式：post
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：{
+queryJson:{"品牌":["三星","苹果"],"价格":["1000元以下","4000元以上"],"更多":["TD-SCDMA(移动3G)","TD-SCDMA(移动4G)"],"屏幕大小":["14.0 TO 14.9","15.0 TO 15.9","13.0 TO 13.9"],"产品定位":["实用普及本","商用办公本","游戏影音本"],"品牌":[23906],"price_100":["3000 TO 3999"]}//查询的条件
+pageNo:1//页码
+orderId:1//排序条件
+}
+返回参数：
+返回参数：{
+data: [
+{
+   hotNew: 0,
+   id: 548557,
+   idxPic: "http://img.pconline.com.cn/images/product/5485/548557/01_cn.jpg",
+   is-ultrabook: 0,
+   items: [
+     "处理器",
+     "Intel Core i5-3337U(1.8GHz/L3 3M)",
+     "操作系统",
+     "Windows 8",
+     "内存容量",
+     "6GB",
+     "硬盘容量",
+     "500GB",
+     "屏幕尺寸",
+     "15.6英寸",
+     "分辨率",
+     "1366×768",
+     "显卡芯片",
+     "AMD Radeon HD 8730M,+Intel HD 4000"
+    ],
+    noPriceMsg: "新品",
+    price: 3999,
+    shortName: "戴尔Inspiron灵越 15R(Ins15RD-2628)",
+    url: "http://mrobot.pconline.com.cn/v3/product/abstact/548557"
+}，
+]，
+pageCount: 1,
+pageNo: 1,
+pageSize: 25,
+total: 2
+}
+}}}
+
+
+=== 2.6 [=#point206 图赏-推荐图集] ===
+{{{
+ 备注：滚动到图集最后一张图后显示推荐图集
+ 请求URL:http://mrobot.pconline.com.cn/v2/photo/recommendAlbums
+ HTTP请求方式：get
+ 是否需要登录：否
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：15分钟
+ 请求参数：无
+ 返回参数：
+ [
+   {
+     "id": 130583,//图集id
+     "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图，尺寸待定
+     "photoCount": "10",//图片数
+     "title": "图集标题"
+   }
+ ]
+}}}
+
+
+=== 2.7 [=#point207 个人中心-用户信息] ===
+{{{
+ 备注：个人中心，登录之后的用户信息
+ 请求URL:http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo
+ HTTP请求方式：get
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        uid：用户ID,如果没有此参数则返回当前用户信息
+ 返回参数：
+        {
+            "image":头像
+            "level":用户级别
+            "name":用户名
+            "nickname":用户昵称
+            "userId":用户ID
+            "friends":关注好友数
+            "fans":粉丝数,
+            //以下信息本人登陆才返回
+            "birthday":983462400000,
+            "sex":1,//0未知 1男 2女
+            "cityId":370100,
+            "cityName":"济南市",
+            "provinceName":"山东省",
+            "phoneNum":"",
+            "address":"",
+            "zipCode":"",
+            "realName":""
+        }
+}}}
+
+=== 2.8 [=#point208 个人中心-获取粉丝,关注列表] ===
+{{{
+ 备注：返回包括粉丝,关注列表
+ 请求URL: http://my.pconline.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8
+ HTTP请求方式：get
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数:
+        accountId：用户ID,如果没有改参数的话则返回当前用户的好友列表
+        act：findFocus为关注,findFocusBy为粉丝
+        pageNo：页码
+        pageSize：页长度
+        common_session_id
+        req_enc：UTF-8
+        resp_enc：UTF-8
+ 返回参数：
+         {
+             "total":18,
+             "pageCount":2,
+             "pageNo":1,
+             "pageSize":20,
+             "resultList":[
+                            {
+                                 "accountId":用户ID
+                                 "focusNum":关注好友数
+                                 "fanNum":粉丝数
+                                 "nickName":用户昵称
+                                 "image":头像
+                             }
+                         ]
+         }
+}}}
+
+
+=== 2.9 [=#point209 个人中心-收发私信列表] ===
+{{{
+ 备注：收到与发出的私信列表
+ 请求URL：http://mrobot.pconline.com.cn/v3/bbs/getMessageList?type=1&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&siteId=2&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
+ HTTP请求方式：get
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        type：私信类型（1 收到的私信； 0 发出的私信）
+        siteId：网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网）
+        status：私信状态(-1为已读和未读，0表示未读，1表示已读)
+        pageNo：页码
+        pageSize：一页条数，默认20，最大500
+        common_session_id
+        req_enc：UTF-8
+        resp_enc：UTF-8
+ 返回参数：
+        {
+            total: 总的条数
+            pageNo: 页码
+            pageCount: 页数
+            pageSize: 每页条数
+            resultList:{
+                        id: 消息ID
+                        content: 消息内容
+                        createTime: 发送时间
+                        status: 阅读状态
+                        accountId: 用户ID
+                        senderId: 发送者ID
+                        receiverNickname:发送者昵称
+                        receiverFace:头像
+                        replyId: 回复ID
+                        showStatus: 显示状态
+                    }
+        }
+}}}
+
+
+=== 2.10 [=#point2010 个人中心-发私信接口] ===
+{{{
+  备注：发私信接口
+ 请求URL:http://bip.pconline.com.cn/intf/message.jsp
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        accountId：用户ID
+        act=create
+        accountId:发送给某个用户
+        content:消息内容
+        captcha:验证码
+        req_enc：UTF-8
+        resp_enc：UTF-8
+ (说明：发送限制)
+ 1.post
+ 2.验证码
+ 3.黑名单
+ 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户
+ 5.发送频率 50次/ID/24H
+ 6.白名单最多一次发送50个用户，非白名单则每次只能发一个
+ 7.添加关键词库过滤
+ 返回参数：
+        {code:0,message:"提示"}
+}}}
+
+=== 2.11 [=#point2011 个人中心-修改昵称] ===
+{{{
+  备注：修改昵称
+ 请求URL：http://my.pconline.com.cn/intf/syncNickName.jsp
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        req_enc：UTF-8
+        resp_enc：UTF-8
+        nickName：昵称
+        act：save
+ 
+ 返回参数：
+        {"code":0}表示成功, {"code":非0,"message":"提示"}
+}}}
+
+=== 2.12 [=#point2012 个人中心-修改头像] ===
+{{{
+  备注：修改头像
+ 请求URL：http://upc.pconline.com.cn/upload_head.jsp
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：禁用缓存
+ 缓存时间：无
+ 请求参数：
+        二进制图片数据
+ 返回参数：
+        成功：{retCode: 0} 失败：{retCode: xxx}
+}}}
+
+
+=== 2.13 [=#point2013 个人中心-关注&取消关注] ===
+{{{
+ 备注：关注&取消关注
+ 请求URL：http://m.pconline.com.cn/bip/intf/focus.jsp
+ HTTP请求方式：post
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        act=add|delete(add:关注,delete:取消关注)
+        accountId=xxxxxx 当前用户ID
+        friendId=xxxxxx 关注用户ID
+        req_enc：UTF-8
+        resp_enc：UTF-8
+        common_session_id
+ 返回参数：
+        {"code":0}成功
+}}}
+
+
+=== 2.14 [=#point2014 个人中心-判断与某用户的关系(关注与非关注)] ===
+{{{
+ 备注：判断与某用户的关系
+ 请求URL：http://m.pconline.com.cn/bip/intf/focus.jsp
+ HTTP请求方式：get
+ 是否需要登录：是
+ 返回格式：json
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        act=isHisFocus
+        accountId=xxxxxx 当前用户ID
+        friendId=xxxxxx 关注用户ID
+        req_enc：UTF-8
+        resp_enc：UTF-8
+        common_session_id
+ 返回参数：
+        0:没关注,1:关注,2:被关注,3:相互关注
+}}}
+
+
+=== 2.15 [=#point2015 个人中心-他人主页] ===
+{{{
+ 备注：获取他人最新动态接口
+ 请求URL：http://mrobot.pconline.com.cn/v3/bbs/newsfeed/{用户ID}
+ HTTP请求方式：get
+ 是否需要登录：是
+ 返回格式：html页面
+ 缓存方式：无
+ 缓存时间：无
+ 请求参数：
+        UID:用户ID
+}}}