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


Ignore:
Timestamp:
01/05/2015 03:09:57 PM (11 years ago)
Author:
tianjie
Comment:

修改文章取消顶踩接口；删除产品库筛选条件和搜索接口；增加最新消息数、推广列表、综合搜索接口

Legend:

Unmodified
Added
Removed
Modified

  • pconline_3.7.0/interface

    v1 v2  
    160160 } 
    161161}}} 
    162  
    163162 
    164163=== 2.2 [=#point202 首页 - 评论列表] === 
    … …  
    218217}}} 
    219218 
    220  
    221 === 2.3 [=#point203 首页 - 评论顶踩] === 
    222 {{{ 
    223 备注：顶踩评论(评论取消顶踩接⼝，如果⽤户登录，则传common_session_id，如果⽤户没登录，则不传) 
    224  请求URL：http://cmt.pconline.com.cn/action/comment/support_json.jsp?cid=26821494&sp=1&common_session_id=**** 
    225  HTTP请求方式：get 
    226  是否需要登录：否 
    227  返回格式：json 
    228  缓存方式：无 
    229  缓存时间：无 
    230  请求参数： 
    231         cid：评论ID 
    232         sp＝1（顶数量＋1）  sp=-1(顶数量-1) 
    233  返回参数: 
    234 { 
    235     "support": 3,                     //顶数量 
    236     "floor": 3,                       //楼层    
    237     "status": 0,                      //状态，0表示成功 
    238     "topicId": 13118127,             // 
    239     "postId": 26821494 
    240 } 
    241   
    242 }}} 
    243  
    244  
    245 === 2.4 [=#point204 产品库-品牌筛选列表] === 
    246 {{{ 
    247  备注:推荐品牌列表 
    248  请求URL:http://mrobot.pconline.com.cn/v2/product/models/criterion/{分类id}  (筛选接口需要持新的筛选功能；⽀持“品牌选项”、 “更多选项”使多选； “价格选项”、 “排序选项”使单选) 
    249  HTTP请求方式：get 
    250  是否需要登录：否 
    251  返回格式：json 
    252  缓存方式：无 
    253  缓存时间：无 
    254  请求参数：无 
    255 返回参数： 
    256 { 
    257     "criterion": [ 
    258         { 
    259             "cris": [ 
    260                 { 
    261                     "cId": "22586", 
    262                     "count": "220", 
    263                     "name": "三星", 
    264                     "value": 22586 
    265                 }, 
    266                 { 
    267                     "cId": "46291", 
    268                     "count": "95", 
    269                     "name": "HTC", 
    270                     "value": 46291 
    271                 } 
    272             ], 
    273             "name": "品牌", 
    274             "value": "品牌" 
    275         }, 
    276         { 
    277             "cris": [ 
    278                 { 
    279                     "count": "1000", 
    280                     "criId": "167", 
    281                     "name": "1000元以下", 
    282                     "value": "1 TO 999" 
    283                 }, 
    284                 { 
    285                     "count": "435", 
    286                     "criId": "169", 
    287                     "name": "1000-1500元", 
    288                     "value": "1000 TO 1500" 
    289                 }, 
    290                 { 
    291                     "count": "337", 
    292                     "criId": "170", 
    293                     "name": "1500-2000元", 
    294                     "value": "1500 TO 2000" 
    295                 }, 
    296                 { 
    297                     "count": "202", 
    298                     "criId": "171", 
    299                     "name": "2000-3000元", 
    300                     "value": "2000 TO 3000" 
    301                 }, 
    302                 { 
    303                     "count": "93", 
    304                     "criId": "173", 
    305                     "name": "3000-4000元", 
    306                     "value": "3000 TO 4000" 
    307                 }, 
    308                 { 
    309                     "count": "86", 
    310                     "criId": "3268", 
    311                     "name": "4000元以上", 
    312                     "value": "4001 TO 9999999" 
    313                 } 
    314             ], 
    315             "name": "价格", 
    316             "value": "price_100" 
    317         }, 
    318         { 
    319             "cris": [ 
    320                 { 
    321                     "count": "1000", 
    322                     "criId": "4927", 
    323                     "name": "GSM", 
    324                     "value": "GSM" 
    325                 }, 
    326                 { 
    327                     "count": "731", 
    328                     "criId": "4931", 
    329                     "name": "TD-SCDMA(移动3G)", 
    330                     "value": "TD-SCDMA(移动3G)" 
    331                 }, 
    332                 { 
    333                     "count": "1000", 
    334                     "criId": "4929", 
    335                     "name": "WCDMA(联通3G)", 
    336                     "value": "WCDMA(联通3G)" 
    337                 }, 
    338                 { 
    339                     "count": "345", 
    340                     "criId": "4930", 
    341                     "name": "CDMA2000(电信3G)", 
    342                     "value": "CDMA EV-DO(电信3G)" 
    343                 }, 
    344                 { 
    345                     "count": "90", 
    346                     "criId": "4934", 
    347                     "name": "双模(CDMA+GSM)", 
    348                     "value": "双模" 
    349                 } 
    350             ], 
    351             "name": "更多", 
    352             "value": "更多" 
    353         }, 
    354         { 
    355             "cris": [ 
    356                 { 
    357                     "count": "634", 
    358                     "criId": "12747", 
    359                     "name": "按价格", 
    360                     "value": "按价格" 
    361                 }, 
    362                 { 
    363                     "count": "608", 
    364                     "criId": "14266", 
    365                     "name": "按字母", 
    366                     "value": "按字母" 
    367                 } 
    368             ], 
    369             "name": "排序", 
    370             "value": "排序" 
    371         } 
    372     ] 
    373 } 
    374 }}} 
    375  
    376  
    377 === 2.5 [=#point205 产品库-品牌筛选列表] === 
    378 {{{ 
    379   备注:进入找产品页，选择产品分类，进入品牌列表，选择筛选，选择筛选条件之后查询 
    380  请求URL:http://mrobot.pconline.com.cn/v3/product/models/search/{分类id}?pageNo=1&orderId=1 
    381  HTTP请求方式：post 
    382  是否需要登录：否 
    383  返回格式：json 
    384  缓存方式：无 
    385  缓存时间：无 
    386  请求参数：{ 
    387 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"]}//查询的条件 
    388 pageNo:1//页码 
    389 orderId:1//排序条件 
    390 } 
    391 返回参数： 
    392 返回参数：{ 
    393 data: [ 
    394 { 
    395    hotNew: 0, 
    396    id: 548557, 
    397    idxPic: "http://img.pconline.com.cn/images/product/5485/548557/01_cn.jpg", 
    398    is-ultrabook: 0, 
    399    items: [ 
    400      "处理器", 
    401      "Intel Core i5-3337U(1.8GHz/L3 3M)", 
    402      "操作系统", 
    403      "Windows 8", 
    404      "内存容量", 
    405      "6GB", 
    406      "硬盘容量", 
    407      "500GB", 
    408      "屏幕尺寸", 
    409      "15.6英寸", 
    410      "分辨率", 
    411      "1366×768", 
    412      "显卡芯片", 
    413      "AMD Radeon HD 8730M,+Intel HD 4000" 
    414     ], 
    415     noPriceMsg: "新品", 
    416     price: 3999, 
    417     shortName: "戴尔Inspiron灵越 15R(Ins15RD-2628)", 
    418     url: "http://mrobot.pconline.com.cn/v3/product/abstact/548557" 
    419 }， 
    420 ]， 
    421 pageCount: 1, 
    422 pageNo: 1, 
    423 pageSize: 25, 
    424 total: 2 
    425 } 
    426 }}} 
    427  
    428  
    429 === 2.6 [=#point206 图赏-推荐图集] === 
     219=== 2.3 [=#point203 首页 - 取消文章顶踩] === 
     220{{{ 
     221备注：取消文章顶踩(如果⽤户登录，则传common_session_id，如果⽤户没登录，则不传)；直接使用Web端接口 
     222     文章顶踩接口，客户端需要修改(如果⽤户登录，则传common_session_id，如果⽤户没登录，则不传)；HTTP请求方式为POST（参考bip接口文档） 
     223mrobot url：暂无 
     224Web端 url：http://bip.pconline.com.cn/intf/article.jsp?act=addArtAgree&siteId=1&articleId=5105797&isAgree=1 
     225HTTP请求方式：POST 
     226是否需要登录：否 
     227返回格式：json 
     228缓存方式：无 
     229缓存时间：无 
     230请求参数： 
     231    act：请求动作，delArtAgree为取消顶、踩文章 
     232    siteId:主网站id，电脑网为1 
     233    articleId：文章id 
     234    isAgree：取消顶或踩：1表示“取消顶”；2表示“取消踩” 
     235 
     236返回结果： 
     237  {"code":0,"message":"取消赞、踩文章成功"} 
     238  {"code":-1,"message":"文章不存在"} 
     239  如果isAgree为空 
     240  {"code":-1,"message":"缺少isAgree参数"} 
     241 
     242  如果用户已经登录： 
     243  {"code":1,"message":"该文章未被该IP用户赞过"} 
     244  {"code":2,"message":"该文章未被该IP用户踩过"} 
     245  如果用户未登录： 
     246  {"code":1,"message":"该文章未被该用户赞过"} 
     247  {"code":2,"message":"该文章未被该用户踩过"} 
     248 
     249}}} 
     250 
     251=== 2.4 [=#point204 图赏 - 推荐图集] === 
    430252{{{ 
    431253 备注：滚动到图集最后一张图后显示推荐图集 
    … …  
    439261 返回参数： 
    440262 [ 
     263   { 
     264     "id": 130583,//图集id 
     265     "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图，尺寸待定 
     266     "photoCount": "10",//图片数 
     267     "title": "图集标题" 
     268   }, 
     269   { 
     270     "id": 130583,//图集id 
     271     "image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图，尺寸待定 
     272     "photoCount": "10",//图片数 
     273     "title": "图集标题" 
     274   }, 
    441275   { 
    442276     "id": 130583,//图集id 
    … …  
    448282}}} 
    449283 
    450  
    451 === 2.7 [=#point207 个人中心-用户信息] === 
     284=== 2.5 [=#point205 个人中心 - 用户信息] === 
    452285{{{ 
    453286 备注：个人中心，登录之后的用户信息 
    … …  
    482315}}} 
    483316 
    484 === 2.8 [=#point208 个人中心-获取粉丝,关注列表] === 
    485 {{{ 
    486  备注：返回包括粉丝,关注列表 
     317=== 2.6 [=#point206 个人中心 - 获取粉丝、关注列表] === 
     318{{{ 
     319 备注：返回包括粉丝、关注列表 
    487320 请求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 
    488321 HTTP请求方式：get 
    … …  
    517350}}} 
    518351 
    519  
    520 === 2.9 [=#point209 个人中心-收发私信列表] === 
    521 {{{ 
    522  备注：收到与发出的私信列表 
     352=== 2.7 [=#point207 个人中心 - 收到的私信列表、发出的私信列表] === 
     353{{{ 
     354 备注：收到的私信列表、发出的私信列表 
    523355 请求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 
    524356 HTTP请求方式：get 
    … …  
    557389}}} 
    558390 
    559  
    560 === 2.10 [=#point2010 个人中心-发私信接口] === 
    561 {{{ 
    562   备注：发私信接口 
     391=== 2.8 [=#point208 个人中心 - 发私信、回复私信接口] === 
     392{{{ 
     393  备注：发私信、回复私信接口 
    563394 请求URL:http://bip.pconline.com.cn/intf/message.jsp 
    564395 HTTP请求方式：post 
    … …  
    587418}}} 
    588419 
    589 === 2.11 [=#point2011 个人中心-修改昵称] === 
     420=== 2.9 [=#point209 个人中心 - 修改昵称] === 
    590421{{{ 
    591422  备注：修改昵称 
    … …  
    606437}}} 
    607438 
    608 === 2.12 [=#point2012 个人中心-修改头像] === 
     439=== 2.10 [=#point210 个人中心 - 修改头像] === 
    609440{{{ 
    610441  备注：修改头像 
    … …  
    621452}}} 
    622453 
    623  
    624 === 2.13 [=#point2013 个人中心-关注&取消关注] === 
    625 {{{ 
    626  备注：关注&取消关注 
     454=== 2.11 [=#point211 个人中心 - 关注、取消关注] === 
     455{{{ 
     456 备注：关注、取消关注 
    627457 请求URL：http://m.pconline.com.cn/bip/intf/focus.jsp 
    628458 HTTP请求方式：post 
    … …  
    642472}}} 
    643473 
    644  
    645 === 2.14 [=#point2014 个人中心-判断与某用户的关系(关注与非关注)] === 
     474=== 2.12 [=#point212 个人中心 - 判断与某用户的关系(关注与非关注)] === 
    646475{{{ 
    647476 备注：判断与某用户的关系 
    … …  
    663492}}} 
    664493 
    665  
    666 === 2.15 [=#point2015 个人中心-他人主页] === 
     494=== 2.13 [=#point213 个人中心 - 他人主页] === 
    667495{{{ 
    668496 备注：获取他人最新动态接口 
    … …  
    676504        UID:用户ID 
    677505}}} 
     506 
     507=== 2.14 [=#point214 个人中心 - 最新消息数] === 
     508{{{ 
     509 备注：最新消息数接口，增加新的私信消息数 
     510 请求URL：http://mrobot.pconline.com.cn/v3/itbbs/getNewMsgCount?accountId=31356890 
     511 HTTP请求方式：get 
     512 是否需要登录：是 
     513 返回格式：json 
     514 缓存方式：无 
     515 缓存时间：无 
     516 请求参数： 
     517        accountId:用户ID 
     518}}} 
     519 
     520=== 2.15 [=#point215 个人中心 - 推广位列表] === 
     521{{{ 
     522 备注：返回推广位列表；uri参数部分需要按百分号转义 
     523 请求URL：http://mrobot.pconline.com.cn/v2/cms/proxy?uri=http://app.pconline.com.cn/appnews/tghd/1403/intf4501.js 
     524 HTTP请求方式：get 
     525 是否需要登录：是 
     526 返回格式：json 
     527 缓存方式：无 
     528 缓存时间：无 
     529 请求参数： 
     530        uri：被代理的原始接口 
     531 返回结果： 
     532        { 
     533            data:[ 
     534                { 
     535                    "title": "元旦刮卡抽399元智能水杯", 
     536                    "to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1" 
     537                }, 
     538                { 
     539                    "title": "元旦刮卡抽399元智能水杯", 
     540                    "to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1" 
     541                }, 
     542                { 
     543                    "title": "元旦刮卡抽399元智能水杯", 
     544                    "to-uri": "http://play10.pconline.com.cn/online141226/index.jsp?fromapp=1" 
     545                } 
     546            ] 
     547        } 
     548}}} 
     549 
     550=== 2.16 [=#point2.16 搜索 - 综合搜索] === 
     551{{{ 
     552请求url:http://mrobot.pconline.com.cn/v3/search/composite?keyword=华为 
     553HTTP请求方式:GET 
     554是否需要登录:false 
     555返回格式:JSON 
     556缓存方式:对象缓存 
     557缓存时间:1分钟 
     558请求参数: 
     559  keyword：搜索的关键词 
     560返回结果: 
     561{ 
     562  "productList": [ 
     563    { 
     564      "id": "559363", 
     565      "pic": "http://img.pconline.com.cn/images/product/5593/559363/z_sn7.jpg", 
     566      "price": 798.0, 
     567      "summary": "2G/3G网络:GSM,TD-SCDMA(移动3G),双卡双待 | 主屏尺寸:5.0英寸 | 屏幕分辨率:1280×720像素(720P) | 系统:Android 4.2 | 电池容量:可更换,2300mAH | CPU:MT6582 1.3GHz(4核)", 
     568      "title": "华为 荣耀3C移动3G版/1GB RAM" 
     569    }, 
     570    { 
     571      "id": "557535", 
     572      "pic": "http://img.pconline.com.cn/images/product/5575/557535/q_sn7.jpg", 
     573      "price": 1099.0, 
     574      "summary": "2G/3G网络:GSM,WCDMA(联通3G),TD-SCDMA(移动3G),双卡双待 | 主屏尺寸:5.5英寸 | 屏幕分辨率:1280×720像素(720P) | 系统:Android 4.2 | 电池容量:3000mAH | CPU:MT6592 1.7GHz(8核)", 
     575      "title": "华为 荣耀3X(G750)" 
     576    } 
     577  ], 
     578  "articleList": [ 
     579    { 
     580      "id": "5941716", 
     581      "pubDate": "2014-12-29", 
     582      "title": "先于华为！高通810芯片Cat 9基带附体", 
     583      "url": "http://pad.pconline.com.cn/594/5941716.html" 
     584    }, 
     585    { 
     586      "id": "5926456", 
     587      "pubDate": "2014-12-25", 
     588      "title": "华为新款旗舰P8曝光 配置飙升指纹前置", 
     589      "url": "http://mobile.pconline.com.cn/592/5926456.html" 
     590    } 
     591  ], 
     592  "topicList": [ 
     593    { 
     594      "access": "6", 
     595      "authorId": "4177236", 
     596      "createAt": 1420388222000, 
     597      "flag": "", 
     598      "forumId": 240027, 
     599      "replycount": "6", 
     600      "title": "华为 Mate7 曜石黑 移动版，仅开封，带票皮套", 
     601      "topicId": 51994488, 
     602      "userName": "jccong" 
     603    }, 
     604    { 
     605      "access": "0", 
     606      "authorId": "26654840", 
     607      "createAt": 1420429064000, 
     608      "flag": "", 
     609      "forumId": 587012, 
     610      "replycount": "0", 
     611      "title": "【我有我自·在】华为Ascend G7伴我圣诞购物行②强悍性能", 
     612      "topicId": 51995084, 
     613      "userName": "余闻星堕地" 
     614    } 
     615  ], 
     616} 
     617}}}