[[TOC]]
== 1.基本约定 ==
[[BR]]mrobot开发机代理：192.168.10.199 端口为 1080
[[BR]]mrobot开发机域名：dev40.pcauto.com.cn       '''(warning：使用此域名或会导致某些html内嵌js请求产生跨域问题，不建议使用）'''
[[BR]]mrobot测试机代理：192.168.10.198 端口为 1080

== 2.接口列表 ==

=== 2.1 [=#point2.1 2.0接口] ===
==== 2.1.1 [=#point2.1.1 获取科目二，科目三问答人数] ====
（接口已上线）[[BR]]
'''线上环境请求url''': http://mrobot.pcauto.com.cn/xsp/x/xueche.pcauto.com.cn/appapi/1.0/question/getPvCount.do [[BR]]
'''开发环境请求url''': http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/question/getPvCount.do
{{{
    应用后端url：
                 xueche.pcauto.com.cn/appapi/1.0/question/getPvCount.do
    说明 : 获取教练问答阅读数
    1.缓存1小时
    2.次数X3，等于显示数字
    请求参数 ：无
    是否登录 : 否
    缓存时间 : 有（1小时）
    是否分页 : 否

返回结果
{

   pvCount:阅读数

   code : 0成功，-1失败
   message : 提示信息
   version : 接口版本号如1.0，1.0（latest)表示最新版本
}             
}}}
==== 2.1.2 [=#point2.1.2 获取常见问题列表] ====
（开发已完成，测试请连开发机代理）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/commonQuestion.xsp?subjectId=22487&pageNo=1&pageSize=20
{{{
    应用后端url： 
                  http://www.pcauto.com.cn/client/xcbd/1507/intf7331.js 
                  http://bbs.pcauto.com.cn/xcappapi/1/topics/viewAndReplyCount.ajax?topicIds=    
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
        subject 必填 科目版块id
        pageNo 可选 默认为1
        pageSize 可选 默认为20
    
    返回结果:
   {
    code: 0,   (0正常，-1异常)
    message: "操作成功",  (提示信息)
    pageCount: 1,  (总页数)
    pageNo: 1,    (页码)
    pageSize: 20,   (每页多少条)
    answerList: [
        {
            title: "有谁知道科目三考试内容及合格标准？？我准备要考了",
            url: "pcdrive://bbs-topic/7672518",    (终端web地址，bbs.pcauto.com转为协议)
            type: true,     （false代表普通问答，true代表精华问答）
            answerCount: 11,  (回答数)
            browseCount: 91   （浏览数）
        },
        {
            title: "跪求靠边停车30公分技巧~~？？马上要考科目三了",
            url: "pcdrive://bbs-topic/7704934",
            type: true,
            answerCount: 6,
            browseCount: 112  
        },
        {
            title: "驾校科目三考试",
            url: "pcdrive://bbs-topic/7737373",
            type: true,
            answerCount: 9,
            browseCount: 57
        },
        {
            title: "路考灯光",
            url: "pcdrive://bbs-topic/7744245",
            type: true,
            answerCount: 8,
            browseCount: 59
        },
        {
            title: "驾照科目三考试内容",
            url: "pcdrive://bbs-topic/7834176",
            type: true,
            answerCount: 5,
            browseCount: 59
        }
     ]
   }

}}}
==== 2.1.3 [=#point2.1.3  搜索你的问题] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/v3/search/xueCheQA?keyword=%E6%8B%B3%E6%89%93%E6%96%B9%E5%90%91%E7%9B%98%E8%84%9A%E8%B8%A2%E5%90%8E%E8%A7%86%E9%95%9C&subjectId=22505&pageNo=1&pageSize=20
{{{
    应用后端url：
              http://192.168.75.98:8986/solr/pcauto_bbs_xc/select?wt=json&skipFreezed=true&sort=score%20desc,hasBestAnswer%20desc,replycount%20desc,viewCount%20desc&useSynonym=true&fl=hasBestAnswer,keyword,viewCount,replycount,title,tid&rows=20&start=0&q=%28keyword%3A%22%E6%96%B9%E5%90%91%E7%9B%98%22+keyword%3A%22%E5%90%8E%E8%A7%86%E9%95%9C%22+%29AND+fid%3A22505（快搜根据关键词搜索接口）
              http://bbs.pcauto.com.cn/xcappapi/1/topics/viewAndReplyCount.ajax?topicIds=（批量查询浏览数、回复数接口）
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: keyword   ：搜索内容(必填)
              pageNo    ：当前页码（选填）
              pageSize  ：每页条数（选填） 
              subjectId ：科目id(选填) （科目一：22486；科目二：22505；科目三：22487；科目四：22515）
    返回结果:
    {
    "answerList": [
        {
            "type": false,      //（false代表普通问答，true代表精华问答）
            "answerCount": 4,     //回答数
            "tid": 7560281,      //帖子id
            "title": "【广州增城】广州增城科目二满分通过，分享一下考场心得（含考场布局图）",   //标题
            "browseCount": 1       //浏览数
            "url":"pcdrive://bbs-topic/{topicId}"    //帖子终端页协议
        }
    ],
    "pageCount": 1,      //总页数
    "pageNo": 1,         //当前页码
    "pageSize": 20       //每页条数
}
}}}
==== 2.1.4 [=#point2.1.4 论坛帖子列表] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getTopicList.xsp?forumId=
{{{
    应用后端url：
              http://xueche.pcauto.com.cn/appapi/1.0/topic/getTopicListByForumId.do?forumId=    （根据版块ID获取帖子列表）
              http://bbs.pcauto.com.cn/xcappapi/1/forum/listForumTopTopics.ajax?resp_enc=utf-8&fid=  （根据版块ID获取topList数据）
              http://my.pcauto.com.cn/intf/client/getUserById.jsp?id=           (获取个人信息批量接口)
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: forumId  (必填)
              pageNo （选填）
              pageSize（选填） 
              tagName(选填) 
              xssEncode (0 原内容 ;1 过滤xss，对<>内容做转义处理)
              topicType (帖子类型  1：普通帖子；2：提问帖子; 0或不传查全部）
    返回结果:
    {
    "code": 0,
    "message": "操作成功",
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "topicList": [
        {
            "createBy": 31457462,    (发帖人ID)   
            "createDate": 1435221397000,   (帖子发布时间 时间戳）
            "type":帖子类型（1：普通帖子；2：提问帖子）,
            "forumId": 22486,  (版块ID)
            "forumName": "科目一",  (版块名字)
            "imageList": [],   
            "isPick": 0,   (是否精华 0：非,1:是）
            "postCount": 8,    (评论数)
            "praiseCount": 0,    (赞数)
            "tagName": "原创",    （标签名称）
            "title": "学车1.2测试",  （帖子标题）
            "topicId": 7809290,    （帖子id）
            "userName": "Crazydemon",  （用户名）
            "userId": "31457462",    （用户id）
            "nickName": "Crazydemon",   （发帖人昵称）
            "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/31/45/74/62/31457462_100x100"   （用户头像）
        },
       
        {
            "createBy": 13128876,
            "createDate": 1435717316000,
            "type":帖子类型（1：普通帖子；2：提问帖子）,
            "forumId": 22486,
            "forumName": "科目一",
            "imageList": [],
            "isPick": 0,
            "postCount": 12,
            "praiseCount": 0,
            "tagName": "原创",
            "title": "测试bip接口",
            "topicId": 7809323,
            "userName": "3edc4rfv",
            "userId": "13128876",
            "nickName": "2222",
            "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/13/12/88/76/13128876_100x100"
        }
    ],
    "total": 2,
    "version": "v1.0(latest)",
    "topList": [
        {
            "isPick": true,
            "tag": "提问",
            "tid": 7809289,
            "title": "学车1.2－发提问帖修改版V1",
            "type":帖子类型（1：普通帖子；2：提问帖子）
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809286,
            "title": "学车发帖测试V2",
            "type":帖子类型（1：普通帖子；2：提问帖子）
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809273,
            "title": "学车1.2发帖",
            "type":帖子类型（1：普通帖子；2：提问帖子）
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809268,
            "title": "学车会同步科目一这个版块的帖子不V3",
            "type":帖子类型（1：普通帖子；2：提问帖子
        }
    ]
}
}}}
==== 2.1.5 [=#point2.1.5 获取汽车资讯] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/pcautoInfo.xsp?pageNo=1&pageSize=20
{{{
    应用后端url：
              http://www.pcauto.com.cn/client/xcbd/1507/intf7351.js
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: pageNo 
              pageSize
    返回结果:
    {
    code: 0,
    message: "操作成功",
    pageCount: 8,
    pageNo: 1,
    pageSize: 20,
    contentList: [
        {
            title: "起亚全新嘉华配置信息 将于7月30日上市",  （标题）
            webUrl: "http://m.pcauto.com.cn/x/679/6790726.html",   （web地址）
            imgUrl: "http://img0.pcauto.com.cn/pcauto/1507/14/g_6728785_1436863917510_240x160.jpg",  （图片链接）
            createTime: "2015-07-27",     （创建日期）
            id: "6790726"    （帖子id）
        }
     ]
    }
}}}
==== 2.1.6 [=#point2.1.6 获取活动列表] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/activityList.xsp?pageNo=1&pageSize=20&agent=11&channel=xiaomi
{{{
    应用后端url：
              http://www.pcauto.com.cn/client/xcbd/1507/intf7371.js
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: agent: 10代表ios  11代表android（必填）
              channel：“xiaomi”(渠道名称 必填)
              pageNo 
              pageSize
    返回结果:
    {
    code: 0,
    message: "操作成功",
    pageCount: 1,
    pageNo: 1,
    pageSize: 20,
    timestamp: "1438141932000", (最新活动时间戳)
    contentList: [
        {
            title: "学车宝典v1.1 有奖公测！送自拍神器！",  （帖子标题）
            webUrl: "pcdrive://bbs-topic/7729214",   （专题跟游戏时为对应跳转url, 论坛帖子出协议）
            imgUrl: "http://img0.pcauto.com.cn/pcauto/client/xcbd/tuijian000086326/1507/gongce.jpg",  （图片链接）
            deadline: "2015-07-30",  （日期）
            qudao: "xiaomi",     （渠道）
            urlType: 1,      (0:专题页面,1:帖子详情页，2:小游戏)
            topicId: 7729214   （帖子id）
        }
      ]
    }
}}}
==== 2.1.7 [=#point2.1.7 请求红点] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/lastActivityTime.xsp?agent=11&channel=xiaomi
{{{
    应用后端url：
              http://www.pcauto.com.cn/client/xcbd/1507/intf7371.js
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: agent: 10代表ios  11代表android（必填）
              channel：“xiaomi”(渠道名称，必填)
    返回结果:
   {
    code: 0,
    message: "操作成功",
    timestamp: "1437375852000"   （该设备/渠道下最新一个活动的时间）
   }
}}}
==== 2.1.8 [=#point2.1.8 学习历程分享] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/courseShare.xsp?imgUrl=http://i6.3conline.com/images/upload/upc/face/33/41/39/08/33413908_120x120   &nickName=%E6%B5%8B%E8%AF%95&subject1=99&subject1_test=5&subject2=42&subject3=60&subject4=20&subject4_test=11&day_amount=111
{{{
    应用后端url：
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:html
    缓存方式:无
    缓存时间:无
    请求参数: 
              imgUrl : 头像url 非必填
              nickName : 昵称   非必填   
              subject1 : 科目一  非必填 默认为0
              subject1_test : 科目一考试次数 非必填 默认为0
              subject2 ： 科目二 非必填 默认为0
              subject3 ： 科目三 非必填 默认为0
              subject4 ： 科目四 非必填 默认为0
              subject4_test ： 科目四考试次数 非必填 默认为0
              day_amount ： 天数 非必填 默认为1
}}}
==== 2.1.9 [=#point2.1.9 排行榜分享] ====
（接口已上线）[[BR]]
'''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankShare.xsp?imgUrl=
{{{
    应用后端url：
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:html
    缓存方式:无
    缓存时间:无
    请求参数: 
              imgUrl : 图片url 必填
}}}
==== 2.1.10 [=#point2.1.10 活动页面 ] ====

'''请求url''': 由接口2.1.6活动列表页传入
{{{
    应用后端url：
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:html
    缓存方式:无
    缓存时间:无
    请求参数: 
             
   调用客户端登陆页面跳转协议：pcdrivebrowser://user-login/
   调用客户端分享控件跳转协议：pcdrivebrowser://activity-share
   通知客户端刷新自定义分享内容跳转协议：pcdrivebrowser://changePreView/xxxxx 【xxxxx表示传入新的注释 改变分享内容】
  
   在页面嵌入js注释，以 /*@_HTML_META_START_  _HTML_META_END_@*/ 为起始标识，
   APP载入页面时，会检测起始标识，取出里面的对象并解析
  {
    firstPic : "表示分享出去的图片",
    title : "分享标题",
    preView : "分享出去的描述",
    wap_url : "分享出去的url",
    showShare : "是否显示分享按钮 1为显示 0 为隐藏 默认为1",
    sinaName : "分享到新浪微博时增加要@的用户 ， 默认为空的话是@太平洋汽车网"
  }
 _HTML_META_END_@*/ 为结束标识
}}}