price_jiekou – iphone

Context Navigation

Version 141 (modified by hejingdong, 12 years ago) (diff)
--

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是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号。

2.接口列表

2.1 优惠/发现分类接口

（维护：成荣伟）

    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文章列表接口

（维护：成荣伟）

    url:http://best.pconline.com.cn/intf/iphone/getTopicList.jsp
    请求参数: pageNo：页码，默认1
	           pageSize：每页显示记录数，默认20
	           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,  如果要跳转优惠和发现终端，则这个字段删掉
    }
   ],
    "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”:"电商名称",
        },
        {
            "type":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"; //之前价格
            "products":[
                  {
                    "image":"http://",
                    "title":"zzz"
                  }, {
                    "image":"http://",
                    "title":"zzz"
                  },{
                    "image":"http://",
                    "title":"zzz"
                  }
            ]
        }
    ],
    "pageSize":"20" //每页数据数
}

2.3 终端页接口

（维护：成荣伟、制作：甘剑威）

    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格式,例如:

<!-- 
/*@_HTML_META_START_    
{"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"}
_HTML_META_END_@*/
 -->

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": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",  //用户名称
        "floor": "1737",  //楼层
        "time": "2013-01-05 09:05:40",  //时间
        "content": "内容过于暴力,已和谐" //内容
      },
      "current":"1",               //当前最外层引用标识
      "support":"10086"       //"顶"数量
      "expand":false  //判断是否展开，默认为false
    },
    {
      "3": {
        "id":"24991804",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "floor": "1737",
        "time": "2013-01-05 09:05:40",
        "content": "内容过于暴力,已和谐"
      },
      "2": {
        "id":"24941904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "floor": "1737",
        "time": "2013-01-05 09:05:40",
        "content": "内容过于暴力,已和谐"
      },
      "1": {
        "id":"24491904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "floor": "1737",
        "time": "2013-01-05 09:05:40",
        "content": "内容过于暴力,已和谐"
      },
      "4": {
        "id":"24993904",//帖子id
        "name": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",
        "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": "不是网易的江苏省盐城市网友&nbsp;帅气飞扬： ",  //用户名称
        "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&nbsp;good&nbsp;car&nbsp;hm~~~",
    "status":0,
    "createTime":"2013-07-19 10:37:03",
    "resultCode":0,
    "resultMsg":"您的评论已经成功发表。注：评论在审核后才能出现在列表中,谢谢！",
    "userId":25520497
}

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 晒单首页

    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 晒单终端

    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 搜索

    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 搜索热词

    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",
      "invalid": (1已失效，0未失效)
     --后期增加 
     "good":"20",    //值的数量
     "bad":"1",        //不值的数量
      "commentNum":"0",    //评论数
    }
  ],
  "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 获取用户各个收藏分类的收藏总数

    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专题接口

    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 订阅

    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 新终端页接口

（维护：成荣伟、制作：黎军）

    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格式,例如:

<!-- 
/*@_HTML_META_START_    
{"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"}
_HTML_META_END_@*/
 -->

收藏按钮点击跳转协议：
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.海淘文章列表接口

（维护：成荣伟）

    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.分类栏目接口

（维护：成荣伟）

    url:http://best.pconline.com.cn/intf/iphone/
    请求参数: type：1 优惠， 0发现
    请求方法：get
    是否需要登录：否
    返回参数：
{
  "section": {
    "sections": [
      {
        "id": 1,
        "name": "神价格"
      },{
        "id": 2,
        "name": "赶紧买"
      }
    ],
    "sectionName": "特色推荐"
  },
  "default":[
    {
        "id": 1,
        "name": "神价格"
      },{
        "id": 2,
        "name": "赶紧买"
      }
  ]
}

16.终端页

（维护：成荣伟）

    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格式,例如:

<!-- 
/*@_HTML_META_START_    
{"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"}
_HTML_META_END_@*/
 -->

点击代购信息，跳转协议：pcaction://best_purchasing/id

点击商家信息，直接跳转HTTP协议

16.1 求购信息列表接口

（维护：成荣伟）

    url:http://best.pconline.com.cn/intf/iphone/
    请求参数: 
    请求方法：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 提交订阅规则

（维护：成荣伟）

    url: http://best.pconline.com.cn/intf/iphone/subscription_second_add.jsp
    请求参数: 
       token: token
       typeId: 类别ID
       keyword: 关键词
       mallId: 电商ID
    请求方法：post
    是否需要登录：否
    返回参数：

17.2 删除订阅规则

    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
    请求参数: 
    请求方法：get
    是否需要登录：否
    返回参数：
与getTopicList.jsp接口返回格式一致

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请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        pageNo：页数
        pageSize：每页显示多少条
 返回参数：

23.获取消息数

备注：获取聚超值系统消息，我发出的评论，我收到的评论数量
 请求URL：
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
 返回参数：

24.求代购数量

备注：终端页显示求代购的数量
 请求URL：getTopicBuyCount.jsp
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
        topicId:商品id
 返回参数：

{
"count":1,
"limit":1 //商家为1，不能求购，否则为0
}

25.发送求代购

备注：终端页发送求代购的信息
 请求URL：topicBuyCountAdd.jsp
 HTTP请求方式：post
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数：
        common_session_id：用户登陆后获得的认证id
       name:   昵称
       price:   价格
       telphone:  电话
       wangwang:  旺旺
       qq:  QQ
       topicId:  爆料Id
返回参数：

status  状态  1正常
msg  提示信息
 返回参数：

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1.基本约定

2.接口列表

2.1 优惠/发现 分类接口

2.2文章列表接口

2.3 终端页接口

2.4 评论列表接口

2.5 发评论接口

2.6 值不值接口

2.7 摇一摇接口

2.8 太平洋统一登录接口

2.9 晒单首页

3.0 晒单终端

3.1 回帖

3.2 搜索

3.3 搜索热词

V1.2.0新增的接口

4.0 获取收藏列表

4.1 添加收藏

4.2 删除收藏

4.3 获取用户各个收藏分类的收藏总数

4.4 查询是否已收藏

5.0 海淘电商分类列表

6.0 我的消息数

7.0 我的爆料

8.0 签到

9.0用户基本信息

10.0专题接口

11.0 订阅列表

12.0 订阅

13 新终端页接口

14.海淘文章列表接口

1.3.0开始新增接口

15.分类栏目接口

16.终端页

16.1 求购信息列表接口

17.订阅规则

17.1 提交订阅规则

17.2 删除订阅规则

17.3 查询已订阅规则

17.4 根据关键词出关键词列表

18.订阅内容

19.我要爆料

20.个人中心-我的评论

21.获取文章评论回复列表

22.获取系统消息

23.获取消息数

24.求代购数量

25.发送求代购

Download in other formats:

2.1 优惠/发现分类接口