[[TOC]]

= 学车2.1.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考试文章终端页（web页） ===
'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/articles.xsp?id=6502326&resVer=21000&platform=iphone&type=1 [[BR]]
cms开发环境：http://dev5.pcauto.com.cn:8082/interface/pcauto/mrobot_articles_v3.jsp?id=5000141 [[BR]]
cms线上环境：http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp?id=6849687 [[BR]]

**说明**

> 获取cms录入的考试文章[[BR]]

**缓存时间**

>分钟

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>cms

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||pageNo||页数||int||=  =||= 否 =||= 为1时返回主页的内容 =||
||pageSize||页面大小||int||=  =||= 否 =||=  =||
||= id =||=文章ID =||= string =||=  =||= 是 =||= 应用端需要 =||
||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =||
||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= resVer=21001为第一版 =||
||= type =||=页面类型 =||= string =||=  =||= 是 =||= 1：文章终端页，2：倒车入库，3：必过版（除倒车入库） =||
**返回**

返回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 =||= 第一张图片 =||==||==||

----------

== 2.考场 ==
----------


=== 2.1考场城市列表 ===
'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
>mrobot地址： http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamArea.do [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamArea.do [[BR]]
学车后台线上环境：[[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/dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
学车后台线上环境：[[BR]]

**说明**

> 获取某个城市下的考场列表

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= cityId =||= 城市id =||= int =||= 无 =||= 是 =||= cityId和provinceId必填其一 =||
||= provinceId =||= 省份id =||= int =||= 无 =||= 是 =||= cityId和provinceId必填其一  =||

**返回**

{{{#!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]]
学车后台线上环境： [[BR]]

**说明**

> 获取学车后台录入的考场详情。

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= id =||= 考场id =||= int =||=  =||= 是 =||=  =||
||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =||
||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= resVer=21001为第一版 =||
||= 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 =||= 第一张图片 =||==||==||
----------

== 3.基础知识 ==
----------


=== 3.1基础知识主页 ===
'''(mrobot已完成，请连开发机进行测试)'''[[BR]]
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/basicKnowledge.xsp?id=6483971 [[BR]]
cms开发环境：http://dev5.pcauto.com.cn:8082/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]]
cms线上环境：[[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/x/dev31.pconline.com.cn:8042/intf/group_photo.jsp?groupId=2506 [[BR]]
图库开发环境：http://dev31.pconline.com.cn:8042/intf/group_photo.jsp?groupId=2506  [[BR]]
图库线上环境：[[BR]]

**说明**

> 获取图集内容

**缓存时间**

>无

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>图库后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||==||
||groupId||图集id||string||""||是||==||

**返回**

{{{#!java
{
    "cover": "http://img1.pcauto.com.cn/piclib/200901/21/batch/1/21509/1232502807393xpv6jmzx3s_medium.jpg",
    "desc": "最牛停车场! 汽车坠楼全过程 \r\n更多图片请点击进入：http://bbs.pcauto.com.cn/topic.jsp?tid=1168108\r\n来源：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页面

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||