Table of Contents
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://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_@*/ 为结束标识
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)