wiki:pcauto_drive_2.0.0/interface

1.基本约定


mrobot开发机代理:192.168.10.199 端口为 1080
mrobot开发机域名:dev40.pcauto.com.cn (warning:使用此域名或会导致某些html内嵌js请求产生跨域问题,不建议使用)
mrobot测试机代理:192.168.10.198 端口为 1080

2.接口列表

2.1 2.0接口

2.1.1 获取科目二,科目三问答人数

(接口已上线)
线上环境请求url:  http://mrobot.pcauto.com.cn/xsp/x/xueche.pcauto.com.cn/appapi/1.0/question/getPvCount.do
开发环境请求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 获取常见问题列表

(接口已上线)
请求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(科目一:22486,科目二:22505,科目三:22487,科目四:22515)
        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 搜索你的问题

(接口已上线)
请求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 论坛帖子列表

(接口已上线)
请求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 获取汽车资讯

(接口已上线)
请求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 获取活动列表

(接口已上线)
请求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)
            activeId: 233    (专家问答专题页出此字段,专家问答id)
        }
      ]
    }

2.1.7 请求红点

(接口已上线)
请求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 学习历程分享

(接口已上线)
请求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 排行榜分享

(接口已上线)
请求url:  http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankShare.xsp?imgUrl=

    应用后端url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:html
    缓存方式:无
    缓存时间:无
    请求参数: 
              imgUrl : 图片url 必填

2.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_@*/ 为结束标识