wiki:pcauto_drive_2.0.0/interface

Version 9 (modified by liguokai, 11 years ago) (diff)

--

Table of Contents

  1. 1.基本约定
  2. 2.接口列表
    1. 2.1 2.0接口
      1. 2.1.1 获取科目二，科目三问答人数
      2. 2.1.2 获取常见问题列表
      3. 2.1.3 搜索你的问题
      4. 2.1.4 论坛帖子列表
      5. 2.1.5 获取汽车资讯
      6. 2.1.6 获取活动列表
      7. 2.1.7 请求红点

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:

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
        pageNo 可选 默认为1
        pageSize 可选 默认为20
    
    返回结果:
   {
    code: 0,
    message: "操作成功",
    pageCount: 1,
    pageNo: 1,
    pageSize: 20,
    answerList: [
        {
            title: "有谁知道科目三考试内容及合格标准？？我准备要考了",
            url: "pcautobrowser://bbs-topic/7672518",
            type: true,
            answerCount: 11,
            browseCount: 91
        },
        {
            title: "跪求靠边停车30公分技巧~~？？马上要考科目三了",
            url: "pcautobrowser://bbs-topic/7704934",
            type: true,
            answerCount: 6,
            browseCount: 112
        },
        {
            title: "驾校科目三考试",
            url: "pcautobrowser://bbs-topic/7737373",
            type: true,
            answerCount: 9,
            browseCount: 57
        },
        {
            title: "路考灯光",
            url: "pcautobrowser://bbs-topic/7744245",
            type: true,
            answerCount: 8,
            browseCount: 59
        },
        {
            title: "驾照科目三考试内容",
            url: "pcautobrowser://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请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: keyword   ：搜索内容(必填)
              pageNo    ：当前页码（选填）
              pageSize  ：每页条数（选填） 
              subjectId ：科目id(选填) （科目一：22486；科目二：22505；科目三：22487；科目四：22515）
    返回结果:
    {
    "answerList": [
        {
            "hasBestAnswer": false,      //是否有最佳答案：true|false
            "keyword": "倒车入库,侧方位停车,离合,熄火,停下,倒车,看镜,后视镜,安全带,停车,调整,打死",    //关键词
            "replycount": 4,     //回答数
            "tid": 7560281,      //帖子id
            "title": "【广州增城】广州增城科目二满分通过，分享一下考场心得（含考场布局图）",   //标题
            "viewCount": 1       //浏览数
        }
    ],
    "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刷选)
              topicType (帖子类型  1：普通帖子；2：提问帖子; 0或不传查全部）
    返回结果:
    {
    "code": 0,
    "message": "操作成功",
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "topicList": [
        {
            "createBy": 31457462,
            "createDate": 1435221397000,
            "forumId": 22486,
            "forumName": "科目一",
            "imageList": [],
            "isPick": 0,
            "postCount": 8,
            "praiseCount": 0,
            "tagName": "原创",
            "title": "学车1.2测试",
            "topicId": 7809290,
            "userName": "Crazydemon",
            "userId": "31457462",
            "nickName": "Crazydemon",
            "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/31/45/74/62/31457462_100x100"
        },
       
        {
            "createBy": 13128876,
            "createDate": 1435717316000,
            "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"
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809286,
            "title": "学车发帖测试V2"
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809273,
            "title": "学车1.2发帖"
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809268,
            "title": "学车会同步科目一这个版块的帖子不V3"
        }
    ]
}

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日上市",
            url: "http://m.pcauto.com.cn/x/679/6790726.html",
            picUrl: "http://img0.pcauto.com.cn/pcauto/1507/14/g_6728785_1436863917510_240x160.jpg",
            time: "2015-07-27",
            id: "6790726"
        }
     ]
    }

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,
    contentList: [
        {
            title: "学车宝典v1.1 有奖公测！送自拍神器！",
            url: "http://m.pcauto.com.cn/bbs/topic-7729214.html",
            picUrl: "http://img0.pcauto.com.cn/pcauto/client/xcbd/tuijian000086326/1507/gongce.jpg",
            deadline: "2015-07-30",
            qudao: "xiaomi",
            urlType: 1,
            topicId: 7729214
        }
      ]
    }

2.1.7 请求红点

（开发已完成，测试请连开发机代理）
请求url:  http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/lastActivityTime.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”(渠道名称，必填)
    返回结果:
   {
    code: 0,
    message: "操作成功",
    timestamp: "1437375852000"
   }