Changes between Version 5 and Version 6 of app1.x


Ignore:
Timestamp:
04/09/2015 09:11:58 AM (11 years ago)
Author:
pengzhanxuan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • app1.x

    v5 v6  
    1 == 判定是否已签到 == 
    2  
    3 > 线上:[http://best.pconline.com.cn/intf/iphone/checkSignInStatus.jsp /intf/iphone/checkSignInStatus.jsp] 
    4  
    5 **提交方式** 
    6  
    7 > POST 
    8  
    9 **是否需要登录** 
    10  
    11 > 是 
    12  
    13 **缓存方式** 
    14  
    15 > 无 
    16  
    17 **缓存时间** 
    18  
    19 > - 
    20  
    21 **参数** 
    22  
    23 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
    24 ||common_session_id|| - ||String||""||是|| 
    25  
    26 **返回** 
    27  
    28 {{{#!java 
     1[[TOC]] 
     2 
     3== 0.基本约定 == 
     4接口测试说明: 
     5{{{ 
     61.推送账号设置: 
     7        Android测试环境使用: 
     8            jpush_url=http://api.jpush.cn:8800/v2/push 
     9            appKey=76777a5ae568ae5d8914fcb4 
     10            masterSecret=36c389c02bae13229af78915 
     11        iOS测试环境使用对应的测试环境的证书 
     122.DES加密key设置: 
     13        测试环境:desKey: pconline 
     14}}} 
     15 
     16线上环境passport传递登录信息:common_session_id[[BR]] 
     17 
     18测试环境passport传递登录信息:common_session_id1 
     19 
     20== 1.基本约定 == 
     21{{{ 
     221.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 
     23 
     242.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。 
     25    { 
     26        "uri" : "/intf/albums-by-type.jsp", 
     27        "error-desc":"Need you follow uid.", 
     28        "user-notice":"给用户的提示放在这里" 
     29    }` 
     30     
     313.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码: 
     32 
     33        String queryString = request.getQueryString(); 
     34        String requestEncoding = getParam(queryString,"req_enc"); 
     35        String responseEncoding = getParam(queryString,"resp_enc"); 
     36        if(isNotBlank(requestEncoding)){ 
     37            request.setCharacterEncoding(requestEncoding); 
     38        } 
     39        if(isNotBlank(responseEncoding)){ 
     40            response.setCharacterEncoding(responseEncoding); 
     41        } 
     42 
     434.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。 
     44 
     455.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号。 
     46 
     476."2.1 优惠/发现 分类接口【v1.2】 "中的v1.2表示这个版本之后(不包括该版本)的app不调用该接口 
     48 
     49}}} 
     50 
     51== 2.接口列表 == 
     52===  2.1 优惠/发现 分类接口【v1.2】 === 
     53(维护:成荣伟) 
     54{{{ 
     55    url:http://best.pconline.com.cn/intf/iphone/getTopicType.jsp  
     56    HTTP请求方式:get 
     57    是否需要登录:否 
     58    提交参数:isIndex:是否首页分类,1表示是,0表示不是,默认0 
     59    参数说明:  
     60 
     61返回数据: 
    2962{ 
    30 days: 1, 
    31 msg: "未签到", 
    32 status: 0 
     63  "order": [                                                             //排序(发现页) 
     64    { 
     65      "name": "最新发现", //分类名字 
     66      "id": "0", //分类ID,用于2.2中的topicId参数 
     67      "imageSrc": "www.pconline.com.cn", //图标 
     68      "imageSrcPressed": "www.pconline.com.cn" //被选中的图标 
     69    }, 
     70    { 
     71      "name": "最热发现", 
     72      "url": "www.pconlien.com.cn", 
     73      "id": "0", 
     74      "imageSrc": "www.pconline.com.cn", 
     75      "imageSrcPressed": "www.pconline.com.cn" 
     76    } 
     77  ], 
     78  "category": [                                                         //优惠分类 
     79    { 
     80      "name": "优惠精选", 
     81      "id": "123", 
     82      "imageSrc": "www.pconline.com.cn", 
     83      "imageSrcPressed": "www.pconline.com.cn" 
     84    }, 
     85    { 
     86      "name": "数码家电", 
     87      "id": "124", 
     88      "imageSrc": "www.pconline.com.cn", 
     89      "imageSrcPressed": "www.pconline.com.cn" 
     90    } 
     91  ] 
    3392} 
    3493}}} 
    3594 
    36 == 收藏爆料 == 
    37  
    38 > 线上:[http://best.pconline.com.cn/intf/iphone/collectForApp.jsp?topicId=128018 /intf/iphone/collectForApp.jsp] 
    39  
    40 **提交方式** 
    41  
    42 > POST 
    43  
    44 **是否需要登录** 
    45  
    46 > 是 
    47  
    48 **缓存方式** 
    49  
    50 > 无 
    51  
    52 **缓存时间** 
    53  
    54 > - 
    55  
    56 **参数** 
    57  
    58 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
    59 ||topicId|| 爆料id ||int||0||是|| 
    60  
    61 **返回*** 
    62  
    63 {{{#!java 
     95=== 2.2文章列表接口【v1.2】 === 
     96(维护:成荣伟) 
     97{{{ 
     98    url:http://best.pconline.com.cn/intf/iphone/getTopicList.jsp 
     99    请求参数: pageNo:页码,默认1 
     100                   pageSize:每页显示记录数,默认20 
     101                   topSize  置顶文章数量,默认2条,最多10条 
     102                   recommendIndex:是否推荐首页,默认0不推荐 
     103                   topicTypeId:分类ID 
     104                   hd  是否高清   0 否  1 是 
     105                   mallId:电商ID(可选) 
     106    请求方法:get 
     107    是否需要登录:否 
     108    返回参数: 
    64109{ 
    65     "msg": "收藏成功", 
    66     "status": 1 
     110    "pageCount":9, //分页数 
     111    "pageNo":1, //页码 
     112    "pageTotal":35, // 数据总数 
     113    "topicTypeId: 0, //分类ID 
     114   "focus": [  // 焦点图 
     115    { 
     116      "id": "", 
     117       topicType,1 //0发现,1优惠,:备注,字段名称从原来的type修改成topicType,//"type",1,  //0发现,1优惠 
     118      "title": "", 
     119      "image": "", 
     120      "invalid": 1, 
     121      "to-uri":""//跳转网页:http://xxx,   跳转晒单终端best-buy-show-order-terminal/id,  如果要跳转优惠和发现终端,则这个字段删掉 
     122    } 
     123   ], 
     124    top: [  // 置顶广告位 
     125        { 
     126                adId: 51, 
     127                adTitle: "好东西哇", 
     128                createTime: "2014-09-25 14:15:55", 
     129                imageUrl: "", 
     130                imageUrl_170x70: "", 
     131                positionIndex: 5, 
     132                topic: { 
     133                        bad: 1, 
     134                        collectCount: 3, 
     135                        commentNum: 0, 
     136                        createName: "crazyhook", 
     137                        good: 2, 
     138                        id: 73727, 
     139                        image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/22/c2/38860140_1411372041425_255x255.jpg", 
     140                        overdueStatus: 0, 
     141                        price: "199.99美元约¥1227 (国内¥1799)", 
     142                        pubDate: "2014-09-22 15:49:42", 
     143                        showSource: 1, 
     144                        time: "2014-09-49", 
     145                        title: "Sony 索尼 PCM-M10 4GB 录音笔", 
     146                        topicType: 2, 
     147                        tryToGetWapSource: "http://www.amazon.com/gp/product/B002R56C4O/ref=as_li_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B002R56C4O&linkCode=as2&tag=bp072-20&linkId=63QE7MVH4UJVR5QL&browser=fullscreen" 
     148                }, 
     149                url: "http://best.pconline.com.cn/haitao/73727.html", 
     150                urlType: 1  // 1 爆料    2 网页 
     151        }, 
     152        { 
     153                adId: 41, 
     154                adTitle: "标题", 
     155                createTime: "2014-09-25 12:01:41", 
     156                imageUrl: "", 
     157                imageUrl_170x70: "", 
     158                positionIndex: 5, 
     159                url: "http://best.pconline.com.cn", 
     160                urlType: 2  // 1 爆料    2 网页 
     161        } 
     162    ], 
     163    "topics":[ //数据 
     164        { 
     165            "commentNum":"0",    //评论数 
     166            "id":"2395585", 
     167            "title":"有钱你就来",    //标题 
     168            "topicType": 2,  // 0发现,1优惠,2海淘,3晒物,4经验 
     169            "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png",  //图片 
     170            "pubDate":"2013-02-03",        //时间 
     171            "good":"20",    //值的数量 
     172            "bad":"1",        //不值的数量 
     173            "price":"只售998,还包邮~"    //价格 
     174            "deprecated":1            //是否过期 
     175            currentPrice = "0.00"; //现在价格 
     176            discount = "0.0折"; //打折数 
     177            formerPrice = "0.00"; //之前价格 
     178            "eb":"电商名称", 
     179            "overdueStatus":1,    // 是否过期 
     180            "showSource":1,    // 是否显示直达链接 
     181            "tryToGetWapSource"    // wap直达链接 
     182        }, 
     183        { 
     184            "type":2,    // showPicForApp:1 图片形式显示, 接口给出的对应值为2 
     185            "commentNum":"0",    //评论数 
     186            "id":"2395585", 
     187            "title":"白菜价合集",    //标题 
     188            "pubDate":"2013-02-03",        //时间 
     189            "good":"20",    //值的数量 
     190            "bad":"1",        //不值的数量 
     191            "price":"只售998,还包邮~"    //价格 
     192            "deprecated":1            //是否过期 
     193            currentPrice = "0.00"; //现在价格 
     194            discount = "0.0折"; //打折数 
     195            formerPrice = "0.00"; //之前价格 
     196            "eb":"电商名称", 
     197            "overdueStatus":1,    // 是否过期 
     198            "showSource":1,    // 是否显示直达链接 
     199            "tryToGetWapSource"    // wap直达链接 
     200            "products":[ 
     201                  { 
     202                    "image":"http://", 
     203                    "title":"zzz" 
     204                  }, { 
     205                    "image":"http://", 
     206                    "title":"zzz" 
     207                  },{ 
     208                    "image":"http://", 
     209                    "title":"zzz" 
     210                  } 
     211            ] 
     212        } 
     213    ], 
     214    "pageSize":"20" //每页数据数 
    67215} 
    68 }}} 
    69  
    70  
    71 == 取消收藏 == 
    72  
    73 > 线上:[http://best.pconline.com.cn/intf/iphone/deleteCollectForApp.jsp?topicIds=128018 /intf/iphone/deleteCollectForApp.jsp] 
    74  
    75 **提交方式** 
    76  
    77 > POST 
    78  
    79 **是否需要登录** 
    80  
    81 > 是 
    82  
    83 **缓存方式** 
    84  
    85 > 无 
    86  
    87 **缓存时间** 
    88  
    89 > - 
    90  
    91 **参数** 
    92  
    93 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
    94 ||topicIds|| 爆料id,多个用逗号分隔 ||String||0||是|| 
    95  
    96 **返回** 
    97  
    98 {{{#!java 
     216 
     217}}} 
     218 
     219=== 2.3 终端页接口【v1.2】 === 
     220(维护:成荣伟、制作:甘剑威) 
     221{{{ 
     222 
     223    url:http://best.pconline.com.cn/intf/iphone/getTopicHtml.jsp 
     224    请求参数:       topicId:爆料ID 
     225                        type:爆料类型 
     226    common_session_id: 登录后session,Cookies中 
     227                         
     228    请求方法:get 
     229    是否需要登录:否 
     230    返回参数:web页面的html代码 
     231 
     232备注: 
     233    附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾,里面的内容有评论url,标题以及发送微博用的图片url,用json格式,例如: 
     234 
     235<!--  
     236/*@_HTML_META_START_     
     237{"url":"http://best.pconline.com.cn/discovery_art.jsp?topicId=3064","title":"东芝 3TB DT01ACA300 7200转 64M SATA3 台式机硬盘","firstPic":"http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1309/02/c0/25177373_1378101718895_350x350.jpg"} 
     238_HTML_META_END_@*/ 
     239 --> 
     240}}} 
     241 
     242=== 2.4 评论列表接口 === 
     243(客户端通用) 
     244{{{ 
     245url:http://mrobot.pconline.com.cn/v3/cmt/new_topics  
     246 HTTP请求方式:get 
     247    是否需要登录:否 
     248    提交参数: 
     249            topicId: 评论id  
     250            articleId: 文章id 
     251 
     252返回数据: 
    99253{ 
    100     "count": 1, 
    101     "msg": "删除收藏成功", 
    102     "status": 1 
     254  "comments": [ 
     255    {  //没有引用其他评论的评论 
     256      "1": { //表达其引用关系的key 
     257        "id":"24991904",//帖子id 
     258        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬: ",  //用户名称 
     259        "floor": "1737",  //楼层 
     260        "time": "2013-01-05 09:05:40",  //时间 
     261        "content": "内容过于暴力,已和谐" //内容 
     262      }, 
     263      "current":"1",               //当前最外层引用标识 
     264      "support":"10086"       //"顶"数量 
     265      "expand":false  //判断是否展开,默认为false 
     266    }, 
     267    { 
     268      "3": { 
     269        "id":"24991804",//帖子id 
     270        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬: ", 
     271        "floor": "1737", 
     272        "time": "2013-01-05 09:05:40", 
     273        "content": "内容过于暴力,已和谐" 
     274      }, 
     275      "2": { 
     276        "id":"24941904",//帖子id 
     277        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬: ", 
     278        "floor": "1737", 
     279        "time": "2013-01-05 09:05:40", 
     280        "content": "内容过于暴力,已和谐" 
     281      }, 
     282      "1": { 
     283        "id":"24491904",//帖子id 
     284        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬: ", 
     285        "floor": "1737", 
     286        "time": "2013-01-05 09:05:40", 
     287        "content": "内容过于暴力,已和谐" 
     288      }, 
     289      "4": { 
     290        "id":"24993904",//帖子id 
     291        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬: ", 
     292        "floor": "1737", 
     293        "time": "2013-01-05 09:05:40", 
     294        "content": "内容过于暴力,已和谐" 
     295      }, 
     296      "current":"4", 
     297      "support":"10086" //顶数 
     298      "expand":false  //判断是否展开,默认为false 
     299    } 
     300  ], 
     301  "hot-comments": [ 
     302    {  //没有引用其他评论的评论 
     303      "1": { //表达其引用关系的key 
     304        "id":"24691904",//帖子id 
     305        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬: ",  //用户名称 
     306        "floor": "1737",  //楼层 
     307        "time": "2013-01-05 09:05:40",  //时间 
     308        "content": "内容过于暴力,已和谐" //内容 
     309      }, 
     310      "current":"1" 
     311      "support":"10086" //顶数 
     312      "expand":false  //判断是否展开,默认为false 
     313    } 
     314  ], 
     315  "docUrl": "http://im_an_artical" 
    103316} 
    104 }}} 
    105  
    106 == 获取app置顶广告位 == 
    107  
    108 > 线上:[http://best.pconline.com.cn/intf/iphone/getAdPositionList.jsp?type=5&pageNo=1&pageSize=2 /intf/iphone/getAdPositionList.jsp] 
    109  
    110 **提交方式** 
    111  
    112 > GET 
    113  
    114 **是否需要登录** 
    115  
    116 > 否 
    117  
    118 **缓存方式** 
    119  
    120 > 接口缓存 
    121  
    122 **缓存时间** 
    123  
    124 > 300秒 
    125  
    126 **参数** 
    127  
    128 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
    129 ||type||5 App首页置顶广告位   6 App海淘置顶广告位   7 App晒物置顶广告位   8 App经验置顶广告位||int||5||是|| 
    130 ||pageNo||-||int||1||是||  
    131 ||pageSize||-||int||5||是|| 
    132  
    133 **返回** 
    134  
    135 {{{#!java 
     317 
     318备注: 
     319 
     320}}} 
     321 
     322=== 2.5 发评论接口 === 
     323(客户端通用) 
     324{{{ 
     325http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp 
     326HTTP请求方式:post 
     327    是否需要登录:否 
     328    提交参数:id:话题id 
     329                    url:话题url 
     330                    common_session_id:太平洋通行证session 
     331                    username:用户名 
     332                    anonymous:是否匿名 
     333                    content:内容 
     334                    replyFloor2:回复楼层(可选) 
     335                    通过body传参 
     336 
     337    返回数据: 
    136338{ 
    137 data: [ 
     339    "commentId":25705754, 
     340    "floor":27, 
     341    "showName":"iostester", 
     342    "brief":"Really&nbsp;good&nbsp;car&nbsp;hm~~~", 
     343    "status":0, 
     344    "createTime":"2013-07-19 10:37:03", 
     345    "resultCode":0, 
     346    "resultMsg":"您的评论已经成功发表。注:评论在审核后才能出现在列表中,谢谢!", 
     347    "userId":25520497 
     348} 
     349 
     350}}} 
     351 
     352=== 顶评论接口 === 
     353(维护:成荣伟) 
     354{{{ 
     355    url:http://cmt.pconline.com.cn/action/comment/support_json.jsp 
     356    请求参数: cid  评论id 
     357              sp: sp>0表示支持,sp<=0表示反对 
     358    请求方法:post 
     359    是否需要登录:否 
     360    返回参数: 
     361         { 
     362            "support": 2, 
     363            "floor": 2, 
     364            "status": 0, 
     365            "topicId": 13205153, 
     366            "postId": 36813920 
     367        } 
     368         
     369        { 
     370            message: "您已对该评论投过票,不可重复投票", 
     371            status: -1 
     372        } 
     373 
     374}}} 
     375=== 2.6 值不值接口 === 
     376(维护:成荣伟) 
     377{{{ 
     378    url:http://best.pconline.com.cn/intf/iphone/likeAndDislike.jsp 
     379    请求参数: topicId:爆料ID 
     380                  operate:值或不值,0表示值,1表示不值 
     381                  common_session_id:太平洋通行证session (当有登录时发,无登录时不发) 
     382    请求方法:get 
     383    是否需要登录:否 
     384    返回参数: 
    138385{ 
    139 adId: 269, 
    140 adTitle: "测试广告标题app5", 
    141 createTime: "2015-03-24 17:00:56", 
    142 imageUrl: "http://dev2.pconline.com.cn:9191/upcfiles/pc_best/1503/24/c0/12118_1427187331797.jpg", 
    143 imageUrl_170x70: "http://dev2.pconline.com.cn:9191/upcfiles/pc_best/1503/24/c0/12118_1427187331797_70x70.jpg", 
    144 positionIndex: 5, 
    145 topic: { 
    146 bad: 3, 
    147 collectCount: 6, 
    148 commentNum: 12, 
    149 createName: "qz33742482", 
    150 good: 6, 
    151 id: 124632, 
    152 image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1503/17/c2/3994987_1426575338354_255x255.png", 
    153 isSupportPurchasing: 1, 
    154 overdueStatus: 0, 
    155 price: "43.99+2.01美元直邮中国约¥287", 
    156 pubDate: "2015-03-17 14:57:29", 
    157 showSource: 1, 
    158 time: "2015-03-17", 
    159 title: "大容量低价:海盗船 CORSAIR 滑盖设计 USB3.0 128G U盘", 
    160 topicType: 2, 
    161 tryToGetWapSource: "http://www.amazon.com/gp/product/B00E3RHS4C/&tag=bp072-20&browser=fullscreen" 
    162 }, 
    163 url: "http://best.pconline.com.cn/haitao/124632.html", 
    164 urlType: 1 
    165 }, 
    166 {} 
    167 ], 
    168 serverTime: 1428487875 
     386    "resultCode":0, 
     387    "resultMsg":"您的投票已经成功发表。注:评论在审核后才能出现在列表中,谢谢!" 
    169388} 
    170389}}} 
    171390 
    172 == 获取专题tab页的活动跳转链接 == 
    173  
    174 > 线上:[http://best.pconline.com.cn/intf/iphone/getAppSpecialUrl.jsp /intf/iphone/getAppSpecialUrl.jsp] 
    175  
    176 **提交方式** 
    177  
    178 > GET 
    179  
    180 **是否需要登录** 
    181  
    182 > 否 
    183  
    184 **缓存方式** 
    185  
    186 > 接口缓存 
    187  
    188 **缓存时间** 
    189  
    190 > 300秒 
    191  
    192 **参数** 
    193  
    194 **返回** 
    195  
    196 {{{#!java 
     391=== 2.7 摇一摇接口 === 
     392(维护:成荣伟) 
     393{{{ 
     394     url:http://best.pconline.com.cn/intf/iphone/getTopicListOfTop.jsp 
     395     
     396    备注:摇一摇接口出文章列表规则:当前时间算24小时内首页接口文章最新的100篇,不足100篇的话有多少出多少,时间按发布时间排序,不分页. 
     397 
     398    请求参数: 无 
     399    请求方法:get 
     400    是否需要登录:否 
     401    返回参数: 
    197402{ 
    198 hasUrl: 0, 
    199 url: "" 
     403    "pageCount":"1", 
     404    "pageNo":"1", 
     405    "data":[ 
     406        { 
     407            "commentNum":"0", 
     408            "id":"2395585", 
     409            "title":"“BMW大师殿堂”杨丽萍舞剧《孔雀》在陕西惊艳登场", 
     410            "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png", 
     411            "pubDate":"2013-02-03",        //时间 
     412            "wroth":"1",    //值的数量 
     413            "price":"160元包邮"    //价格 
     414        } 
     415    ], 
     416    "pageSize":"20" 
    200417} 
    201 }}} 
    202  
    203  
    204 == 获取用户收藏总数,目前只有三种分类: 1 优惠海淘, 2 国内优惠, 3 发现频道,4 经验 , 5 晒物(app1.3之后使用的) ==  
    205 /intf/iphone/getCollectsCountForUser_2nd.jsp 
    206  
    207 == 获取用户收藏总数,目前只有三种分类: 1 优惠海淘, 2 国内优惠, 3 发现频道,4 经验 , 5 晒物 == 
    208 /intf/iphone/getCollectsCountForUser.jsp 
    209  
    210 == 获取用户收藏列表 == 
    211 /intf/iphone/getCollectsForApp.jsp 
    212  
    213 == 搜索热词接口 == 
    214 /intf/iphone/getHostSearchTerms.jsp 
    215  
    216 == 根据电商获取海淘资讯列表 == 
    217 /intf/iphone/getIndexHaitaoByMallId.jsp 
    218  
    219 == 获取海淘爆料列表 == 
    220 /intf/iphone/getListBySection.jsp 
    221  
    222 == 获取电商列表 == 
    223 /intf/iphone/getMall.jsp 
    224  
    225 == 获取通知栏内容 == 
    226 /intf/iphone/getNotificationBarInfo.jsp 
    227  
    228 == 获取代购列表 == 
    229 /intf/iphone/getPurchasing.jsp 
    230  
    231 == 获取更多代购列表 == 
    232 /intf/iphone/getPurchasingMore.jsp 
    233  
    234 == 获取服务器时间 == 
    235 /intf/iphone/getServerTimeStamp.jsp 
    236  
    237 == 频道分类列表(1.3版本后使用) == 
    238 /intf/iphone/getSortChannel_2nd.jsp 
    239  
    240 == 频道分类列表 == 
    241 /intf/iphone/getSortChannel.jsp 
    242  
    243 == 获取精准订阅选项,包括可选的电商和分类 == 
    244 /intf/iphone/getSubscribeSelectItems.jsp 
    245  
    246 == 获取晒物广场列表 == 
    247 /intf/iphone/getSunplaza.jsp 
    248  
    249 == 获取晒物数据列表 == 
    250 /intf/iphone/getSunplazaNew.jsp 
    251  
    252 == 获取系统通知 == 
    253 /intf/iphone/getSysNotice.jsp 
    254  
    255 == 获取系统通知数量,收到的和发出的评论数量 ==  
    256 /intf/iphone/getSysNoticeAndCommentCount.jsp 
    257  
    258 == 获取爆料的求购数 == 
    259 /intf/iphone/getTopicBuyCount.jsp 
    260  
    261 == 获取爆料终端页,已弃用 == 
    262 /intf/iphone/getTopicHtml.jsp 
    263  
    264 == 获取爆料列表 == 
    265 /intf/iphone/getTopicList.jsp 
    266  
    267 == 获取热门爆料列表,最近三个星期点赞最多的进行排列 == 
    268 /intf/iphone/getTopicListOfTop.jsp 
    269  
    270 == 获取爆料类型,1.3版本已经弃用 == 
    271 /intf/iphone/getTopicType.jsp 
    272  
    273 == 赞或者踩爆料 == 
    274 /intf/iphone/likeAndDislike.jsp 
    275  
    276 == 我收到的评论 == 
    277 /intf/iphone/my_comment_receivelist.jsp 
    278  
    279 == 我发出的评论 == 
    280 /intf/iphone/my_comment_sendlist.jsp 
    281  
    282 == 获取用户信息 == 
    283 /intf/iphone/myInfoForApp.jsp 
    284  
    285 == 获取用户某个时间之后的爆料数和评论数 == 
    286 /intf/iphone/myNewsForApp.jsp 
    287  
    288 == 获取我的爆料 == 
    289 /intf/iphone/myTipoffForApp.jsp 
    290  
    291 == 获取需要进行iOS分类推送的token,推送服务器从这里获取token,已弃用 == 
    292 /intf/iphone/pushFileUrl.jsp 
    293  
    294 == 获取需要进行iOS精准推送的token,推送服务器从这里获取token == 
    295  
    296 /intf/iphone/pushFileUrlSecond.jsp 
    297  
    298 == 分类推送状态回调函数,给推送服务器调用,已弃用 == 
    299 /intf/iphone/pushIOSCallback.jsp 
    300  
    301 == 精准推送状态回调函数,给推送服务器调用 == 
    302 /intf/iphone/pushSecondIOSCallback.jsp 
    303  
    304 == 搜索推荐 ==  
    305 /intf/iphone/search_keyword_hint.jsp 
    306  
    307 == 搜索接口 == 
    308 /intf/iphone/searchResult_2nd.jsp 
    309  
    310 == 搜索接口(旧版) == 
    311 /intf/iphone/searchResult.jsp 
    312  
    313 == 签到接口 == 
    314 /intf/iphone/signInForApp.jsp 
    315  
    316 == 专题列表接口 == 
    317 /intf/iphone/special.jsp 
    318  
    319 == 专题列表外部接口,已移动到wap目录下,这里做301跳转 == 
    320 /intf/iphone/specialForExternal.jsp 
    321  
    322 == 加载更多专题列表接口 == 
    323 /intf/iphone/specialGetMore.jsp 
    324  
    325 == iOS分类订阅接口 == 
    326 /intf/iphone/subscription_add_sec.jsp 
    327  
    328 == iOS分类订阅接口 == 
    329 /intf/iphone/subscription_add.jsp 
    330  
    331 == 获取所有可被订阅的分类 == 
    332 /intf/iphone/subscription_list.jsp 
    333  
    334 == 添加精准订阅 == 
    335 /intf/iphone/subscription_second_add_sec.jsp 
    336  
    337 == 添加精准订阅 == 
    338 /intf/iphone/subscription_second_add.jsp 
    339  
    340 == 删除精准订阅 == 
    341 /intf/iphone/subscription_second_delete_sec.jsp 
    342  
    343 == 删除精准订阅 == 
    344 /intf/iphone/subscription_second_delete.jsp 
    345  
    346 == 精准订阅关键词匹配 == 
    347 /intf/iphone/subscription_second_keyword_hint.jsp 
    348  
    349 == 精准订阅列表 == 
    350 /intf/iphone/subscription_second_list.jsp 
    351  
    352 == 精准订阅推送爆料列表 == 
    353 /intf/iphone/subscription_second_topic_list.jsp 
    354  
    355 == 添加爆料 == 
    356 /intf/iphone/topic_add.jsp 
    357  
    358 == 爆料赞和踩的数量 == 
    359 /intf/iphone/topic_like_and_dislike_count.jsp 
    360  
    361 == 求购 == 
    362 /intf/iphone/topicBuyCountAdd.jsp 
    363  
    364 == 1.4 版本的终端页 == 
    365 /intf/iphone/topicDetail_3rd.jsp 
    366  
    367 == 获取爆料收藏数量,和当前用户是否收藏过 == 
    368 /intf/iphone/topicDetail_collectCount.jsp 
    369  
    370 == 1.3 版本的终端页 == 
    371 /intf/iphone/topicDetail_second.jsp 
    372  
    373 == 1.2 版本的终端页 ==  
    374 /intf/iphone/topicDetail.jsp 
    375  
    376 /intf/iphone/winForApp.jsp 
    377  
    378 /intf/iphone/winForApp2.jsp 
     418 
     419}}} 
     420 
     421=== 2.8 太平洋统一登录接口 === 
     422(客户端通用) 
     423{{{ 
     424    url:http://mrobot.pcauto.com.cn/proxy/passport2/login 
     425     
     426    备注: 
     427    请求参数:username:用户名 
     428                  password:密码 
     429    请求方法:post 
     430    是否需要登录:否 
     431    返回参数: 
     432{ 
     433    "status": 0, 
     434    "message": "ok", 
     435    "session": "123456", 
     436    "userId": 25520497, 
     437    "common_session_id": "123456" 
     438} 
     439 
     440}}} 
     441 
     442=== 2.9 晒单首页【v1.3】 === 
     443{{{ 
     444    url:http://www.pconline.com.cn/jrzcz/app/1311/intf3741.js 
     445     
     446    备注: 
     447    请求参数: 
     448    请求方法:get 
     449    是否需要登录:否 
     450    返回参数: 
     451{ 
     452topics: [   帖子数组 
     453    { 
     454        id: 48074,   id 
     455        image: "http://img0.pconline.com.cn/pconline/jrzcz/1311/28525424_1384151163247_0_1024x1024.jpg",   导读图 
     456        title: "晒屌丝破车升级20寸轮毂+土豪邻居新车",    标题 
     457        time: "2013-11-13"   发表时间 
     458    } 
     459] 
     460} 
     461}}} 
     462 
     463=== 3.0 晒单终端【v1.3】 === 
     464{{{ 
     465    url:http://mrobot.pconline.com.cn/best/topics/45049?pageNo=1 
     466     
     467    备注: 
     468    请求参数:id_0:帖子id,  pageNo:页数, authorId:为0时查看全部,为楼主id时只看楼主  
     469    请求方法:get 
     470    是否需要登录:否 
     471 
     472//点击图片协议 
     473pcaction://big-photo?data={"total":10, "currentIndex":10, "photos":["xxx.jpg", "xxx.jpg", "xxx.jpg" ...]} 
     474 
     475}}} 
     476 
     477 
     478 
     479=== 3.1 回帖 === 
     480{{{ 
     481    url:http://piebbs.pconline.com.cn/rest/topics/${topicId} 
     482     
     483    备注: 
     484    请求参数: 
     485    agent = 1; 
     486    message = 内容; 
     487    replyToId = 31202601; 
     488设置header  Cookie = "common_session_id=xxxx"; 
     489    请求方法:post 
     490    是否需要登录:否 
     491    返回参数: 
     492 
     493}}} 
     494 
     495 
     496=== 3.2 搜索【v1.3】 === 
     497{{{ 
     498    url:http://best.pconline.com.cn/intf/iphone/searchResult.jsp 
     499     
     500    参数: 
     501keyword 搜索关键词(会去除前后空格)String 
     502 
     503              recommendIndex 优惠1/发现0 int 
     504               
     505pageNo 页号 int 
     506              topicTypeIds(可选) 类型ID,多个的话用逗号分开  这边海淘传入13,同时海淘搜索要加入recommendIndex=1 
     507               
     508pageSize 页大小(默认20) 
     509              hd  是否高清   0 否  1 是 
     510    请求方法:get 
     511    是否需要登录:否 
     512    返回参数: 
     513{ 
     514    "pageCount":9, //分页数 
     515    "pageNo":1, //页码 
     516    "pageTotal":35, // 数据总数 
     517"pagesize 
     518    "topics":[ //数据 
     519        { 
     520            "commentNum":"0",    //评论数 
     521            "id":"2395585", 
     522            "title":"有钱你就来",    //标题 
     523       "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png",  //图片 
     524            "pubDate":"2013-02-03",        //时间 
     525            "good":"20",    //值的数量 
     526            "bad":"1",        //不值的数量 
     527            "price":"只售998,还包邮~"    //价格 
     528            "deprecated":1            //是否过期 
     529            currentPrice = "0.00"; //现在价格 
     530            discount = "0.0折"; //打折数 
     531            formerPrice = "0.00"; //之前价格 
     532            “eb”:"电商名称", 
     533        } 
     534    ], 
     535    "pageSize":"20" //每页数据数 
     536} 
     537}}} 
     538 
     539 
     540=== 3.3 搜索热词【v1.3】 === 
     541{{{ 
     542    url:http://www.pconline.com.cn/jrzcz/app/1311/intf3722.js 
     543     
     544    备注: 
     545    请求参数: 
     546    请求方法:get 
     547    是否需要登录:否 
     548    返回参数: 
     549http://best.pconline.com.cn/intf/iphone/searchResult.jsp?recommendIndex=1&pageNo=1&pageSize=20&keyword=  首页推荐 
     550http://best.pconline.com.cn/intf/iphone/searchResult.jsp?recommendIndex=0&pageNo=1&pageSize=20&keyword=  发现频道 
     551http://best.pconline.com.cn/intf/iphone/searchResult.jsp?recommendIndex=1&pageNo=1&pageSize=20&topicTypeIds=13&keyword= 首页海淘咨询 
     552}}} 
     553 
     554== V1.2.0新增的接口 == 
     555 
     556=== 4.0 获取收藏列表 === 
     557{{{ 
     558    url:http://best.pconline.com.cn/intf/iphone/getCollectsForApp.jsp 
     559     
     560    参数: 
     561    common_session_id: 登录后session,Cookies中 
     562    index: 1 海淘, 2 优惠, 3 发现, 4 经验, 5 晒物 
     563    hd  是否高清   0 否  1 是 
     564 
     565    pageNo: 
     566    pageSize: 
     567    请求方法:get 
     568    是否需要登录:否 
     569    返回参数: 
     570{ 
     571  "products": [ 
     572    { 
     573      "id": 123, 
     574      “title”: "", 
     575      "time": "", 
     576      "price": "", 
     577      "eb": "",(电商名称) 
     578      "image": "http://xxx", 
     579      "topicType": 2,  // 0发现,1优惠,2海淘,3晒物,4经验 
     580      "invalid": (1已失效,0未失效) 
     581     --后期增加  
     582     "good":"20",    //值的数量 
     583     "bad":"1",        //不值的数量 
     584      "commentNum":"0",    //评论数 
     585      "createName":"Jason",  // 作者 
     586      "collectCount":1    // 收藏数 
     587    } 
     588  ], 
     589  "pageNo": 1, 
     590  "pageSize": 20, 
     591  "total": 100 
     592} 
     593晒物和经验没有的字段,填入空字符串 
     594}}} 
     595 
     596 
     597=== 4.1 添加收藏 === 
     598{{{ 
     599    url:http://best.pconline.com.cn/intf/iphone/collectForApp.jsp 
     600     
     601    参数: 
     602    common_session_id: 登录后session,Cookies中 
     603    topicId:12312 
     604    type: 类型(1优惠、2发现、3海淘、4经验、5晒物)//暂时不用 
     605     
     606    请求方法:post 
     607    是否需要登录:否 
     608    返回参数: 
     609{ 
     610  "result": { 
     611    "status": (1成功,0失败), 
     612    "msg": (失败后的提示) 
     613  } 
     614} 
     615}}} 
     616 
     617 
     618=== 4.2 删除收藏 === 
     619{{{ 
     620    url:http://best.pconline.com.cn/intf/iphone/deleteCollectForApp.jsp 
     621    参数: 
     622    common_session_id: 登录后session,Cookies中 
     623    topicIds:12312,57847   id的串,用逗号分隔,可单个可多个 
     624    type: 类型(1优惠、2发现、3海淘、4经验、5晒物)//暂时不用 
     625     
     626    请求方法:post 
     627    是否需要登录:否 
     628    返回参数: 
     629{ 
     630  "result": { 
     631    "status": (1成功,0失败), 
     632    "msg": (失败后的提示) 
     633  } 
     634} 
     635}}} 
     636 
     637=== 4.3 获取用户各个收藏分类的收藏总数【v1.3】 === 
     638{{{ 
     639    url:http://best.pconline.com.cn/intf/iphone/getCollectsCountForUser.jsp 
     640    参数: 
     641    common_session_id: 登录后session,Cookies中 
     642     
     643    返回: 
     644  "result": { 
     645    "status": (1成功,0失败), 
     646    "msg": (失败后的提示) 
     647    "counters": [ 
     648    { 
     649      "id": 123, 
     650      "title":"优惠" 
     651      “total”: 28, 
     652    }, 
     653    { 
     654      "id": 123, 
     655      "title":"海淘" 
     656      “total”: 28, 
     657    } 
     658    { 
     659      "id": 123, 
     660      "title":"发现" 
     661      “total”: 28, 
     662    } 
     663    { 
     664      "id": 123, 
     665      "title":"晒物" 
     666      “total”: 28, 
     667    } 
     668    { 
     669      "id": 123, 
     670      "title":"经验" 
     671      “total”: 28, 
     672    }]} 
     673}}} 
     674 
     675 
     676=== 4.4 查询是否已收藏 === 
     677{{{ 
     678    url:http://best.pconline.com.cn/intf/iphone/topicDetail_collectCount.jsp?topicId=26454 
     679    HTTP请求方式:get 
     680 
     681    common_session_id: 登录后session,Cookies中 
     682    topicId:爆料Id 
     683    是否需要登录:否 
     684 
     685返回值: 
     686status:状态  -1未登录  0登陆未收藏过  1登陆且已收藏 
     687count:收藏数 
     688#此接口查询后执行topicDetail.jsp的JS函数setFavCount来使页面变化# 
     689}}} 
     690=== 5.0 海淘电商分类列表 === 
     691{{{ 
     692    url:http://best.pconline.com.cn/intf/iphone/getMall.jsp 
     693    HTTP请求方式:get 
     694    是否需要登录:否 
     695    参数说明:  
     696格式与2.1的接口一致 
     697返回数据: 
     698{ 
     699  "mall": [ 
     700    { 
     701      "iconImg": "", 
     702      "id": 1, 
     703      "name": "全部电商", 
     704      "typeDesc": "国外", 
     705      "typeId": 1 
     706    },{ 
     707      "iconImg": "", 
     708      "id": 1, 
     709      "name": "京东", 
     710      "typeDesc": "国内", 
     711      "typeId": 0 
     712    }, 
     713    { 
     714      "iconImg": "", 
     715      "id": 2, 
     716      "name": "苏宁易购", 
     717      "typeDesc": "国内", 
     718      "typeId": 0 
     719    }, 
     720    { 
     721      "iconImg": "", 
     722      "id": 3, 
     723      "name": "易迅", 
     724      "typeDesc": "国内", 
     725      "typeId": 0 
     726    }, 
     727    { 
     728      "iconImg": "", 
     729      "id": 4, 
     730      "name": "亚马逊中国", 
     731      "typeDesc": "国内", 
     732      "typeId": 0 
     733    }, 
     734    { 
     735      "iconImg": "", 
     736      "id": 5, 
     737      "name": "天猫", 
     738      "typeDesc": "国内", 
     739      "typeId": 0 
     740    }, 
     741    { 
     742      "iconImg": "", 
     743      "id": 6, 
     744      "name": "1号店", 
     745      "typeDesc": "国内", 
     746      "typeId": 0 
     747    }, 
     748    { 
     749      "iconImg": "", 
     750      "id": 7, 
     751      "name": "美国亚马逊", 
     752      "typeDesc": "国外", 
     753      "typeId": 1 
     754    }, 
     755    { 
     756      "iconImg": "", 
     757      "id": 8, 
     758      "name": "日本亚马逊", 
     759      "typeDesc": "国外", 
     760      "typeId": 1 
     761    }, 
     762    { 
     763      "iconImg": "", 
     764      "id": 9, 
     765      "name": "当当", 
     766      "typeDesc": "国内", 
     767      "typeId": 0 
     768    }, 
     769    { 
     770      "iconImg": "", 
     771      "id": 10, 
     772      "name": "国美在线", 
     773      "typeDesc": "国内", 
     774      "typeId": 0 
     775    }, 
     776    { 
     777      "iconImg": "", 
     778      "id": 11, 
     779      "name": "库巴", 
     780      "typeDesc": "国内", 
     781      "typeId": 0 
     782    }, 
     783    { 
     784      "iconImg": "", 
     785      "id": 12, 
     786      "name": "淘宝", 
     787      "typeDesc": "国内", 
     788      "typeId": 0 
     789    } 
     790  ] 
     791} 
     792}}} 
     793 
     794=== 6.0 我的消息数 === 
     795{{{ 
     796    url:http://best.pconline.com.cn/intf/iphone/myNewsForApp.jsp 
     797    参数: 
     798    common_session_id: 登录后session,Cookies中 
     799    blTime:上次访问爆料时间,格式为:(YYYY-MM-DD HH:mm:ss) 
     800    plTime:上次访问评论时间,  格式为:(YYYY-MM-DD HH:mm:ss) 
     801    请求方法:post 
     802    是否需要登录:否 
     803    返回参数: 
     804{ 
     805  "blCount":100   爆料数量 
     806  "plCount":100   评论数量 
     807  "newCommentCount":1   新收到的评论数量 
     808  "newSystemNoticeCount":1  新收到的系统消息数量 
     809} 
     810}}} 
     811 
     812 
     813=== 7.0 我的爆料 === 
     814{{{ 
     815    url:http://best.pconline.com.cn/intf/iphone/myTipoffForApp.jsp 
     816    参数: 
     817    common_session_id: 登录后session,Cookies中 
     818    pageNo: 
     819    pageSize: 
     820    hd  是否高清   0 否  1 是 
     821    status: 状态(1表示请求审核已经通过的列表,2表示请求未通过的列表) 
     822    typeId: 类型(1 优惠海淘, 2 国内优惠, 3 发现频道, 4 经验, 5 待定)//暂时不用 
     823     
     824    请求方法:get 
     825    是否需要登录:是 
     826    返回参数: 
     827{ 
     828  "list": [ 
     829    { 
     830      "id": 123, 
     831      "url": "", 
     832      "time": 12312312, 
     833      "title": "this is the brief of the post", 
     834      "image": "http://xxx", 
     835      "status": -1(1已通过,0审核中,-1不通过,说明:如果参数status请求时设置为1,此处应该全部是1) 
     836      "reason": "抄袭!"  // 审核未通过理由 
     837       --后期增加  
     838       "type": 2,  // 0发现,1优惠,2海淘,3晒物,4经验 
     839       "good": 20,    //值的数量 
     840       "bad": 1,        //不值的数量 
     841       "commentNum": 0,    //评论数 
     842       "award": "奖励5金币", 
     843       collectCount: 3, 
     844       createName: "arthinking", 
     845       currentPrice: "0", 
     846       eb: "",  // 电商名称 
     847       formerPrice: "0", 
     848       isSupportPurchasing: 0, 
     849       overdueStatus: 0, 
     850       price: "", 
     851       showSource: 1, 
     852       tryToGetWapSource: "", 
     853       userRecommend: ""  // 用户推荐理由 
     854    } 
     855  ] 
     856} 
     857}}} 
     858 
     859=== 8.0 签到 === 
     860{{{ 
     861    url:http://best.pconline.com.cn/intf/iphone/signInForApp.jsp 
     862    参数: 
     863    common_session_id: 登录后session,Cookies中 
     864     
     865    请求方法:post 
     866    是否需要登录:是 
     867    返回参数: 
     868{ 
     869"status": 1(1成功,0失败,2已签到,4重复签到,和2同理) 
     870"msg":"签到成功", 
     871“day”: 2,(已签到次数) 
     872“addCoin”:2,(金币增加) 
     873"addInt"4,(积分增加) 
     874“gold”:100,(金币总数) 
     875"point"100,(积分总数) 
     876} 
     877 
     878}}} 
     879 
     880 
     881=== 9.0用户基本信息 === 
     882{{{ 
     883    url:http://best.pconline.com.cn/intf/iphone/myInfoForApp.jsp 
     884    参数: 
     885    common_session_id: 登录后session,Cookies中 
     886    userId  
     887    请求方法:get 
     888    是否需要登录:是 
     889    返回参数: 
     890{ 
     891"name":"用户名", 
     892"gold":50, 
     893"point"100, 
     894"status":(1成功,0是登录,-1是未登录) 
     895} 
     896 
     897}}} 
     898 
     899=== 10.0专题接口【v1.3】 === 
     900{{{ 
     901    url:http://best.pconline.com.cn/intf/iphone/special.jsp 
     902    参数: 
     903 
     904    请求方法:get 
     905    是否需要登录:是 
     906    返回参数:HTML页面 
     907 
     908跳转协议: 
     909 
     910晒单终端页(帖子终端页)pconlinebestbuy://best-buy-show-order-terminal/id 
     911商品终端页(文章终端页)pconlinebestbuy://best-buy-article/id?type=${type=1 优惠  type=0 发现} 
     912非晒单,终端页的网页  :普通URL+browser=fullscreen,例如:http://www.baidu.com?browser=fullscreen 
     913}}} 
     914 
     915=== 11.0 订阅列表 === 
     916{{{ 
     917    url:http://192.168.50.32:8082/intf/iphone/subscription_list.jsp 
     918    参数: 
     919 
     920    请求方法:get 
     921    是否需要登录:是 
     922    返回参数: 
     923{ 
     924   list:[ 
     925    { 
     926       id: 
     927       name: 
     928       img: 
     929    } 
     930   ] 
     931} 
     932}}} 
     933 
     934=== 12.0 订阅【v1.3】 === 
     935{{{ 
     936    url:http://192.168.50.32:8082/intf/iphone/subscription_add.jsp 
     937    参数: 
     938     token: 
     939     ids: 
     940     beginTime:(如果勿扰模式关闭了,就不传此字段) 
     941     endTime:(如果勿扰模式关闭了,就不传此字段) 
     942     open: (1发推送,0不发推送) 
     943     sound:(1为有声音,0为无) 
     944     shake:(1为有振动,0为无) 
     945    请求方法:post 
     946    是否需要登录:是 
     947    返回参数: 
     948    { 
     949      "description":"token或者ids为空", 
     950      "status":-2;       (1:成功 
     951                          -1:ids不正确或者日期格式不正确  
     952                          0:订阅失败  
     953                          -2:token为空或者ids为空 
     954                          -3:提交方式不对,请改用Post提交) 
     955    } 
     956      
     957}}} 
     958 
     959 
     960 
     961 
     962=== 13 新终端页接口【v1.2】 === 
     963(维护:成荣伟、制作:黎军) 
     964{{{ 
     965 
     966    url:http://best.pconline.com.cn/intf/iphone/topicDetail.jsp 
     967    请求参数:       topicId:爆料ID 
     968    common_session_id: 登录后session,Cookies中 
     969    hd  是否高清   0 否  1 是 
     970    请求方法:get 
     971    是否需要登录:否 
     972    返回参数:web页面的html代码 
     973 
     974备注: 
     975    附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾,里面的内容有评论url,标题以及发送微博用的图片url,用json格式,例如: 
     976 
     977<!--  
     978/*@_HTML_META_START_     
     979{"url":"http://best.pconline.com.cn/discovery_art.jsp?topicId=3064","title":"东芝 3TB DT01ACA300 7200转 64M SATA3 台式机硬盘","firstPic":"http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1309/02/c0/25177373_1378101718895_350x350.jpg"} 
     980_HTML_META_END_@*/ 
     981 --> 
     982 
     983收藏按钮点击跳转协议: 
     984pcaction://collect/id 
     985 
     986取消收藏按钮点击跳转协议: 
     987pcaction://uncollect/id 
     988 
     989//点击图片协议 
     990pcaction://big-photo?data={"total":10, "currentIndex":10, "photos":["xxx.jpg", "xxx.jpg", "xxx.jpg" ...]} 
     991 
     992//收藏成功后调用 
     993setFavButtonStyle(collect) 【点击灰色状态收藏,变成有色状态调用:setFavButtonStyle(true);】 
     994 
     995//进入页面时,查询是否收藏后 
     996setFavCount(count,status)  
     997}}} 
     998 
     999=== 14.海淘文章列表接口【v1.2】 === 
     1000(维护:成荣伟) 
     1001{{{ 
     1002    url:http://best.pconline.com.cn/intf/iphone/getIndexHaitaoByMallId.jsp 
     1003    请求参数: pageNo:页码,默认1 
     1004                   pageSize:每页显示记录数,默认20 
     1005                   mallId:电商ID(可选) 
     1006                   hd  是否高清   0 否  1 是 
     1007    请求方法:get 
     1008    是否需要登录:否 
     1009    返回参数: 
     1010{ 
     1011    "pageCount":9, //分页数 
     1012    "pageNo":1, //页码 
     1013    "pageTotal":35, // 数据总数 
     1014    "topicTypeId: 0, //分类ID 
     1015   "focus": [ 
     1016    { 
     1017      "id": "", 
     1018      "title": "", 
     1019      "image": "", 
     1020      "invalid": 1 
     1021    } 
     1022   ], 
     1023    "topics":[ //数据 
     1024        { 
     1025            "commentNum":"0",    //评论数 
     1026            "id":"2395585", 
     1027            "title":"有钱你就来",    //标题 
     1028            "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png",  //图片 
     1029            "pubDate":"2013-02-03",        //时间 
     1030            "good":"20",    //值的数量 
     1031            "bad":"1",        //不值的数量 
     1032            "price":"只售998,还包邮~"    //价格 
     1033            "deprecated":1            //是否过期 
     1034            currentPrice = "0.00"; //现在价格 
     1035            discount = "0.0折"; //打折数 
     1036            formerPrice = "0.00"; //之前价格 
     1037            “eb”:"电商名称", 
     1038        } 
     1039    ], 
     1040    "pageSize":"20" //每页数据数 
     1041} 
     1042 
     1043}}} 
     1044 
     1045== 1.3.0开始新增接口 == 
     1046=== 15.分类栏目接口【v1.3】 === 
     1047(维护:成荣伟) 
     1048{{{ 
     1049    url:http://best.pconline.com.cn/intf/iphone/getSortChannel.jsp 
     1050    请求参数: type:1 优惠, 0发现 
     1051    请求方法:get 
     1052    是否需要登录:否 
     1053    返回参数: 
     1054{ 
     1055  "section": { 
     1056    "sections": [ 
     1057      { 
     1058        "id": 1, 
     1059        "name": "神价格" 
     1060      },{ 
     1061        "id": 2, 
     1062        "name": "赶紧买" 
     1063      } 
     1064    ], 
     1065    "sectionName": "特色推荐" 
     1066  }, 
     1067  "default":[ 
     1068    { 
     1069        "id": 1, 
     1070        "name": "神价格" 
     1071      },{ 
     1072        "id": 2, 
     1073        "name": "赶紧买" 
     1074      } 
     1075  ] 
     1076} 
     1077}}} 
     1078 
     1079=== 16.终端页【v1.3】 === 
     1080(维护:成荣伟) 
     1081{{{ 
     1082    url:http://best.pconline.com.cn/intf/iphone/topicDetail_second.jsp 
     1083    备注:优惠终端,发现终端,海淘终端 
     1084    请求参数:       topicId:爆料ID 
     1085                        type:爆料类型 
     1086    common_session_id: 登录后session,Cookies中 
     1087                         
     1088    请求方法:get 
     1089    是否需要登录:否 
     1090    返回参数:web页面的html代码 
     1091 
     1092备注: 
     1093    附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾,里面的内容有评论url,标题以及发送微博用的图片url,用json格式,例如: 
     1094 
     1095<!--  
     1096/*@_HTML_META_START_     
     1097{"url":"http://best.pconline.com.cn/discovery_art.jsp?topicId=3064","title":"东芝 3TB DT01ACA300 7200转 64M SATA3 台式机硬盘","firstPic":"http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1309/02/c0/25177373_1378101718895_350x350.jpg"} 
     1098_HTML_META_END_@*/ 
     1099 --> 
     1100 
     1101点击代购信息,跳转协议:pconlinebestbuy://best-shop-list/id 
     1102 
     1103 
     1104 
     1105}}} 
     1106 
     1107=== 16.1 商家列表接口 === 
     1108(维护:成荣伟) 
     1109{{{ 
     1110    url:http://best.pconline.com.cn/intf/iphone/getPurchasing.jsp 
     1111    请求参数:  
     1112     topicId:商品id 
     1113    请求方法:get 
     1114    是否需要登录:否 
     1115    返回参数:web页面的html代码 
     1116 
     1117点击商家信息,直接跳转HTTP协议 
     1118 
     1119}}} 
     1120=== 17.订阅规则 === 
     1121(维护:成荣伟) 
     1122{{{ 
     1123    url:http://best.pconline.com.cn/intf/iphone/getSubscribeSelectItems.jsp 
     1124    请求参数:  
     1125    请求方法:get 
     1126    是否需要登录:否 
     1127    返回参数: 
     1128{ 
     1129  "ebs": [ 
     1130    { 
     1131      "id": 1, 
     1132      "name": "京东" 
     1133    }, 
     1134    { 
     1135      "id": 2, 
     1136      "name": "淘宝" 
     1137    } 
     1138  ], 
     1139  "types": [ 
     1140    { 
     1141      "id": 1, 
     1142      "name": "家电数码" 
     1143    }, 
     1144    { 
     1145      "id": 2, 
     1146      "name": "汽车用品" 
     1147    } 
     1148  ] 
     1149} 
     1150}}} 
     1151 
     1152 
     1153=== 17.1 提交订阅规则【v1.3】 === 
     1154(维护:成荣伟) 
     1155{{{ 
     1156    url: http://best.pconline.com.cn/intf/iphone/subscription_second_add.jsp 
     1157    请求参数:  
     1158       token: token 
     1159       typeId: 类别ID 
     1160       keyword: 关键词 
     1161       mallId: 电商ID 
     1162    请求方法:post 
     1163    是否需要登录:否 
     1164    返回参数: 
     1165}}} 
     1166 
     1167 
     1168=== 17.2 删除订阅规则【v1.3】 === 
     1169{{{ 
     1170    url: http://best.pconline.com.cn/intf/iphone/subscription_second_delete.jsp 
     1171    请求参数:  
     1172         token: token 
     1173         subscriptionId: 订阅ID 
     1174    请求方法:post 
     1175    是否需要登录:否 
     1176    返回参数: 
     1177}}} 
     1178=== 17.3 查询已订阅规则 === 
     1179{{{ 
     1180    url:http://best.pconline.com.cn/intf/iphone/subscription_second_list.jsp?token=xxx 
     1181    请求参数:  
     1182       token: 
     1183    请求方法:get 
     1184    是否需要登录:否 
     1185    返回参数: 
     1186id: 订阅ID 
     1187keyword: 订阅关键词 
     1188keywordId: 订阅关键词ID 
     1189mallId: 电商ID(0为全选) 
     1190token: token 
     1191typeId: 类别ID(0为全选) 
     1192userId: 用户ID(暂未使用到,默认值0) 
     1193 
     1194}}} 
     1195 
     1196=== 17.4 根据关键词出关键词列表 === 
     1197{{{ 
     1198    备注:例如输入索尼,给出列表:索尼单反,索尼微单 
     1199    url: http://best.pconline.com.cn/intf/iphone/subscription_second_keyword_hint.jsp?token=351108013 
     1200    请求参数:  
     1201    请求方法:get 
     1202    是否需要登录:否 
     1203    返回参数: 
     1204}}} 
     1205 
     1206=== 18.订阅内容 === 
     1207(维护:成荣伟) 
     1208{{{ 
     1209    url:http://best.pconline.com.cn/intf/iphone/subscription_second_topic_list.jsp?token=351108013 
     1210    请求参数:  
     1211        time 缓存时间,默认300秒 
     1212        token 用户唯一标识 
     1213        pageNo 当前第几页,默认第一页 
     1214        pageSize 页面大小,默认20 
     1215        hd  是否高清   0 否  1 是 
     1216        device 设备类型,默认为0,标识iOS 
     1217    请求方法:get 
     1218    是否需要登录:否 
     1219    返回参数: 
     1220与getTopicList.jsp接口返回格式一致,加type,0发现1优惠2海淘 
     1221}}} 
     1222 
     1223 
     1224=== 19.我要爆料 === 
     1225(维护:成荣伟) 
     1226{{{ 
     1227    url:http://best.pconline.com.cn/intf/iphone/topic_add.jsp 
     1228    请求参数:  
     1229      fromUrl: 爆料链接 
     1230      content: 推荐理由 
     1231      email: 电子邮件 
     1232    请求方法:post 
     1233    是否需要登录:否 
     1234    返回参数: 
     1235      status:  
     1236      msg 
     1237}}} 
     1238 
     1239=== 20.个人中心-我的评论 === 
     1240{{{ 
     1241 备注:个人中心 - 我的评论 
     1242 请求URL:http://mrobot.xxx.com.cn/v3/cmt/userCmtList/31836836 
     1243 HTTP请求方式:get 
     1244 是否需要登录:是 
     1245 返回格式:json 
     1246 缓存方式:无 
     1247 缓存时间:无 
     1248 请求参数: 
     1249         UID:用户ID 
     1250         webSite: 
     1251 返回参数: 
     1252         { 
     1253             "data": [ 
     1254                         { 
     1255                             "articleId": 4003061, 
     1256                             "content": "很好的文章!!说不定哪天就用到了!!", 
     1257                             "createTime": 1394361427000, 
     1258                             "userId":0 // 评论者的id,如果是匿名评论则为0 
     1259                             "floor": 12, 
     1260                             "id": 26731760, 
     1261                             "ip": "192.168.239.90-113.64.110.39", 
     1262                             "nickname": "dufu163", 
     1263                             "replyRef": { 
     1264                                         }, 
     1265                             "status": 2, 
     1266                             "topicId": 13113197, 
     1267                             "topicTitle": "证照手续不用愁(3)驾驶证丢了怎么办?", 
     1268                             "topicUrl": "http://www.pcauto.com.cn/drivers/400/4003061.html", 
     1269                             "url": "http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13113197.html" 
     1270                         } 
     1271                     ], 
     1272             "pageNo": 1, 
     1273             "pageSize": 20, 
     1274             "status": 0, 
     1275             "total": 1, 
     1276             "uid": 31836836 
     1277         } 
     1278 请求后端URL: 
     1279        http://cmt.xxx.com.cn/intf/uc_user_cmt.jsp?userId=31836836&webSite=xxx&pageNo=1&pageSize=20 
     1280}}} 
     1281 
     1282{{{ 
     1283 备注:个人中心 - 我发出的评论 
     1284 请求URL:http://best.pconline.com.cn/intf/iphone/my_comment_sendlist.jsp 
     1285 HTTP请求方式:get 
     1286 是否需要登录:是 
     1287 返回格式:json 
     1288 缓存方式:无 
     1289 缓存时间:无 
     1290 请求参数: 
     1291         common_session_id 
     1292         pageNo 
     1293         pageSize 
     1294 返回参数: 
     1295        { 
     1296                commentList: [ 
     1297                        { 
     1298                                commentId: 37283120, 
     1299                                currentFloor: 2, 
     1300                                formatCreateAt: "2014-10-29 09:40:58", 
     1301                                isSupportPurchasing: 0, 
     1302                                replyRefContent: ""看起来不错哦"", 
     1303                                sentNickName: "qz31244533", 
     1304                                textCommentContent: "怎么还要定金的呢", 
     1305                                topicId: 80671, 
     1306                                topicLogo: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1410/28/c0/40244951_1414478236223_150x150.jpg", 
     1307                                topicTitle: "双11预售:佳能 单反相机 1200D/18-55 套机", 
     1308                                topicType: 0, 
     1309                                topicURLForPCWeb: "http://best.pconline.com.cn/faxian_80671.html", 
     1310                                topicUrl: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671", 
     1311                                urlForComment: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671", 
     1312                                userLogo: "http://i1.3conline.com/images/upload/upc/face/28/46/70/67/28467067_100x100", 
     1313                                userface: "http://i1.3conline.com/images/upload/upc/face/31/24/45/33/31244533_100x100", 
     1314                                username: "arthinking" 
     1315                        }, 
     1316                        { 
     1317                                commentId: 36031627, 
     1318                                currentFloor: 17, 
     1319                                formatCreateAt: "2014-06-18 17:41:23", 
     1320                                isSupportPurchasing: 1, 
     1321                                replyRefContent: ""这是什么意思"", 
     1322                                sentNickName: "hejingdong", 
     1323                                textCommentContent: "?????", 
     1324                                topicId: 33113, 
     1325                                topicLogo: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1404/16/c1/33220567_1397629331699_150x150.png", 
     1326                                topicTitle: "ASICS 亚瑟士 GEL-Nimbus 15男士跑鞋 多色 ", 
     1327                                topicType: 2, 
     1328                                topicURLForPCWeb: "http://best.pconline.com.cn/chaozhi_33113.html", 
     1329                                topicUrl: "http://best.pconline.com.cn/discovery_art.jsp?topicId=33113", 
     1330                                urlForComment: "http://best.pconline.com.cn/discovery_art.jsp?topicId=33113", 
     1331                                userLogo: "http://i1.3conline.com/images/upload/upc/face/28/46/70/67/28467067_100x100", 
     1332                                userface: "http://i1.3conline.com/images/upload/upc/face/21/16/75/00/21167500_100x100", 
     1333                                username: "arthinking" 
     1334                        } 
     1335                ], 
     1336                pageNo: 1, 
     1337                pageSize: 20, 
     1338                total: 2 
     1339        } 
     1340}}} 
     1341 
     1342{{{ 
     1343 备注:个人中心 - 我收到的评论 
     1344 请求URL:http://best.pconline.com.cn/intf/iphone/my_comment_receivelist.jsp 
     1345 HTTP请求方式:get 
     1346 是否需要登录:是 
     1347 返回格式:json 
     1348 缓存方式:无 
     1349 缓存时间:无 
     1350 请求参数: 
     1351         common_session_id 
     1352         pageNo 
     1353         pageSize 
     1354 返回参数: 
     1355        { 
     1356                commentList: [ 
     1357                        { 
     1358                                commentId: 37283120, 
     1359                                currentFloor: 2, 
     1360                                formatCreateAt: "2014-10-29 09:40:58", 
     1361                                isSupportPurchasing: 0, 
     1362                                replyRefContent: ""看起来不错哦"", 
     1363                                sentNickName: "qz31244533", 
     1364                                textCommentContent: "怎么还要定金的呢", 
     1365                                topicId: 80671, 
     1366                                topicLogo: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1410/28/c0/40244951_1414478236223_150x150.jpg", 
     1367                                topicTitle: "双11预售:佳能 单反相机 1200D/18-55 套机", 
     1368                                topicType: 0, 
     1369                                topicURLForPCWeb: "http://best.pconline.com.cn/faxian_80671.html", 
     1370                                topicUrl: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671", 
     1371                                urlForComment: "http://best.pconline.com.cn/discovery_art.jsp?topicId=80671", 
     1372                                userLogo: "http://i1.3conline.com/images/upload/upc/face/28/46/70/67/28467067_100x100", 
     1373                                userface: "http://i1.3conline.com/images/upload/upc/face/31/24/45/33/31244533_100x100", 
     1374                                username: "arthinking" 
     1375                        }, 
     1376                        { 
     1377                                commentId: 36031627, 
     1378                                currentFloor: 17, 
     1379                                formatCreateAt: "2014-06-18 17:41:23", 
     1380                                isSupportPurchasing: 1, 
     1381                                replyRefContent: ""这是什么意思"", 
     1382                                sentNickName: "hejingdong", 
     1383                                textCommentContent: "?????", 
     1384                                topicId: 33113, 
     1385                                topicLogo: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1404/16/c1/33220567_1397629331699_150x150.png", 
     1386                                topicTitle: "ASICS 亚瑟士 GEL-Nimbus 15男士跑鞋 多色 ", 
     1387                                topicType: 2, 
     1388                                topicURLForPCWeb: "http://best.pconline.com.cn/chaozhi_33113.html", 
     1389                                topicUrl: "http://best.pconline.com.cn/discovery_art.jsp?topicId=33113", 
     1390                                urlForComment: "http://best.pconline.com.cn/discovery_art.jsp?topicId=33113", 
     1391                                userLogo: "http://i1.3conline.com/images/upload/upc/face/28/46/70/67/28467067_100x100", 
     1392                                userface: "http://i1.3conline.com/images/upload/upc/face/21/16/75/00/21167500_100x100", 
     1393                                username: "arthinking" 
     1394                        } 
     1395                ], 
     1396                pageNo: 1, 
     1397                pageSize: 20, 
     1398                total: 2 
     1399        } 
     1400}}} 
     1401 
     1402 
     1403 
     1404 
     1405=== 21.获取文章评论回复列表 === 
     1406{{{ 
     1407备注:获取文章评论回复列表。本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段;调用获取评论回复成功会清零这个接口的commentReplyCount字段 
     1408 请求URL:http://mrobot.xxx.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1 
     1409 HTTP请求方式:get 
     1410 是否需要登录:是 
     1411 返回格式:json 
     1412 缓存方式:无 
     1413 缓存时间:无 
     1414 请求参数: 
     1415        common_session_id:用户登陆后获得的认证id 
     1416        pageNo:页数 
     1417        pageSize:每页显示多少条 
     1418 返回参数: 
     1419        { 
     1420            "pageNo":1, 
     1421            "pageSize":20, 
     1422            "total":200, 
     1423            "resultList": [ 
     1424                            { 
     1425                                "id": 123123,   //1和2时,为帖子id,为3时是文章id 
     1426                                "type": 1,//1回复主贴,2回复回帖,3回复文章评论 
     1427                                "face": "",//头像 
     1428                                "userName": "xxx",//昵称 
     1429                                "userId": 6546, 
     1430                                "replyToUserName":"xxx",      // type为1时该字段有效。当用户A在我的主帖里回复了用户B,该字段返回用户B的昵称 
     1431                                "replyToUserId":123,            //该字段返回的时id,其他同"reply-to-userName" 
     1432                                "noticeId":123,消息id(删除消息需用此字段) 
     1433                                "createAt": 1382582506000, 
     1434                                "toReply": "引用内容", 
     1435                                "content": "回复内容", 
     1436                                "topicId":123,   // 如果这条回复是评论,则这是对应评论列表的主题id;如果是回复帖子,为0 
     1437                                "topicUrl":"" ,  // 如果这条回复是评论,则这是对应评论列表的主题url;如果是回复帖子,为空字符串 
     1438                                "title":"",      // 帖子或者文章标题 
     1439                                "floorId":123 ,  // 该回复的楼层id,评论和帖子都用这个字段 
     1440                                "floor":123      // 该回复的楼层数,评论和帖子都用这个字段 
     1441                            } 
     1442                        ] 
     1443        } 
     1444 ps:这接口内容有3种 
     1445 1.我发的帖子,别人回帖 
     1446 2.我发的回帖,别人回复 
     1447 3.我发的文章评论,别人回复 
     1448 请求后端URL: 
     1449        http://bip.xxx.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2030,2031&noTemplate=true&pageNo=1&pageSize=20 
     1450 请求后端参数: 
     1451        pageNo:页数 
     1452        pageSize:每页显示多少条 
     1453}}} 
     1454 
     1455=== 22.获取系统消息 === 
     1456{{{ 
     1457备注:获取聚超值系统消息 
     1458 请求URL:http://best.pconline.com.cn/intf/iphone/getSysNotice.jsp 
     1459 HTTP请求方式:get 
     1460 是否需要登录:是 
     1461 返回格式:json 
     1462 缓存方式:无 
     1463 缓存时间:无 
     1464 请求参数: 
     1465        common_session_id:用户登陆后获得的认证id 
     1466        pageNo:页数 
     1467        pageSize:每页显示多少条 
     1468 返回参数: 
     1469}}} 
     1470 
     1471 
     1472=== 23.获取消息数 === 
     1473{{{ 
     1474备注:获取聚超值系统消息,我发出的评论,我收到的评论数量 
     1475 请求URL:http://best.pconline.com.cn/intf/iphone/getSysNoticeAndCommentCount.jsp 
     1476 HTTP请求方式:get 
     1477 是否需要登录:是 
     1478 返回格式:json 
     1479 缓存方式:无 
     1480 缓存时间:无 
     1481 请求参数: 
     1482        common_session_id:用户登陆后获得的认证id 
     1483 返回参数: 
     1484}}} 
     1485 
     1486=== 24.求代购数量 === 
     1487{{{ 
     1488备注:终端页显示求代购的数量 
     1489 请求URL:http://best.pconline.com.cn/intf/iphone/getTopicBuyCount.jsp 
     1490 HTTP请求方式:get 
     1491 是否需要登录:是 
     1492 返回格式:json 
     1493 缓存方式:无 
     1494 缓存时间:无 
     1495 请求参数: 
     1496        common_session_id:用户登陆后获得的认证id 
     1497        topicId:商品id 
     1498 返回参数: 
     1499 
     1500{ 
     1501"count":1, 
     1502"limit":1 //商家为1,不能求购,否则为0 
     1503} 
     1504 
     1505 
     1506}}} 
     1507 
     1508=== 25.发送求代购 === 
     1509{{{ 
     1510备注:终端页发送求代购的信息 
     1511 请求URL:http://best.pconline.com.cn/intf/iphone/topicBuyCountAdd.jsp 
     1512 HTTP请求方式:post 
     1513 是否需要登录:是 
     1514 返回格式:json 
     1515 缓存方式:无 
     1516 缓存时间:无 
     1517 请求参数: 
     1518        common_session_id:用户登陆后获得的认证id 
     1519       name:   昵称 
     1520       price:   价格 
     1521       contactWay:  电话1,旺旺2,QQ3, 
     1522       contactInfo:对应的值 
     1523       topicId:  爆料Id 
     1524返回参数: 
     1525 
     1526status  状态  1正常 
     1527msg  提示信息 
     1528 返回参数: 
     1529 
     1530}}} 
     1531 
     1532=== 25.请求赞和踩的数量 === 
     1533{{{ 
     1534备注:优惠终端显示赞和踩,发现和海淘显示赞 
     1535 请求URL:http://best.pconline.com.cn/intf/iphone/topic_like_and_dislike_count.jsp 
     1536 HTTP请求方式:post 
     1537 是否需要登录:是 
     1538 返回格式:json 
     1539 缓存方式:无 
     1540 缓存时间:无 
     1541 请求参数: 
     1542       topicId:  爆料Id 
     1543返回参数: 
     1544 
     1545goodCount   赞 
     1546badCount  踩 
     1547isVoted 是否已投票,0 未投票   1 已投票 
     1548 
     1549}}} 
     1550 
     1551== V1.4.0新增的接口 == 
     1552=== 26.获取某个栏目下的爆料 === 
     1553{{{ 
     1554备注:新增的海淘,经验,晒物列表可调用此接口 
     1555 请求URL:http://best.pconline.com.cn/intf/iphone/getListBySection.jsp 
     1556 HTTP请求方式:get 
     1557 是否需要登录:否 
     1558 返回格式:json 
     1559 缓存方式:页面缓存 
     1560 缓存时间:默认300秒 
     1561 请求参数: 
     1562        time 缓存时间,默认600秒 
     1563        pageNo 页码 ,默认第一页 
     1564        pageSize 页面大小,默认50 
     1565        section 栏目:0优惠 1海淘 2发现 3晒物 4经验 
     1566        hd  是否高清   0 否  1 是  
     1567        callback 回调函数 
     1568返回参数: 
     1569        { 
     1570                mallId: 3, 
     1571                pageNo: 1, 
     1572                pageSize: 50, 
     1573                pageTotal: 1, 
     1574                topics: [ 
     1575                        { 
     1576                                bad: 0, 
     1577                                collectCount: 6, 
     1578                                commentNum: 0, 
     1579                                createName: "hyjfdd", 
     1580                                good: 6, 
     1581                                id: 62122, 
     1582                                image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1408/04/c3/37042358_1407138143134_255x255.jpg", 
     1583                                topicType: 2,  // 0发现,1优惠,2海淘,3晒物,4经验 
     1584                                overdueStatus: 0, 
     1585                                price: "99元", 
     1586                                pubDate: "2014-08-04 16:37:25", 
     1587                                showSource: 1,  // 是否显示直达链接 
     1588                                time: "2014-08-37", 
     1589                                title: "Segotep 鑫谷 光荣使命 GT 游戏主题机箱", 
     1590                                tryToGetWapSource: "http://item.yixun.com/item-1960415.html?YTAG=0.352600001300000?browser=fullscreen",  // 直达链接 
     1591                                currentPrice = "0.00"; //现在价格 
     1592                                discount = "0.0折"; //打折数 
     1593                                formerPrice = "0.00"; //之前价格 
     1594                                eb:"电商名称", 
     1595                                type: 2,    // showPicForApp:1 图片形式显示, 接口给出的对应值为2 
     1596                                products:[ 
     1597                               { 
     1598                                   "image":"http://", 
     1599                                   "title":"zzz" 
     1600                               }, { 
     1601                                   "image":"http://", 
     1602                                   "title":"zzz" 
     1603                               },{ 
     1604                                   "image":"http://", 
     1605                                   "title":"zzz" 
     1606                               } 
     1607                               ] 
     1608                        } 
     1609                ], 
     1610                total: 36, 
     1611                typeId: 2 
     1612        } 
     1613}}} 
     1614 
     1615---- 
     1616 
     1617=== 27.晒物列表 === 
     1618{{{ 
     1619备注:建议用接口26替换,传入section=3 
     1620请求URL:http://best.pconline.com.cn/intf/iphone/getSunplazaNew.jsp 
     1621HTTP请求方式:get 
     1622是否需要登录:否 
     1623返回格式:json 
     1624缓存方式:页面缓存 
     1625缓存时间:默认300秒 
     1626请求参数: 
     1627        time 缓存时间,默认600秒 
     1628        pageNo 页码 ,默认第一页 
     1629        pageSize 页面大小,默认50 
     1630        hd  是否高清   0 否  1 是 
     1631        callback 回调函数 
     1632返回参数: 
     1633        { 
     1634                topics: [ 
     1635                        { 
     1636                                bad: 0, 
     1637                                collectCount: 11, 
     1638                                commentNum: 20, 
     1639                                createName: "toprex", 
     1640                                good: 11, 
     1641                                id: 72926, 
     1642                                image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/22/c1/38849889_1411359481958_255x255.jpg", 
     1643                                topicType: 2,  // 0发现,1优惠,2海淘,3晒物,4经验 
     1644                                overdueStatus: 0, 
     1645                                price: "", 
     1646                                pubDate: "2014-09-22 12:18:35", 
     1647                                showSource: 1, 
     1648                                time: "2014-09-18", 
     1649                                title: "【体验报告】“乔治·派克梦想创造完美之笔”Parker 派克Matte GT钢笔礼盒装测评", 
     1650                                tryToGetWapSource: "" 
     1651                        } 
     1652                ] 
     1653        } 
     1654}}} 
     1655 
     1656---- 
     1657 
     1658=== 28.获取各个频道的收藏数量 === 
     1659{{{ 
     1660备注: 
     1661请求URL:http://best.pconline.com.cn/intf/iphone/getCollectsCountForUser_2nd.jsp 
     1662HTTP请求方式:get 
     1663是否需要登录:是 
     1664返回格式:json 
     1665缓存方式:页面缓存 
     1666缓存时间:默认300秒 
     1667请求参数: 
     1668返回参数: 
     1669        { 
     1670                counters: [ 
     1671                { 
     1672                        tabIndex: "1", 
     1673                        title: "海淘", 
     1674                        total: 0 
     1675                }, 
     1676                { 
     1677                        tabIndex: "2", 
     1678                        title: "优惠", 
     1679                        total: 0 
     1680                }, 
     1681                { 
     1682                        tabIndex: "3", 
     1683                        title: "发现", 
     1684                        total: 0 
     1685                }, 
     1686                { 
     1687                        tabIndex: "4", 
     1688                        title: "晒物", 
     1689                        total: 0 
     1690                }, 
     1691                { 
     1692                        tabIndex: "5", 
     1693                        title: "经验", 
     1694                        total: 0 
     1695                } 
     1696                ], 
     1697                msg: "获取成功", 
     1698                status: 1 
     1699        } 
     1700}}} 
     1701 
     1702---- 
     1703 
     1704=== 29.搜索热词 === 
     1705{{{ 
     1706备注: 
     1707请求URL:http://best.pconline.com.cn/intf/iphone/getHotSearchTerms.jsp 
     1708HTTP请求方式:get 
     1709是否需要登录:否 
     1710返回格式:json 
     1711缓存方式:页面缓存 
     1712缓存时间:默认300秒 
     1713请求参数: 
     1714返回参数: 
     1715        { 
     1716                data: [ 
     1717                { 
     1718                        encodeKey: "%E8%85%95%E8%A1%A8", 
     1719                        key: "腕表" 
     1720                }, 
     1721                { 
     1722                        encodeKey: "%E6%88%B7%E5%A4%96", 
     1723                        key: "户外" 
     1724                }, 
     1725                { 
     1726                        encodeKey: "%E4%B9%90%E9%AB%98", 
     1727                        key: "乐高" 
     1728                }, 
     1729                { 
     1730                        encodeKey: "%E6%B4%97%E6%8A%A4%E7%94%A8%E5%93%81", 
     1731                        key: "洗护用品" 
     1732                }, 
     1733                { 
     1734                        encodeKey: "%E8%B6%85%E6%9E%81%E6%9C%AC", 
     1735                        key: "超极本" 
     1736                }, 
     1737                { 
     1738                        encodeKey: "%E6%89%8B%E6%9C%BA", 
     1739                        key: "手机" 
     1740                } 
     1741                ] 
     1742        } 
     1743}}} 
     1744 
     1745---- 
     1746 
     1747=== 30.新版搜索接口 === 
     1748{{{ 
     1749备注: 
     1750请求URL:http://best.pconline.com.cn/intf/iphone/searchResult_2nd.jsp 
     1751HTTP请求方式:get 
     1752是否需要登录:否 
     1753返回格式:json 
     1754缓存方式:页面缓存 
     1755缓存时间:默认300秒 
     1756请求参数: 
     1757        time 缓存时间,默认300秒 
     1758        keyword 搜索关键词 
     1759        section  栏目:0优惠 1海淘 2发现 3晒物 4经验  
     1760        pageNo 当前第几页,默认1 
     1761        hd  是否高清   0 否  1 是 
     1762        pageSize 页面大小,默认20 
     1763返回参数: 
     1764        { 
     1765                count: { 
     1766                        FX_COUNT: 77, 
     1767                        HT_COUNT: 306, 
     1768                        JY_COUNT: 79, 
     1769                        SW_COUNT: 126, 
     1770                        YH_COUNT: 304 
     1771                }, 
     1772                pageCount: 16, 
     1773                pageNo: 1, 
     1774                pageSize: 20, 
     1775                pageTotal: 304, 
     1776                topics: [ 
     1777                        { 
     1778                                bad: 6, 
     1779                                collectCount: 19, 
     1780                                commentNum: 3, 
     1781                                createName: "sn33213295", 
     1782                                currentPrice: "326", 
     1783                                deprecated: 0, 
     1784                                discount: "32.6折", 
     1785                                eb: "美国亚马逊", 
     1786                                formerPrice: "100", 
     1787                                good: 3, 
     1788                                id: 67381, 
     1789                                image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1408/26/c2/37884229_1409037053106_350x350.png", 
     1790                                topicType: 2,  // 0发现,1优惠,2海淘,3晒物,4经验 
     1791                                isSupportPurchasing: 1, 
     1792                                overdueStatus: 0, 
     1793                                price: "35美元 约¥215", 
     1794                                pubDate: "2014-08-26 03:14:57", 
     1795                                showSource: 1, 
     1796                                title: "Wahoo Fitness iPhone自行车骑行套件", 
     1797                                tryToGetWapSource: "http://www.amazon.com/gp/product/B004SNPCE4/ref=as_li_ss_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B004HI2E6Y&linkCode=as2&tag=bp072-20?browser=fullscreen" 
     1798                        } 
     1799                ] 
     1800        } 
     1801}}} 
     1802 
     1803---- 
     1804 
     1805=== 31.爆料终端页 === 
     1806{{{ 
     1807备注: 
     1808请求URL:http://best.pconline.com.cn/intf/iphone/topicDetail_3rd.jsp 
     1809HTTP请求方式:get 
     1810是否需要登录:否 
     1811返回格式:json 
     1812缓存方式:页面缓存 
     1813缓存时间:默认300秒 
     1814请求参数: 
     1815        time 缓存时间,默认300秒 
     1816        topicId 爆料ID 
     1817        hd  是否高清   0 否  1 是 
     1818返回参数: 
     1819        返回wap页面 
     1820}}} 
     1821 
     1822---- 
     1823 
     1824=== 32.获取置顶广告位 === 
     1825{{{ 
     1826备注: 
     1827请求URL:http://best.pconline.com.cn/intf/iphone/getAdPositionList.jsp?type=5 
     1828HTTP请求方式:get 
     1829是否需要登录:否 
     1830返回格式:json 
     1831缓存方式:页面缓存 
     1832缓存时间:默认300秒 
     1833请求参数: 
     1834        time 缓存时间,默认300秒 
     1835        type 5 App首页置顶广告位   6 App海淘置顶广告位   7 App晒物置顶广告位   8 App经验置顶广告位 
     1836        pageNo 默认1 
     1837        pageSize  默认5 
     1838返回参数: 
     1839        { 
     1840                data: [ 
     1841                        { 
     1842                                adId: 51, 
     1843                                adTitle: "好东西哇", 
     1844                                createTime: "2014-09-25 14:15:55", 
     1845                                imageUrl: "", 
     1846                                imageUrl_170x70: "", 
     1847                                positionIndex: 5, 
     1848                                topic: { 
     1849                                        bad: 1, 
     1850                                        collectCount: 3, 
     1851                                        commentNum: 0, 
     1852                                        createName: "crazyhook", 
     1853                                        good: 2, 
     1854                                        id: 73727, 
     1855                                        image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/22/c2/38860140_1411372041425_255x255.jpg", 
     1856                                        overdueStatus: 0, 
     1857                                        price: "199.99美元约¥1227 (国内¥1799)", 
     1858                                        pubDate: "2014-09-22 15:49:42", 
     1859                                        showSource: 1, 
     1860                                        time: "2014-09-49", 
     1861                                        title: "Sony 索尼 PCM-M10 4GB 录音笔", 
     1862                                        topicType: 2, 
     1863                                        tryToGetWapSource: "http://www.amazon.com/gp/product/B002R56C4O/ref=as_li_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=B002R56C4O&linkCode=as2&tag=bp072-20&linkId=63QE7MVH4UJVR5QL&browser=fullscreen" 
     1864                                }, 
     1865                                url: "http://best.pconline.com.cn/haitao/73727.html", 
     1866                                urlType: 1  // 1 爆料    2 网页 
     1867                        }, 
     1868                        { 
     1869                                adId: 41, 
     1870                                adTitle: "标题", 
     1871                                createTime: "2014-09-25 12:01:41", 
     1872                                imageUrl: "", 
     1873                                imageUrl_170x70: "", 
     1874                                positionIndex: 5, 
     1875                                url: "http://best.pconline.com.cn", 
     1876                                urlType: 2  // 1 爆料    2 网页 
     1877                        } 
     1878                ] 
     1879        } 
     1880}}} 
     1881 
     1882---- 
     1883 
     1884=== 33.分类栏目接口 === 
     1885{{{ 
     1886备注: 
     1887请求URL:http://best.pconline.com.cn/intf/iphone/getSortChannel_2nd.jsp?type=0 
     1888HTTP请求方式:get 
     1889是否需要登录:否 
     1890返回格式:json 
     1891缓存方式:页面缓存 
     1892缓存时间:默认300秒 
     1893请求参数: 
     1894        time 缓存时间,默认300秒 
     1895        type 0  发现栏目  1 优惠栏目 
     1896        device 0  iOS   1 android 
     1897返回参数: 
     1898        { 
     1899                sections: [ 
     1900                { 
     1901                        section: [ 
     1902                        { 
     1903                                id: 0, 
     1904                                name: "最新发现", 
     1905                                mofangId: 194, 
     1906                                show: 1 
     1907                        }, 
     1908                        { 
     1909                                id: 1001, 
     1910                                name: "最热发现", 
     1911                                mofangId: 195, 
     1912                                show: 1, 
     1913                                url: "http://best.pconline.com.cn/intf/iphone/getTopicListOfTop.jsp?isIndex=0" 
     1914                        }, 
     1915                        { 
     1916                                id: 288, 
     1917                                mofangId: 196, 
     1918                                name: "电脑数码", 
     1919                                show: 1 
     1920                        }, 
     1921                        { 
     1922                                id: 1492, 
     1923                                mofangId: 197, 
     1924                                name: "礼品钟表", 
     1925                                show: 1 
     1926                        } 
     1927                        ], 
     1928                        sectionName: "发现栏目" 
     1929                } 
     1930                ]        
     1931        } 
     1932}}} 
     1933 
     1934---- 
     1935 
     1936=== 34.搜索推荐接口 === 
     1937{{{ 
     1938备注: 
     1939请求URL:http://ks.pconline.com.cn/SearchPrompt.shtml?q=ie&responseEncoding=utf-8&app=jcz&rt=json 
     1940HTTP请求方式:get 
     1941是否需要登录:否 
     1942返回格式: json 
     1943缓存方式:- 
     1944缓存时间:- 
     1945请求参数: 
     1946        q   搜索关键词(GBK编码) 
     1947返回参数: 
     1948        { 
     1949                app: "jcz", 
     1950                q: "ie", 
     1951                resault: [ 
     1952                { 
     1953                        num: "51", 
     1954                        title: "ie80" 
     1955                }, 
     1956                { 
     1957                        num: "32", 
     1958                        title: "ie2" 
     1959                }, 
     1960                { 
     1961                        num: "4", 
     1962                        title: "ie80i" 
     1963                } 
     1964                ] 
     1965        } 
     1966}}} 
     1967 
     1968---- 
     1969 
     1970== 35 加密接口 == 
     1971 
     1972=== 35.1 分类订阅 === 
     1973iOS调用接口: 
     1974{{{ 
     1975    url:http://best.pconline.com.cn/intf/iphone/subscription_add_sec.jsp 
     1976    参数: 
     1977     addition 附加信息:"token-timestamp" (timestamp 秒)  DES加密,10秒后失效 
     1978     ids: 
     1979     beginTime:(如果勿扰模式关闭了,就不传此字段) 
     1980     endTime:(如果勿扰模式关闭了,就不传此字段) 
     1981     open: (1发推送,0不发推送) 
     1982     sound:(1为有声音,0为无) 
     1983     shake:(1为有振动,0为无) 
     1984    请求方法:post 
     1985    是否需要登录:是 
     1986    返回参数: 
     1987    { 
     1988      "description":"token或者ids为空", 
     1989      "status":-2;       (1:成功 
     1990                          -1:ids不正确或者日期格式不正确  
     1991                          0:订阅失败  
     1992                          -2:token为空或者ids为空 
     1993                          -3:提交方式不对,请改用Post提交) 
     1994    } 
     1995      
     1996}}} 
     1997Android调用接口: 
     1998{{{ 
     1999    url:http://best.pconline.com.cn/intf/android/syncSubscribe_sec.jsp 
     2000    参数: 
     2001     addition: 附加信息:"token-timestamp" (timestamp 秒)  DES加密,10秒后失效 
     2002     typeIds: 
     2003     ipCheck: false 
     2004     beginTime:(如果勿扰模式关闭了,就不传此字段) 
     2005     endTime:(如果勿扰模式关闭了,就不传此字段) 
     2006     open: (1发推送,0不发推送) 
     2007     sound:(1为有声音,0为无) 
     2008     shake:(1为有振动,0为无) 
     2009     device: 1(固定传递1) 
     2010    请求方法:post 
     2011    是否需要登录:是 
     2012    返回参数: 
     2013    { 
     2014        "status":1, 
     2015        "msg":"设置成功" 
     2016    } 
     2017      
     2018}}} 
     2019=== 35.2 提交精准订阅规则 === 
     2020(维护:成荣伟) 
     2021{{{ 
     2022    url: http://best.pconline.com.cn/intf/iphone/subscription_second_add_sec.jsp 
     2023    请求参数:  
     2024       addition 附加信息:"token-timestamp" (timestamp 秒)  DES加密,10秒后失效 
     2025       typeId: 类别ID 
     2026       keyword: 关键词 
     2027       mallId: 电商ID 
     2028    请求方法:post 
     2029    是否需要登录:否 
     2030    返回参数: 
     2031}}} 
     2032 
     2033 
     2034=== 35.3 删除精准订阅规则 === 
     2035{{{ 
     2036    url: http://best.pconline.com.cn/intf/iphone/subscription_second_delete_sec.jsp 
     2037    请求参数:  
     2038         addition 附加信息:"token-timestamp" (timestamp 秒)  DES加密,10秒后失效 
     2039         subscriptionId: 订阅ID 
     2040    请求方法:post 
     2041    是否需要登录:否 
     2042    返回参数: 
     2043}}} 
     2044 
     2045=== 36 判断是否已经签到 === 
     2046{{{ 
     2047    url: http://best.pconline.com.cn/intf/iphone/checkSignInStatus.jsp 
     2048    请求参数:  
     2049        common_session_id: 登录后session,Cookies中 
     2050    请求方法:get 
     2051    是否需要登录:否 
     2052    返回参数: 
     2053    { 
     2054        status:1   // 1表示已签到,0表示未签到,-1表示未登录,-2其他错误信息 
     2055        days:2    // 连续签到天数 
     2056        msg: "提示信息" 
     2057    } 
     2058}}} 
     2059 
     2060 
     2061== V1.5.0新增的接口 == 
     2062=== 37.获取通知栏的内容 === 
     2063{{{ 
     2064备注:暂无 
     2065 请求URL:http://best.pconline.com.cn/intf/iphone/getNotificationBarInfo.jsp 
     2066 HTTP请求方式:get 
     2067 是否需要登录:否 
     2068 返回格式:json 
     2069 缓存方式:页面缓存 
     2070 缓存时间:默认300秒 
     2071 请求参数: 
     2072        time 缓存时间,默认600秒 
     2073        hd  是否高清   0 否  1 是  
     2074        callback 回调函数 
     2075返回参数: 
     2076        { 
     2077                status: 1,  // 1 表示成功 
     2078                data: [ 
     2079                        { 
     2080                                bad: 0, 
     2081                                collectCount: 0, 
     2082                                commentNum: 0, 
     2083                                createName: "fushu", 
     2084                                currentPrice: "300", 
     2085                                deprecated: 0, 
     2086                                discount: "6.0折", 
     2087                                eb: "苏宁易购", 
     2088                                formerPrice: "500", 
     2089                                good: 0, 
     2090                                id: 106501, 
     2091                                image: "http://test745.pconline.com.cn:9191/pc_best/1412/04/c0/3464658_1417654331575_100x100.png", 
     2092                                isSupportPurchasing: 1, 
     2093                                overdueStatus: 0, 
     2094                                price: "非常优惠哦", 
     2095                                pubDate: "2014-12-04 08:53:29", 
     2096                                showSource: 1, 
     2097                                title: "测试分类推送", 
     2098                                topicType: 1, 
     2099                                tryToGetWapSource: "http://v20.pcauto.com.cn:8003/pcauto/wap_index.jsp?browser=fullscreen", 
     2100                                type: 1 
     2101                        } 
     2102                ] 
     2103        } 
     2104}}} 
     2105 
     2106----