Context Navigation

← Previous Change
Wiki History
Next Change →

Changes between Initial Version and Version 1 of pcauto_4.7.4/interface

Timestamp:: 09/08/2015 05:04:41 PM (11 years ago)
Author:: liguokai
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

pcauto_4.7.4/interface

                       v1
+[[TOC]]
+= 学车2.1.0接口文档 =
+>mrobot代理环境说明：
+.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]]
+.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]]
+     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]]
+     制作地址： [[BR]]
+     应用后端接口trac：
+== 1.考试内容 ==
+----------
+=== 1.1考试文章终端页（web页） ===
+'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
+>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/articles.xsp?id=6483971&resVer=21000&platform=iphone&type=1 [[BR]]
+cms开发环境：http://test1.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v3.jsp?id=6483971 [[BR]]
+cms线上环境：http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp?id=6483971 [[BR]]
+**说明**
+> 获取cms录入的考试文章[[BR]]
+**缓存时间**
+>分钟
+**提交方式**
+> GET
+**是否登录**
+> 否
+**数据来源**
+> cms
+**资源包存放路径**
+> http://dev40.pcauto.com.cn:8002/configs.jsp [[BR]]
+> http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_articles.json [[BR]]
+> http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_articles.json [[BR]]
+**参数**
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
+||= pageNo =||= 页数 =||int||= 1 =||= 否 =||=  =||
+||= allText =||= 是否出全文 =||int||= 0 =||= 否 =||= 为1时返回全文内容 =||
+||= id =||=文章ID =||= string =||=  =||= 是 =||= 应用端需要 =||
+||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =||
+||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= 版本号由app同事配置 =||
+||= type =||=页面类型 =||= string =||=  =||= 是 =||= 1：文章终端页，2：倒车入库，3：必过版（除倒车入库） =||
+||= isTarget =||= 跳转难点攻克 =||int||=  =||= 否 =||= 为1时跳转到难点攻克 =||
+**返回**
+返回HTML页面
+注释：
+        /*@_HTML_META_START_
+        {"resVer":"21001","shareUrl":"","firstImg":"http://img0.pcauto.com.cn/pcauto/1508/06/6502326_4_thumb.jpg"}
+        _HTML_META_END_@*/
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
+||= resVer =||= 资源包版本号 =||=shareUrl =||=分享url=||
+||= firstImg =||= 第一张图片 =||==||==||
+**协议**
+> 图片跳转： pcdrive://big-photo?url= [[BR]]
+> 小游戏： pcdrive://game
+----------
+== 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/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页面
+**返回参数说明**
+||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||