[[TOC]] == 1.基本约定 == {{{ 1.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 2.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。 { "uri" : "/intf/albums-by-type.jsp", "error-desc":"Need you follow uid.", "user-notice":"给用户的提示放在这里" }` 3.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码: String queryString = request.getQueryString(); String requestEncoding = getParam(queryString,"req_enc"); String responseEncoding = getParam(queryString,"resp_enc"); if(isNotBlank(requestEncoding)){ request.setCharacterEncoding(requestEncoding); } if(isNotBlank(responseEncoding)){ response.setCharacterEncoding(responseEncoding); } 4.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。 5.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号。 6."2.1 优惠/发现 分类接口【v1.2】 "中的v1.2表示这个版本之后(不包括该版本)的app不调用该接口 }}} == 2.接口列表 == === 2.1 优惠/发现 分类接口【v1.2】 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getTopicType.jsp HTTP请求方式:get 是否需要登录:否 提交参数:isIndex:是否首页分类,1表示是,0表示不是,默认0 参数说明: 返回数据: { "order": [ //排序(发现页) { "name": "最新发现", //分类名字 "id": "0", //分类ID,用于2.2中的topicId参数 "imageSrc": "www.pconline.com.cn", //图标 "imageSrcPressed": "www.pconline.com.cn" //被选中的图标 }, { "name": "最热发现", "url": "www.pconlien.com.cn", "id": "0", "imageSrc": "www.pconline.com.cn", "imageSrcPressed": "www.pconline.com.cn" } ], "category": [ //优惠分类 { "name": "优惠精选", "id": "123", "imageSrc": "www.pconline.com.cn", "imageSrcPressed": "www.pconline.com.cn" }, { "name": "数码家电", "id": "124", "imageSrc": "www.pconline.com.cn", "imageSrcPressed": "www.pconline.com.cn" } ] } }}} === 2.2文章列表接口【v1.2】 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getTopicList.jsp 请求参数: pageNo:页码,默认1 pageSize:每页显示记录数,默认20 topSize 置顶文章数量,默认2条,最多10条 recommendIndex:是否推荐首页,默认0不推荐 topicTypeId:分类ID mallId:电商ID(可选) 请求方法:get 是否需要登录:否 返回参数: { "pageCount":9, //分页数 "pageNo":1, //页码 "pageTotal":35, // 数据总数 "topicTypeId: 0, //分类ID "focus": [ // 焦点图 { "id": "", topicType,1 //0发现,1优惠,:备注,字段名称从原来的type修改成topicType,//"type",1, //0发现,1优惠 "title": "", "image": "", "invalid": 1, "to-uri":""//跳转网页:http://xxx, 跳转晒单终端best-buy-show-order-terminal/id, 如果要跳转优惠和发现终端,则这个字段删掉 } ], top: [ // 置顶广告位 { adId: 51, adTitle: "好东西哇", createTime: "2014-09-25 14:15:55", imageUrl: "", imageUrl_170x70: "", positionIndex: 5, topic: { bad: 1, collectCount: 3, commentNum: 0, createName: "crazyhook", good: 2, id: 73727, image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/22/c2/38860140_1411372041425_255x255.jpg", overdueStatus: 0, price: "199.99美元约¥1227 (国内¥1799)", pubDate: "2014-09-22 15:49:42", showSource: 1, time: "2014-09-49", title: "Sony 索尼 PCM-M10 4GB 录音笔", topicType: 2, 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" }, url: "http://best.pconline.com.cn/haitao/73727.html", urlType: 1 // 1 爆料 2 网页 }, { adId: 41, adTitle: "标题", createTime: "2014-09-25 12:01:41", imageUrl: "", imageUrl_170x70: "", positionIndex: 5, url: "http://best.pconline.com.cn", urlType: 2 // 1 爆料 2 网页 } ], "topics":[ //数据 { "commentNum":"0", //评论数 "id":"2395585", "title":"有钱你就来", //标题 "topicType": 2, // 0发现,1优惠,2海淘,3晒物,4经验 "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png", //图片 "pubDate":"2013-02-03", //时间 "good":"20", //值的数量 "bad":"1", //不值的数量 "price":"只售998,还包邮~" //价格 "deprecated":1 //是否过期 currentPrice = "0.00"; //现在价格 discount = "0.0折"; //打折数 formerPrice = "0.00"; //之前价格 "eb":"电商名称", "overdueStatus":1, // 是否过期 "showSource":1, // 是否显示直达链接 "tryToGetWapSource" // wap直达链接 }, { "type":2, // showPicForApp:1 图片形式显示, 接口给出的对应值为2 "commentNum":"0", //评论数 "id":"2395585", "title":"白菜价合集", //标题 "pubDate":"2013-02-03", //时间 "good":"20", //值的数量 "bad":"1", //不值的数量 "price":"只售998,还包邮~" //价格 "deprecated":1 //是否过期 currentPrice = "0.00"; //现在价格 discount = "0.0折"; //打折数 formerPrice = "0.00"; //之前价格 "eb":"电商名称", "overdueStatus":1, // 是否过期 "showSource":1, // 是否显示直达链接 "tryToGetWapSource" // wap直达链接 "products":[ { "image":"http://", "title":"zzz" }, { "image":"http://", "title":"zzz" },{ "image":"http://", "title":"zzz" } ] } ], "pageSize":"20" //每页数据数 } }}} === 2.3 终端页接口【v1.2】 === (维护:成荣伟、制作:甘剑威) {{{ url:http://best.pconline.com.cn/intf/iphone/getTopicHtml.jsp 请求参数: topicId:爆料ID type:爆料类型 common_session_id: 登录后session,Cookies中 请求方法:get 是否需要登录:否 返回参数:web页面的html代码 备注: 附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾,里面的内容有评论url,标题以及发送微博用的图片url,用json格式,例如: }}} === 2.4 评论列表接口 === (客户端通用) {{{ url:http://mrobot.pconline.com.cn/v3/cmt/new_topics HTTP请求方式:get 是否需要登录:否 提交参数: topicId: 评论id articleId: 文章id 返回数据: { "comments": [ { //没有引用其他评论的评论 "1": { //表达其引用关系的key "id":"24991904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", //用户名称 "floor": "1737", //楼层 "time": "2013-01-05 09:05:40", //时间 "content": "内容过于暴力,已和谐" //内容 }, "current":"1", //当前最外层引用标识 "support":"10086" //"顶"数量 "expand":false //判断是否展开,默认为false }, { "3": { "id":"24991804",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "2": { "id":"24941904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "1": { "id":"24491904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "4": { "id":"24993904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", "floor": "1737", "time": "2013-01-05 09:05:40", "content": "内容过于暴力,已和谐" }, "current":"4", "support":"10086" //顶数 "expand":false //判断是否展开,默认为false } ], "hot-comments": [ { //没有引用其他评论的评论 "1": { //表达其引用关系的key "id":"24691904",//帖子id "name": "不是网易的江苏省盐城市网友 帅气飞扬: ", //用户名称 "floor": "1737", //楼层 "time": "2013-01-05 09:05:40", //时间 "content": "内容过于暴力,已和谐" //内容 }, "current":"1" "support":"10086" //顶数 "expand":false //判断是否展开,默认为false } ], "docUrl": "http://im_an_artical" } 备注: }}} === 2.5 发评论接口 === (客户端通用) {{{ http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp HTTP请求方式:post 是否需要登录:否 提交参数:id:话题id url:话题url common_session_id:太平洋通行证session username:用户名 anonymous:是否匿名 content:内容 replyFloor2:回复楼层(可选) 通过body传参 返回数据: { "commentId":25705754, "floor":27, "showName":"iostester", "brief":"Really good car hm~~~", "status":0, "createTime":"2013-07-19 10:37:03", "resultCode":0, "resultMsg":"您的评论已经成功发表。注:评论在审核后才能出现在列表中,谢谢!", "userId":25520497 } }}} === 顶评论接口 === (维护:成荣伟) {{{ url:http://cmt.pconline.com.cn/action/comment/support_json.jsp 请求参数: cid 评论id sp: sp>0表示支持,sp<=0表示反对 请求方法:post 是否需要登录:否 返回参数: { "support": 2, "floor": 2, "status": 0, "topicId": 13205153, "postId": 36813920 } { message: "您已对该评论投过票,不可重复投票", status: -1 } }}} === 2.6 值不值接口 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/likeAndDislike.jsp 请求参数: topicId:爆料ID operate:值或不值,0表示值,1表示不值 common_session_id:太平洋通行证session (当有登录时发,无登录时不发) 请求方法:get 是否需要登录:否 返回参数: { "resultCode":0, "resultMsg":"您的投票已经成功发表。注:评论在审核后才能出现在列表中,谢谢!" } }}} === 2.7 摇一摇接口 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getTopicListOfTop.jsp 备注:摇一摇接口出文章列表规则:当前时间算24小时内首页接口文章最新的100篇,不足100篇的话有多少出多少,时间按发布时间排序,不分页. 请求参数: 无 请求方法:get 是否需要登录:否 返回参数: { "pageCount":"1", "pageNo":"1", "data":[ { "commentNum":"0", "id":"2395585", "title":"“BMW大师殿堂”杨丽萍舞剧《孔雀》在陕西惊艳登场", "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png", "pubDate":"2013-02-03", //时间 "wroth":"1", //值的数量 "price":"160元包邮" //价格 } ], "pageSize":"20" } }}} === 2.8 太平洋统一登录接口 === (客户端通用) {{{ url:http://mrobot.pcauto.com.cn/proxy/passport2/login 备注: 请求参数:username:用户名 password:密码 请求方法:post 是否需要登录:否 返回参数: { "status": 0, "message": "ok", "session": "123456", "userId": 25520497, "common_session_id": "123456" } }}} === 2.9 晒单首页【v1.3】 === {{{ url:http://www.pconline.com.cn/jrzcz/app/1311/intf3741.js 备注: 请求参数: 请求方法:get 是否需要登录:否 返回参数: { topics: [ 帖子数组 { id: 48074, id image: "http://img0.pconline.com.cn/pconline/jrzcz/1311/28525424_1384151163247_0_1024x1024.jpg", 导读图 title: "晒屌丝破车升级20寸轮毂+土豪邻居新车", 标题 time: "2013-11-13" 发表时间 } ] } }}} === 3.0 晒单终端【v1.3】 === {{{ url:http://mrobot.pconline.com.cn/best/topics/45049?pageNo=1 备注: 请求参数:id_0:帖子id, pageNo:页数, authorId:为0时查看全部,为楼主id时只看楼主 请求方法:get 是否需要登录:否 //点击图片协议 pcaction://big-photo?data={"total":10, "currentIndex":10, "photos":["xxx.jpg", "xxx.jpg", "xxx.jpg" ...]} }}} === 3.1 回帖 === {{{ url:http://piebbs.pconline.com.cn/rest/topics/${topicId} 备注: 请求参数: agent = 1; message = 内容; replyToId = 31202601; 设置header Cookie = "common_session_id=xxxx"; 请求方法:post 是否需要登录:否 返回参数: }}} === 3.2 搜索【v1.3】 === {{{ url:http://best.pconline.com.cn/intf/iphone/searchResult.jsp 参数:
keyword 搜索关键词(会去除前后空格)String
 recommendIndex 优惠1/发现0 int 
pageNo 页号 int topicTypeIds(可选) 类型ID,多个的话用逗号分开 这边海淘传入13,同时海淘搜索要加入recommendIndex=1 
pageSize 页大小(默认20) 请求方法:get 是否需要登录:否 返回参数: { "pageCount":9, //分页数 "pageNo":1, //页码 "pageTotal":35, // 数据总数 "pagesize "topics":[ //数据 { "commentNum":"0", //评论数 "id":"2395585", "title":"有钱你就来", //标题 "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png", //图片 "pubDate":"2013-02-03", //时间 "good":"20", //值的数量 "bad":"1", //不值的数量 "price":"只售998,还包邮~" //价格 "deprecated":1 //是否过期 currentPrice = "0.00"; //现在价格 discount = "0.0折"; //打折数 formerPrice = "0.00"; //之前价格 “eb”:"电商名称", } ], "pageSize":"20" //每页数据数 } }}} === 3.3 搜索热词【v1.3】 === {{{ url:http://www.pconline.com.cn/jrzcz/app/1311/intf3722.js 备注: 请求参数: 请求方法:get 是否需要登录:否 返回参数: http://best.pconline.com.cn/intf/iphone/searchResult.jsp?recommendIndex=1&pageNo=1&pageSize=20&keyword= 首页推荐 http://best.pconline.com.cn/intf/iphone/searchResult.jsp?recommendIndex=0&pageNo=1&pageSize=20&keyword= 发现频道 http://best.pconline.com.cn/intf/iphone/searchResult.jsp?recommendIndex=1&pageNo=1&pageSize=20&topicTypeIds=13&keyword= 首页海淘咨询 }}} == V1.2.0新增的接口 == === 4.0 获取收藏列表 === {{{ url:http://best.pconline.com.cn/intf/iphone/getCollectsForApp.jsp 参数: common_session_id: 登录后session,Cookies中 index: 1 海淘, 2 优惠, 3 发现, 4 经验, 5 晒物 pageNo: pageSize: 请求方法:get 是否需要登录:否 返回参数: { "products": [ { "id": 123, “title”: "", "time": "", "price": "", "eb": "",(电商名称) "image": "http://xxx", "topicType": 2, // 0发现,1优惠,2海淘,3晒物,4经验 "invalid": (1已失效,0未失效) --后期增加 "good":"20", //值的数量 "bad":"1", //不值的数量 "commentNum":"0", //评论数 "createName":"Jason", // 作者 "collectCount":1 // 收藏数 } ], "pageNo": 1, "pageSize": 20, "total": 100 } 晒物和经验没有的字段,填入空字符串 }}} === 4.1 添加收藏 === {{{ url:http://best.pconline.com.cn/intf/iphone/collectForApp.jsp 参数: common_session_id: 登录后session,Cookies中 topicId:12312 type: 类型(1优惠、2发现、3海淘、4经验、5晒物)//暂时不用 请求方法:post 是否需要登录:否 返回参数: { "result": { "status": (1成功,0失败), "msg": (失败后的提示) } } }}} === 4.2 删除收藏 === {{{ url:http://best.pconline.com.cn/intf/iphone/deleteCollectForApp.jsp 参数: common_session_id: 登录后session,Cookies中 topicIds:12312,57847 id的串,用逗号分隔,可单个可多个 type: 类型(1优惠、2发现、3海淘、4经验、5晒物)//暂时不用 请求方法:post 是否需要登录:否 返回参数: { "result": { "status": (1成功,0失败), "msg": (失败后的提示) } } }}} === 4.3 获取用户各个收藏分类的收藏总数【v1.3】 === {{{ url:http://best.pconline.com.cn/intf/iphone/getCollectsCountForUser.jsp 参数: common_session_id: 登录后session,Cookies中 返回: "result": { "status": (1成功,0失败), "msg": (失败后的提示) "counters": [ { "id": 123, "title":"优惠" “total”: 28, }, { "id": 123, "title":"海淘" “total”: 28, } { "id": 123, "title":"发现" “total”: 28, } { "id": 123, "title":"晒物" “total”: 28, } { "id": 123, "title":"经验" “total”: 28, }]} }}} === 4.4 查询是否已收藏 === {{{ url:http://best.pconline.com.cn/intf/iphone/topicDetail_collectCount.jsp?topicId=26454 HTTP请求方式:get common_session_id: 登录后session,Cookies中 topicId:爆料Id 是否需要登录:否 返回值: status:状态 -1未登录 0登陆未收藏过 1登陆且已收藏 count:收藏数 #此接口查询后执行topicDetail.jsp的JS函数setFavCount来使页面变化# }}} === 5.0 海淘电商分类列表 === {{{ url:http://best.pconline.com.cn/intf/iphone/getMall.jsp HTTP请求方式:get 是否需要登录:否 参数说明: 格式与2.1的接口一致 返回数据: { "mall": [ { "iconImg": "", "id": 1, "name": "全部电商", "typeDesc": "国外", "typeId": 1 },{ "iconImg": "", "id": 1, "name": "京东", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 2, "name": "苏宁易购", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 3, "name": "易迅", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 4, "name": "亚马逊中国", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 5, "name": "天猫", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 6, "name": "1号店", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 7, "name": "美国亚马逊", "typeDesc": "国外", "typeId": 1 }, { "iconImg": "", "id": 8, "name": "日本亚马逊", "typeDesc": "国外", "typeId": 1 }, { "iconImg": "", "id": 9, "name": "当当", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 10, "name": "国美在线", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 11, "name": "库巴", "typeDesc": "国内", "typeId": 0 }, { "iconImg": "", "id": 12, "name": "淘宝", "typeDesc": "国内", "typeId": 0 } ] } }}} === 6.0 我的消息数 === {{{ url:http://best.pconline.com.cn/intf/iphone/myNewsForApp.jsp 参数: common_session_id: 登录后session,Cookies中 blTime:上次访问爆料时间,格式为:(YYYY-MM-DD HH:mm:ss) plTime:上次访问评论时间, 格式为:(YYYY-MM-DD HH:mm:ss) 请求方法:post 是否需要登录:否 返回参数: { "blCount":100 爆料数量 "plCount":100 评论数量 } }}} === 7.0 我的爆料 === {{{ url:http://best.pconline.com.cn/intf/iphone/myTipoffForApp.jsp 参数: common_session_id: 登录后session,Cookies中 pageNo: pageSize: status: 状态(1表示请求审核已经通过的列表,2表示请求未通过的列表) typeId: 类型(1 优惠海淘, 2 国内优惠, 3 发现频道, 4 经验, 5 待定)//暂时不用 请求方法:get 是否需要登录:是 返回参数: { "list": [ { "id": 123, "url": "", "time": 12312312, "title": "this is the brief of the post", "image": "http://xxx", "status": -1(1已通过,0审核中,-1不通过,说明:如果参数status请求时设置为1,此处应该全部是1) "reason": "抄袭!" --后期增加 ‘type’: //类型 "good":"20", //值的数量 "bad":"1", //不值的数量 "commentNum":"0", //评论数 "award": "奖励5金币", } ] } }}} === 8.0 签到 === {{{ url:http://best.pconline.com.cn/intf/iphone/signInForApp.jsp 参数: common_session_id: 登录后session,Cookies中 请求方法:post 是否需要登录:是 返回参数: { "status": 1(1成功,0失败,2已签到,4重复签到,和2同理) "msg":"签到成功", “day”: 2,(已签到次数) “addCoin”:2,(金币增加) "addInt"4,(积分增加) “gold”:100,(金币总数) "point"100,(积分总数) } }}} === 9.0用户基本信息 === {{{ url:http://best.pconline.com.cn/intf/iphone/myInfoForApp.jsp 参数: common_session_id: 登录后session,Cookies中 userId 请求方法:get 是否需要登录:是 返回参数: { "name":"用户名", "gold":50, "point"100, "status":(1成功,0是登录,-1是未登录) } }}} === 10.0专题接口【v1.3】 === {{{ url:http://best.pconline.com.cn/intf/iphone/special.jsp 参数: 请求方法:get 是否需要登录:是 返回参数:HTML页面 跳转协议: 晒单终端页(帖子终端页)pconlinebestbuy://best-buy-show-order-terminal/id 商品终端页(文章终端页)pconlinebestbuy://best-buy-article/id?type=${type=1 优惠 type=0 发现} 非晒单,终端页的网页 :普通URL+browser=fullscreen,例如:http://www.baidu.com?browser=fullscreen }}} === 11.0 订阅列表 === {{{ url:http://192.168.50.32:8082/intf/iphone/subscription_list.jsp 参数: 请求方法:get 是否需要登录:是 返回参数: { list:[ { id: name: img: } ] } }}} === 12.0 订阅【v1.3】 === {{{ url:http://192.168.50.32:8082/intf/iphone/subscription_add.jsp 参数: token: ids: beginTime:(如果勿扰模式关闭了,就不传此字段) endTime:(如果勿扰模式关闭了,就不传此字段) open: (1发推送,0不发推送) sound:(1为有声音,0为无) shake:(1为有振动,0为无) 请求方法:post 是否需要登录:是 返回参数: { "description":"token或者ids为空", "status":-2; (1:成功 -1:ids不正确或者日期格式不正确 0:订阅失败 -2:token为空或者ids为空 -3:提交方式不对,请改用Post提交) } }}} === 13 新终端页接口【v1.2】 === (维护:成荣伟、制作:黎军) {{{ url:http://best.pconline.com.cn/intf/iphone/topicDetail.jsp 请求参数: topicId:爆料ID common_session_id: 登录后session,Cookies中 请求方法:get 是否需要登录:否 返回参数:web页面的html代码 备注: 附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾,里面的内容有评论url,标题以及发送微博用的图片url,用json格式,例如: 收藏按钮点击跳转协议: pcaction://collect/id 取消收藏按钮点击跳转协议: pcaction://uncollect/id //点击图片协议 pcaction://big-photo?data={"total":10, "currentIndex":10, "photos":["xxx.jpg", "xxx.jpg", "xxx.jpg" ...]} //收藏成功后调用 setFavButtonStyle(collect) 【点击灰色状态收藏,变成有色状态调用:setFavButtonStyle(true);】 //进入页面时,查询是否收藏后 setFavCount(count,status) }}} === 14.海淘文章列表接口【v1.2】 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getIndexHaitaoByMallId.jsp 请求参数: pageNo:页码,默认1 pageSize:每页显示记录数,默认20 mallId:电商ID(可选) 请求方法:get 是否需要登录:否 返回参数: { "pageCount":9, //分页数 "pageNo":1, //页码 "pageTotal":35, // 数据总数 "topicTypeId: 0, //分类ID "focus": [ { "id": "", "title": "", "image": "", "invalid": 1 } ], "topics":[ //数据 { "commentNum":"0", //评论数 "id":"2395585", "title":"有钱你就来", //标题 "image":"http://img0.pcauto.com.cn/pcauto/1303/15/2395585_1.png", //图片 "pubDate":"2013-02-03", //时间 "good":"20", //值的数量 "bad":"1", //不值的数量 "price":"只售998,还包邮~" //价格 "deprecated":1 //是否过期 currentPrice = "0.00"; //现在价格 discount = "0.0折"; //打折数 formerPrice = "0.00"; //之前价格 “eb”:"电商名称", } ], "pageSize":"20" //每页数据数 } }}} == 1.3.0开始新增接口 == === 15.分类栏目接口【v1.3】 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getSortChannel.jsp 请求参数: type:1 优惠, 0发现 请求方法:get 是否需要登录:否 返回参数: { "section": { "sections": [ { "id": 1, "name": "神价格" },{ "id": 2, "name": "赶紧买" } ], "sectionName": "特色推荐" }, "default":[ { "id": 1, "name": "神价格" },{ "id": 2, "name": "赶紧买" } ] } }}} === 16.终端页【v1.3】 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/topicDetail_second.jsp 备注:优惠终端,发现终端,海淘终端 请求参数: topicId:爆料ID type:爆料类型 common_session_id: 登录后session,Cookies中 请求方法:get 是否需要登录:否 返回参数:web页面的html代码 备注: 附加信息用注释的方式放到html代码里面以/*@_HTML_META_START_开头, _HTML_META_END_@*/结尾,里面的内容有评论url,标题以及发送微博用的图片url,用json格式,例如: 点击代购信息,跳转协议:pconlinebestbuy://best-shop-list/id }}} === 16.1 商家列表接口 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getPurchasing.jsp 请求参数: topicId:商品id 请求方法:get 是否需要登录:否 返回参数:web页面的html代码 点击商家信息,直接跳转HTTP协议 }}} === 17.订阅规则 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/getSubscribeSelectItems.jsp 请求参数: 请求方法:get 是否需要登录:否 返回参数: { "ebs": [ { "id": 1, "name": "京东" }, { "id": 2, "name": "淘宝" } ], "types": [ { "id": 1, "name": "家电数码" }, { "id": 2, "name": "汽车用品" } ] } }}} === 17.1 提交订阅规则【v1.3】 === (维护:成荣伟) {{{ url: http://best.pconline.com.cn/intf/iphone/subscription_second_add.jsp 请求参数: token: token typeId: 类别ID keyword: 关键词 mallId: 电商ID 请求方法:post 是否需要登录:否 返回参数: }}} === 17.2 删除订阅规则【v1.3】 === {{{ url: http://best.pconline.com.cn/intf/iphone/subscription_second_delete.jsp 请求参数: token: token subscriptionId: 订阅ID 请求方法:post 是否需要登录:否 返回参数: }}} === 17.3 查询已订阅规则 === {{{ url:http://best.pconline.com.cn/intf/iphone/subscription_second_list.jsp?token=xxx 请求参数: token: 请求方法:get 是否需要登录:否 返回参数: id: 订阅ID keyword: 订阅关键词 keywordId: 订阅关键词ID mallId: 电商ID(0为全选) token: token typeId: 类别ID(0为全选) userId: 用户ID(暂未使用到,默认值0) }}} === 17.4 根据关键词出关键词列表 === {{{ 备注:例如输入索尼,给出列表:索尼单反,索尼微单 url: http://best.pconline.com.cn/intf/iphone/subscription_second_keyword_hint.jsp?token=351108013 请求参数: 请求方法:get 是否需要登录:否 返回参数: }}} === 18.订阅内容 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/subscription_second_topic_list.jsp?token=351108013 请求参数: time 缓存时间,默认300秒 token 用户唯一标识 pageNo 当前第几页,默认第一页 pageSize 页面大小,默认20 device 设备类型,默认为0,标识iOS 请求方法:get 是否需要登录:否 返回参数: 与getTopicList.jsp接口返回格式一致,加type,0发现1优惠2海淘 }}} === 19.我要爆料 === (维护:成荣伟) {{{ url:http://best.pconline.com.cn/intf/iphone/topic_add.jsp 请求参数: fromUrl: 爆料链接 content: 推荐理由 email: 电子邮件 请求方法:post 是否需要登录:否 返回参数: status: msg }}} === 20.个人中心-我的评论 === {{{ 备注:个人中心 - 我的评论 请求URL:http://mrobot.xxx.com.cn/v3/cmt/userCmtList/31836836 HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: UID:用户ID webSite: 返回参数: { "data": [ { "articleId": 4003061, "content": "很好的文章!!说不定哪天就用到了!!", "createTime": 1394361427000, "floor": 12, "id": 26731760, "ip": "192.168.239.90-113.64.110.39", "nickname": "dufu163", "replyRef": { }, "status": 2, "topicId": 13113197, "topicTitle": "证照手续不用愁(3)驾驶证丢了怎么办?", "topicUrl": "http://www.pcauto.com.cn/drivers/400/4003061.html", "url": "http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13113197.html" } ], "pageNo": 1, "pageSize": 20, "status": 0, "total": 1, "uid": 31836836 } 请求后端URL: http://cmt.xxx.com.cn/intf/uc_user_cmt.jsp?userId=31836836&webSite=xxx&pageNo=1&pageSize=20 }}} === 21.获取文章评论回复列表 === {{{ 备注:获取文章评论回复列表。本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段;调用获取评论回复成功会清零这个接口的commentReplyCount字段 请求URL:http://mrobot.xxx.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1 HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id pageNo:页数 pageSize:每页显示多少条 返回参数: { "pageNo":1, "pageSize":20, "total":200, "resultList": [ { "id": 123123, //1和2时,为帖子id,为3时是文章id "type": 1,//1回复主贴,2回复回帖,3回复文章评论 "face": "",//头像 "userName": "xxx",//昵称 "userId": 6546, "replyToUserName":"xxx", // type为1时该字段有效。当用户A在我的主帖里回复了用户B,该字段返回用户B的昵称 "replyToUserId":123, //该字段返回的时id,其他同"reply-to-userName" "noticeId":123,消息id(删除消息需用此字段) "createAt": 1382582506000, "toReply": "引用内容", "content": "回复内容", "topicId":123, // 如果这条回复是评论,则这是对应评论列表的主题id;如果是回复帖子,为0 "topicUrl":"" , // 如果这条回复是评论,则这是对应评论列表的主题url;如果是回复帖子,为空字符串 "title":"", // 帖子或者文章标题 "floorId":123 , // 该回复的楼层id,评论和帖子都用这个字段 "floor":123 // 该回复的楼层数,评论和帖子都用这个字段 } ] } ps:这接口内容有3种 1.我发的帖子,别人回帖 2.我发的回帖,别人回复 3.我发的文章评论,别人回复 请求后端URL: http://bip.xxx.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2030,2031&noTemplate=true&pageNo=1&pageSize=20 请求后端参数: pageNo:页数 pageSize:每页显示多少条 }}} === 22.获取系统消息 === {{{ 备注:获取聚超值系统消息 请求URL:http://best.pconline.com.cn/intf/iphone/getSysNotice.jsp HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id pageNo:页数 pageSize:每页显示多少条 返回参数: }}} === 23.获取消息数 === {{{ 备注:获取聚超值系统消息,我发出的评论,我收到的评论数量 请求URL:http://best.pconline.com.cn/intf/iphone/getSysNoticeAndCommentCount.jsp HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id 返回参数: }}} === 24.求代购数量 === {{{ 备注:终端页显示求代购的数量 请求URL:http://best.pconline.com.cn/intf/iphone/getTopicBuyCount.jsp HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id topicId:商品id 返回参数: { "count":1, "limit":1 //商家为1,不能求购,否则为0 } }}} === 25.发送求代购 === {{{ 备注:终端页发送求代购的信息 请求URL:http://best.pconline.com.cn/intf/iphone/topicBuyCountAdd.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: common_session_id:用户登陆后获得的认证id name: 昵称 price: 价格 contactWay: 电话1,旺旺2,QQ3, contactInfo:对应的值 topicId: 爆料Id 返回参数: status 状态 1正常 msg 提示信息 返回参数: }}} === 25.请求赞和踩的数量 === {{{ 备注:优惠终端显示赞和踩,发现和海淘显示赞 请求URL:http://best.pconline.com.cn/intf/iphone/topic_like_and_dislike_count.jsp HTTP请求方式:post 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: topicId: 爆料Id 返回参数: goodCount 赞 badCount 踩 }}} == V1.4.0新增的接口 == === 26.获取某个栏目下的爆料 === {{{ 备注:新增的海淘,经验,晒物列表可调用此接口 请求URL:http://best.pconline.com.cn/intf/iphone/getListBySection.jsp HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: time 缓存时间,默认600秒 pageNo 页码 ,默认第一页 pageSize 页面大小,默认50 section 栏目:0优惠 1海淘 2发现 3晒物 4经验 callback 回调函数 返回参数: { mallId: 3, pageNo: 1, pageSize: 50, pageTotal: 1, topics: [ { bad: 0, collectCount: 6, commentNum: 0, createName: "hyjfdd", good: 6, id: 62122, image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1408/04/c3/37042358_1407138143134_255x255.jpg", topicType: 2, // 0发现,1优惠,2海淘,3晒物,4经验 overdueStatus: 0, price: "99元", pubDate: "2014-08-04 16:37:25", showSource: 1, // 是否显示直达链接 time: "2014-08-37", title: "Segotep 鑫谷 光荣使命 GT 游戏主题机箱", tryToGetWapSource: "http://item.yixun.com/item-1960415.html?YTAG=0.352600001300000?browser=fullscreen", // 直达链接 currentPrice = "0.00"; //现在价格 discount = "0.0折"; //打折数 formerPrice = "0.00"; //之前价格 eb:"电商名称", type: 2, // showPicForApp:1 图片形式显示, 接口给出的对应值为2 products:[ { "image":"http://", "title":"zzz" }, { "image":"http://", "title":"zzz" },{ "image":"http://", "title":"zzz" } ] } ], total: 36, typeId: 2 } }}} ---- === 27.晒物列表 === {{{ 备注:可以用接口26替换,传入section=3 请求URL:http://best.pconline.com.cn/intf/iphone/getSunplazaNew.jsp HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: time 缓存时间,默认600秒 pageNo 页码 ,默认第一页 pageSize 页面大小,默认50 callback 回调函数 返回参数: { topics: [ { bad: 0, collectCount: 11, commentNum: 20, createName: "toprex", good: 11, id: 72926, image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/22/c1/38849889_1411359481958_255x255.jpg", topicType: 2, // 0发现,1优惠,2海淘,3晒物,4经验 overdueStatus: 0, price: "", pubDate: "2014-09-22 12:18:35", showSource: 1, time: "2014-09-18", title: "【体验报告】“乔治·派克梦想创造完美之笔”Parker 派克Matte GT钢笔礼盒装测评", tryToGetWapSource: "" } ] } }}} ---- === 28.获取各个频道的收藏数量 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/getCollectsCountForUser_2nd.jsp HTTP请求方式:get 是否需要登录:是 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: 返回参数: { counters: [ { tabIndex: "1", title: "海淘", total: 0 }, { tabIndex: "2", title: "优惠", total: 0 }, { tabIndex: "3", title: "发现", total: 0 }, { tabIndex: "4", title: "晒物", total: 0 }, { tabIndex: "5", title: "经验", total: 0 } ], msg: "获取成功", status: 1 } }}} ---- === 29.搜索热词 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/getHotSearchTerms.jsp HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: 返回参数: { data: [ { encodeKey: "%E8%85%95%E8%A1%A8", key: "腕表" }, { encodeKey: "%E6%88%B7%E5%A4%96", key: "户外" }, { encodeKey: "%E4%B9%90%E9%AB%98", key: "乐高" }, { encodeKey: "%E6%B4%97%E6%8A%A4%E7%94%A8%E5%93%81", key: "洗护用品" }, { encodeKey: "%E8%B6%85%E6%9E%81%E6%9C%AC", key: "超极本" }, { encodeKey: "%E6%89%8B%E6%9C%BA", key: "手机" } ] } }}} ---- === 30.新版搜索接口 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/searchResult_2nd.jsp HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: time 缓存时间,默认300秒 keyword 搜索关键词 section 栏目:0优惠 1海淘 2发现 3晒物 4经验 pageNo 当前第几页,默认1 pageSize 页面大小,默认20 返回参数: { count: { FX_COUNT: 77, HT_COUNT: 306, JY_COUNT: 79, SW_COUNT: 126, YH_COUNT: 304 }, pageCount: 16, pageNo: 1, pageSize: 20, pageTotal: 304, topics: [ { bad: 6, collectCount: 19, commentNum: 3, createName: "sn33213295", currentPrice: "326", deprecated: 0, discount: "32.6折", eb: "美国亚马逊", formerPrice: "100", good: 3, id: 67381, image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1408/26/c2/37884229_1409037053106_350x350.png", topicType: 2, // 0发现,1优惠,2海淘,3晒物,4经验 isSupportPurchasing: 1, overdueStatus: 0, price: "35美元 约¥215", pubDate: "2014-08-26 03:14:57", showSource: 1, title: "Wahoo Fitness iPhone自行车骑行套件", 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" } ] } }}} ---- === 31.爆料终端页 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/topicDetail_3rd.jsp HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: time 缓存时间,默认300秒 topicId 爆料ID 返回参数: 返回wap页面 }}} ---- === 32.获取置顶广告位 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/getAdPositionList.jsp?type=5 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: time 缓存时间,默认300秒 type 5 App首页置顶广告位 6 App海淘置顶广告位 7 App晒物置顶广告位 8 App经验置顶广告位 pageNo 默认1 pageSize 默认5 返回参数: { data: [ { adId: 51, adTitle: "好东西哇", createTime: "2014-09-25 14:15:55", imageUrl: "", imageUrl_170x70: "", positionIndex: 5, topic: { bad: 1, collectCount: 3, commentNum: 0, createName: "crazyhook", good: 2, id: 73727, image: "http://img.pconline.com.cn/images/upload/upc/tx/pc_best/1409/22/c2/38860140_1411372041425_255x255.jpg", overdueStatus: 0, price: "199.99美元约¥1227 (国内¥1799)", pubDate: "2014-09-22 15:49:42", showSource: 1, time: "2014-09-49", title: "Sony 索尼 PCM-M10 4GB 录音笔", topicType: 2, 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" }, url: "http://best.pconline.com.cn/haitao/73727.html", urlType: 1 // 1 爆料 2 网页 }, { adId: 41, adTitle: "标题", createTime: "2014-09-25 12:01:41", imageUrl: "", imageUrl_170x70: "", positionIndex: 5, url: "http://best.pconline.com.cn", urlType: 2 // 1 爆料 2 网页 } ] } }}} ---- === 33.分类栏目接口 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/getSortChannel_2nd.jsp?type=0 HTTP请求方式:get 是否需要登录:否 返回格式:json 缓存方式:页面缓存 缓存时间:默认300秒 请求参数: time 缓存时间,默认300秒 type 0 发现栏目 1 优惠栏目 返回参数: { sections: [ { section: [ { id: 0, name: "最新发现", show: 1 }, { id: 1001, name: "最热发现", show: 1, url: "http://best.pconline.com.cn/intf/iphone/getTopicListOfTop.jsp?isIndex=0" }, { id: 288, name: "电脑数码", show: 1 }, { id: 1492, name: "礼品钟表", show: 1 } ], sectionName: "发现栏目" } ] } }}} ---- === 34.搜索推荐接口 === {{{ 备注: 请求URL:http://best.pconline.com.cn/intf/iphone/search_keyword_hint.jsp?keyword=ipad HTTP请求方式:get 是否需要登录:否 返回格式: json 缓存方式:- 缓存时间:- 请求参数: keyword 搜索关键词 返回参数: { data: [ { count: "169", key: "ipad air" }, { count: "143", key: "ipadmini2" }, { count: "200", key: "ipad mini" }, { count: "25", key: "ipadmini2 32" }, { count: "36", key: "ipad 32g" }, { count: "8", key: "ipad mini 支架" }, { count: "318", key: "ipad4" }, { count: "27", key: "ipad mini 64" }, { count: "16", key: "ipad mini2 32g" }, { count: "51", key: "ipad套" } ] } } }}} ---- == 35 加密接口 == === 35.1 分类订阅 === iOS调用接口: {{{ url:http://best.pconline.com.cn/intf/iphone/subscription_add_sec.jsp 参数: addition 附加信息:"token-timestamp" (timestamp 秒) DES加密,10秒后失效 ids: beginTime:(如果勿扰模式关闭了,就不传此字段) endTime:(如果勿扰模式关闭了,就不传此字段) open: (1发推送,0不发推送) sound:(1为有声音,0为无) shake:(1为有振动,0为无) 请求方法:post 是否需要登录:是 返回参数: { "description":"token或者ids为空", "status":-2; (1:成功 -1:ids不正确或者日期格式不正确 0:订阅失败 -2:token为空或者ids为空 -3:提交方式不对,请改用Post提交) } }}} Android调用接口: {{{ url:http://best.pconline.com.cn/intf/iphone/subscription_add_sec.jsp 参数: addition 附加信息:"token-timestamp" (timestamp 秒) DES加密,10秒后失效 typeIds: beginTime:(如果勿扰模式关闭了,就不传此字段) endTime:(如果勿扰模式关闭了,就不传此字段) open: (1发推送,0不发推送) sound:(1为有声音,0为无) shake:(1为有振动,0为无) device: 1(固定传递1) 请求方法:post 是否需要登录:是 返回参数: success }}} === 35.2 提交精准订阅规则 === (维护:成荣伟) {{{ url: http://best.pconline.com.cn/intf/iphone/subscription_second_add_sec.jsp 请求参数: addition 附加信息:"token-timestamp" (timestamp 秒) DES加密,10秒后失效 typeId: 类别ID keyword: 关键词 mallId: 电商ID 请求方法:post 是否需要登录:否 返回参数: }}} === 35.3 删除精准订阅规则 === {{{ url: http://best.pconline.com.cn/intf/iphone/subscription_second_delete_sec.jsp 请求参数: addition 附加信息:"token-timestamp" (timestamp 秒) DES加密,10秒后失效 subscriptionId: 订阅ID 请求方法:post 是否需要登录:否 返回参数: }}}