Changes between Initial Version and Version 1 of pcauto_drive_2.2.0/interface

Timestamp:

09/10/2015 02:21:34 PM (11 years ago)

Author:

lianchijin

Comment:

--

pcauto_drive_2.2.0/interface

@@ +1 @@
+[[TOC]]
+
+= 学车2.2.0接口文档 =
+>mrobot代理环境说明： 
+     192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]] 
+     192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] 
+     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]] 
+     制作地址： [[BR]] 
+     应用后端接口trac：
+== 1.学分任务与商城 ==
+----------
+
+
+=== 1.1我的 ===
+'''(V1.1版本 2.7获取个人信息接口增加返回用户学分字段)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getPersonalinf.xsp [[BR]]
+
+**说明**
+
+> 获取个人信息接口增加返回用户学分字段[[BR]]
+
+**缓存时间**
+
+>分钟
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 是
+
+**数据来源**
+
+> 
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
+||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie，放在请求头中 =||
+
+**返回**
+
+{{{#!java
+{
+      "code": 0,
+      "gender": 0,
+      "message": "成功",
+      "address": "",
+      "drivingSchool": "未报考驾校",
+      "drivingSchoolId": -2,
+      "nickName": "hahahahahaha",
+      "userId": 31836836,
+      "cityName": "",
+      "cityId": 0
+      "score":用户学分（新增字段）
+}
+}}}
+
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= score =||= 用户学分（新增字段） =||= =||==||
+
+----------
+
+== 2.考场 ==
+----------
+
+
+=== 2.1考场城市列表 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址： http://mrobot.pcauto.com.cn/xsp/x/xueche.pcauto.com.cn/appapi/1.0/examArea/listExamArea.do [[BR]]
+学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamArea.do [[BR]]
+学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/examArea/listExamArea.do [[BR]]
+
+**说明**
+
+> 获取已知考场的城市列表
+
+**缓存时间**
+
+>0
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+>学车后台
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
+
+**返回**
+
+{{{#!java
+{
+    "code": 0,
+    "data": [
+        {
+            "cityId": 440100,
+            "cityName": "广东"
+        }
+    ],
+    "message": "操作成功",
+    "version": "v1.0(latest)"
+}
+}}}
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= cityId =||= 城市id =||=cityName=||=城市名称=||
+
+
+
+=== 2.2考场列表 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/x/xueche.pcauto.com.cn/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
+学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
+学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
+
+**说明**
+
+> 获取某个城市下的考场列表
+
+**缓存时间**
+
+>0
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+>学车后台
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
+||= cityId =||= 城市id =||= int =||= 无 =||= 是 =||= =||
+
+**返回**
+
+{{{#!java
+{
+    "code": 0,
+    "data": [
+        {
+            "cityId": 440100,
+            "id": 160,
+            "name": "秀全驾校",
+            "provinceId": 440000,
+            "shrinkTagram": [
+                {
+                    "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/07/c0/10835360_1438940428057_&1&.jpg"
+                }
+            ]
+        },
+        {
+            "cityId": 440100,
+            "id": 161,
+            "name": "2222",
+            "provinceId": 440000
+        },
+        {
+            "cityId": 440100,
+            "id": 241,
+            "name": "测试考场一",
+            "provinceId": 440000,
+            "shrinkTagram": [
+                {
+                    "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047652_1439347981183.jpg"
+                },
+                {
+                    "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047636_1439347990058.jpg"
+                }
+            ]
+        }
+    ],
+    "message": "操作成功",
+    "version": "v1.0(latest)"
+}
+}}}
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= cityId =||= 城市id =||=id=||=考场id=||
+||= name =||= 考场名称 =||=provinceId=||=省份id=||
+||= shrinkTagram =||= 图片 =||==||==||
+
+
+
+=== 2.3考场详情页（web页） ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examAreaDetail.xsp?id=241&resVer=21000&platform=iphone&isShare=1 [[BR]]
+学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/getExamAreaById.do?id= [[BR]]
+学车后台线上环境： http://xueche.pcauto.com.cn/appapi/1.0/examArea/getExamAreaById.do?id= [[BR]]
+
+**说明**
+
+> 获取学车后台录入的考场详情。
+
+**缓存时间**
+
+>0
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+>学车后台
+
+**资源包存放路径**
+> http://dev40.pcauto.com.cn:8002/configs.jsp [[BR]]
+> http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_examAreaDetail.json [[BR]]
+> http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_examAreaDetail.json [[BR]]
+ 
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
+||= id =||= 考场id =||= int =||=  =||= 是 =||=  =||
+||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =||
+||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= 版本号由app同事定 =||
+||= isShare =||= 是否分享 =||= int =||=  =||= 是 =||= 1：出分享页；0：出详情页 =||
+
+**返回**
+
+返回HTML页面
+
+注释：
+        /*@_HTML_META_START_
+        {"resVer":"21001","shareUrl":"http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examAreaDetail.xsp?         id=241&resVer=21000&platform=iphone&isShare=1","firstImg":"http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047637_1439348002343_600x450.jpg"}
+        _HTML_META_END_@*/
+
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= resVer =||= 资源包版本号 =||=shareUrl =||=分享url=||
+||= firstImg =||= 第一张图片 =||==||==||
+
+**协议**
+> 图片跳转： pcdrive://big-photo?url= [[BR]]
+----------
+
+== 3.基础知识 ==
+----------
+
+
+=== 3.1基础知识主页 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/basicKnowledge.xsp?id=6483971 [[BR]]
+cms开发环境：http://test1.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]]
+cms线上环境：http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]]
+
+**说明**
+
+> 获取基础知识主页
+
+**缓存时间**
+
+>分钟
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+>cms
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||= id =||= 文章id =||= int=||=  =||= 是 =||
+
+**返回**
+
+{{{#!java
+{
+    "author": "moyingchao",
+    "id": "6483971",
+    "image": "",
+    "image2": "",
+    "pageNum": 7,
+    "preView": "各位都知道，科目二是需要上车实操的，到了考试时，考员有必要提前调节好车内的东西，",
+    "pubDate": 1439369785713,
+    "tagWords": [],
+    "tags": [
+        {
+            "pageNo": 2,
+            "picText": [
+                {
+                    "pic": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
+                    "text": "● 车门开关　　将后视镜调整到自己日常练车的位置，以便自己找到熟悉的感觉。    啊岁的老将阿隆索大家啊三季度刻录机啊斯达康洛吉拉斯简单快乐"
+                }
+            ],
+            "tagName": "车门开关"
+        }
+     ],
+    "title": "科目二基础操作测试用",
+    "url": "http://www.pcauto.com.cn/techtest/648/6483971.html",
+    "wapUrl": "http://m.pcauto.com.cn/x/648/6483971.html"
+
+}
+
+}}}
+
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= author =||= 作者 =||=id=||=文章id=||
+||= pageNum =||= 页数 =||=image=||=图片=||
+||= preView =||= 概述 =||=pubDate=||=发布日期=||
+||= pageNo =||= 页码 =||=pic=||=文章图=||
+||= text =||= 文章内容 =||=tagName=||=标签=||
+||= title =||= 标题 =||=url=||=pc端链接=||
+||= wapUrl =||= wap链接 =||==||==||
+
+----------
+
+== 4.五大项目 ==
+----------
+
+
+=== 4.1五大图集 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/picGroup.xsp?groupId=2506 [[BR]]
+图库开发环境：http://dev31.pconline.com.cn:8042/intf/group_photo.jsp?groupId=2506  [[BR]]
+图库线上环境：http://beauty.pcauto.com.cn/pcautophoto/intf/group_photo.jsp?groupId=2506  [[BR]]
+
+**说明**
+
+> 获取图集内容
+
+**缓存时间**
+
+>无
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+>图库后台
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||==||
+||groupId||图集id||string||""||是||==||
+
+**返回**
+
+{{{#!java
+{
+    "cover": "http://img1.pcauto.com.cn/piclib/200901/21/batch/1/21509/1232502807393xpv6jmzx3s_medium.jpg",
+    "desc": "最牛停车场! 汽车坠楼全过程 更多图片请点击进入：http://bbs.pcauto.com.cn/topic.jsp?tid=1168108来源：PCauto网友 为人民服务",
+    "groupId": 2506,
+    "name": "最牛停车场! 汽车坠楼全过程 ",
+    "number": 1,
+    "photos": [
+        {
+            "desc": "",
+            "name": "",
+            "photoId": 62051,
+            "sourceUrl": "http://img1.pcauto.com.cn/piclib/200901/21/batch/1/21509/1232502807393xpv6jmzx3s.jpg",
+            "thumbUrl": "http://img1.pcauto.com.cn/piclib/200901/21/batch/1/21509/1232502807393xpv6jmzx3s_small.jpg"
+        }
+    ]
+}
+
+}}}
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= cover=||= 封面图=||= desc=||=描述=||
+||= groupId=||=图集id=||= name=||=标题=||
+||= number=||=图片数量=||= photoId=||=图片id=||
+||= sourceUrl=||=图片链接=||= thumbUrl=||=缩略图链接=||
+
+
+
+=== 4.2问答栏目 ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+> mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/questionList.xsp?type=1 [[BR]]
+cms栏目开发环境：http://www.pcauto.com.cn/client/xcbd/1508/intf7491.html [[BR]]
+cms栏目线上环境：http://www.pcauto.com.cn/client/xcbd/1508/intf7491.html [[BR]]
+
+**说明**
+
+> 获取问答栏目列表
+
+**缓存时间**
+
+> 0
+
+**提交方式**
+
+> GET
+
+**是否登录**
+
+> 否
+
+**数据来源**
+
+>cms栏目录入
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||= type =||= 项目类型 1:倒车入库，2：侧方停车，3：斜坡起步，4：曲线行驶，5：直角转弯 =||= int =||=  =||= 必须 =||
+**返回**
+
+{{{#!java
+{
+    "subjectName": "倒车入库",
+    "data": [
+        {
+            "title": "倒车入库车身压线，到底是什么原因？",
+            "url": "pcautobrowser://bbs-topic/8103337",
+            "type": false,
+            "answerCount": 0,
+            "browseCount": 0
+        },
+        {
+            "title": "倒车入库车身压线，到底是什么原因？怎样才能避免这种情况再出现啊？",
+            "url": "pcautobrowser://bbs-topic/8103337",
+            "type": false,
+            "answerCount": 0,
+            "browseCount": 0
+        },
+        {
+            "title": "倒车入库车身与库角30CM怎么判断呢？",
+            "url": "pcautobrowser://bbs-topic/8110447",
+            "type": false,
+            "answerCount": 0,
+            "browseCount": 0
+        }
+    ]
+}
+}}}
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= subjectName =||= 项目名称 =||=title=||=帖子标题=||
+||= url =||= 帖子链接 =||=type=||=（false代表普通问答，true代表精华问答）=||
+||= answerCount =||= 回复数 =||=browseCount=||=浏览数=||
+
+=== 4.3五大必过版 ===
+'''使用1.1考试文章终端页（web页）接口：'''[[BR]]
+[http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.1.0/interface#a1.1考试文章终端页web页]
+
+
+----------
+
+== 5分享 ==
+=== 5.1图集分享（后端线上已有接口，制作增加下载头部） ===
+图库开发环境：[[BR]]
+图库线上环境：http://beauty.pcauto.com.cn/pcautophoto/template/pcauto_bbs/wap/photo.jsp?groupId=10766 [[BR]]
+> 非mrobot接口
+
+**说明**
+
+>分享图集，wap版
+
+**缓存时间**
+
+>0
+
+**提交方式**
+
+>GET
+
+**是否需要登录**
+
+>否
+
+**数据来源**
+
+> 图库后台
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||groupId||图集id||int||无||是||
+||sd||是否显示下载头部||int||无||是（学车宝典app要传1，显示学车宝典下载头）||
+
+**返回**
+
+返回HTML页面
+
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||