[[TOC]]

== 1.基本约定 ==
{{{
接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况
}}}


== 2.接口列表 ==
=== 2.1 [=#point2.1 获取用户评论回复列表] ===
{{{
已上线
请求url:http://mrobot.pcauto.com.cn/v3/bbs/getCommentReplyReminds?pageNo=1&pageSize=20&common_session_id=DA4C99E3FDF2FDE5324ECBF12E49FA01455967336934FC30&contentAll=true
说明:这个是旧接口，V4.5.2此接口返回数据新增字段topicUrlBase——原文章/图赏的链接地址，用于区分文章评论回复或者图赏评论回复。其他没有任何改动。
}}}

=== 2.2 [=#point2.2 获取系统消息] ===
{{{
    未上线，请连192.168.22.145 8888进行测试
接口URL：http://mrobot.pcauto.com.cn/v3/bbs/getSysNotice?pageNo=1&pageSize=20&common_session_id=DA4C99E3FDF2FDE5324ECBF12E49FA01455967336934FC30&status=-1
源接口：url:http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&groupType=0&common_session_id=1EDAF266A5069CC86B3CCD35C67556B44CCA9329A316EE84&resp_enc=UTF-8&siteId=2&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8pageNo=1&pageSize=20&common_session_id=DA4C99E3FDF2FDE5324ECBF12E49FA01455967336934FC30&contentAll=true
源接口文档位置：http://trac.pc.com.cn/iphone/wiki/pcauto_4.2.0/interface#a2.10获取系统消息接口清零系统消息
说明:之前的版本获取系统消息，客户端直接使用源接口；V4.5.2开始使用mrobot同事提供的接口
必填参数：
    status=-1(-1为已读和未读，0表示未读，1表示已读)
    common_session_id 登录session
非必要参数：
    pageNo=页码
    pageSize=一页条数，默认20，最大500
是否需要登录：是
返回格式：json
缓存方式：无
返回结果：
    {
    "pageCount": 100,
    "pageNo": 1,
    "pageSize": 6,
    "resultList": [
        {
            "accountId": 25180941,
            "content": "您所在的车友会 主题车友会_秋 发起了一个新的活动阳江游，请前往参加！",
            "createTime": 1416477607000,
            "groupSend": 0,
            "groupType": 0,
            "id": 114380466,
            "resultText": "",
            "senderId": 0,
            "siteId": 2,
            "status": 1,
            "type": {
                "description": "论坛的系统通知,内容由论坛自己填写",
                "groupType": 0,
                "id": 2004,
                "name": "系统通知",
                "siteId": 2,
                "templateId": 2004
            },
            "typeId": 2004
        }],
      total:200
      }
}}}

=== 2.3 [=#point2.3 团购活动] ===
==== 2.3.1 [=#point2.3.1 团购活动列表] ====
{{{
    (接口未上线，请连192.168.21.94:8888进行测试）
    请求mrobot接口：http://mrobot.pcauto.com.cn/v3/price/activityListv45/3?pageNo=1&pageSize=1
    应用端接口：http://dev3.pcauto.com.cn:9977/autoMall/interface/auto_mall_gct_list_json.jsp?regionId=3
    请求参数：
    areaId：城市ID（必须，默认值1）
    manufacturerId：车厂ID（可选）
    pageNo：页码（默认1）
    pageSize：每页条数（默认20）
    返回结果：
    {
    "data": [
        {
            "banner": "http://img.pconline.com.cn/images/upload/upc/tx/tuangou/1411/14/c0/34350_1415973025778_500x200.jpg",  //购车团主图500x200px
            "beginTime": "2014/11/14 00:00:00",   //开始时间
            "brandName": "凯迪拉克(进口)",        //车厂名称
            "endTime": "2014/12/12 23:59:59",     //结束时间
            "id": 349,                            //购车团ID
            "maxDiscount": 5,                     //最高优惠,单位万.
            "orderCount": 2,                      //活动报名人数
            "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1403/18/c3/32200468_1395112948222_180x135.jpg",  //最大优惠车系主图,180x135像素 
            "priceTitle": "最高优惠",             //价格标题
            "serialGroupNames": "凯迪拉克SRX",    //车系名称串(最多5个)
            "title": "凯迪拉克厚惠无欺 万元优惠超值惊喜",   //购车团标题
            "url": "http://dev3.pcauto.com.cn:9977/gct/r3/g349/"  //购车团链接
        }
    ],
    "pageCount": 14,   //总页数
    "pageNo": 1,       //页码
    "pageSize": 1,     //页面条数
    "total": 14        //总条数
    }
}}}
==== 2.3.2 [=#point2.3.2 发起团购] ====
{{{
    (接口未上线，请连192.168.21.94:8888进行测试）
    请求方式：POST
    请求mrobot接口：http://mrobot.pcauto.com.cn/v3/search/mallPost
    应用端接口：http://dev3.pcauto.com.cn:9977/autoMall/gct/action/do_order.jsp
    请求参数格式：
    key：param
    value：
    {
      "userName": "huixuan",
      "regionId": 1,
      "isInitMsg": 1,
      "origin": 3,
      "phone": 13360009613,
      "carSerialId" : 4313,
      "referer" : "http://mrobot.pcauto.com.cn/autobuy/"
    }
    注意: （关于referer值）购车APP填写固定值:http://mrobot.pcauto.com.cn/autobuy/   用于记录报名来源于购车app
           (关于carSerialId值）isInitMsg=1时为必须
    参数说明如下表：
    
}}}
    ||参数名称||参数名||类型||说明||是否必须||
    ||经销商ID||dealerId||Long||默认0||必须||
    ||车型ID||modelId||Long||默认list||非必须||
    ||车系ID||sgId||Long||||必须||
    ||网友姓名||userName||String||||必须||
    ||网友省份||provinceId||Long||||必须||
    ||网友城市||regionId||Long||||必须||
    ||网友电话||phone||String||||必须||
    ||购车团ID||tsgId||Long||||必须||
    ||网友IP||ip||String||||非必须||
    ||来源URL||referer||String||见注意||必须||
    ||平台来源||origin||int||0未知,1:web,2:wap,3:IOS,4:Android,5:WP,6:杂志||必须||
    ||是否三人行||isInitMsg||int||0:购车团报名,1:三人行||必须||
    ||APP应用ID||appKey||String||||非必须||
    ||来源渠道ID||chId||String||||非必须||
    ||设备ID||devId||String||||非必须||
    ||车系ID||carSerialId||long||isInitMsg=1时为必须||必须||
==== 2.3.3 [=#point2.3.3 团购活动详情页] ====
{{{
原接口：http://mrobot.pcauto.com.cn/v3/price/activityDetail/
}}}