wiki:pcauto_drive_2.1.0/interface

Version 38 (modified by dengyurong, 11 years ago) (diff)

--

Table of Contents

  1. 1.考试内容
    1. 1.1考试文章终端页（web页）
  2. 2.考场
    1. 2.1考场城市列表
    2. 2.2考场列表
    3. 2.3考场详情页（web页）
  3. 3.基础知识
    1. 3.1基础知识主页
  4. 4.五大项目
    1. 4.1五大图集
    2. 4.2问答栏目
    3. 4.3五大必过版
  5. 5分享
    1. 5.1图集分享（后端线上已有接口，制作增加下载头部）

学车2.1.0接口文档

mrobot代理环境说明：

192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）
ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。
制作地址：
应用后端接口trac：

1.考试内容

1.1考试文章终端页（web页）

(mrobot已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/articles.xsp?id=6483971&resVer=21000&platform=iphone&type=1

cms开发环境： http://dev5.pcauto.com.cn:8082/interface/pcauto/mrobot_articles_v3.jsp?id=6483971
cms线上环境： http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp?id=6483971

说明

获取cms录入的考试文章

缓存时间

分钟

提交方式

GET

是否登录

否

数据来源

cms

资源包存放路径

 http://dev40.pcauto.com.cn:8002/configs.jsp
 http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_articles.json
 http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_articles.json

参数

参数名 参数含义 类型 默认值 是否必须 说明
pageNo页数int 1 否
allText是否出全文int 0 否 为1时返回全文内容
id 文章ID string 是 应用端需要
platform 设备类型 string 是 iphone,android
resVer 资源包版本 string 是 版本号由app同事配置
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 第一张图片

协议

图片跳转： pcdrive://big-photo?url= 小游戏： pcdrive://game

2.考场

2.1考场城市列表

(mrobot已完成，请连开发机进行测试)

mrobot地址：  http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamArea.do

学车后台开发环境： http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamArea.do
学车后台线上环境：

说明

获取已知考场的城市列表

缓存时间

0

提交方式

GET

是否登录

否

数据来源

学车后台

参数

参数名 参数含义 类型 默认值 是否必须 说明

返回 

{
    "code": 0,
    "data": [
        {
            "cityId": 440100,
            "cityName": "广东"
        }
    ],
    "message": "操作成功",
    "version": "v1.0(latest)"
}

返回参数说明

参数名 参数含义 参数名参数含意
cityId 城市id cityName城市名称

2.2考场列表

(mrobot已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100

学车后台开发环境： http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100
学车后台线上环境：

说明

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

缓存时间

0

提交方式

GET

是否登录

否

数据来源

学车后台

参数

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

返回 

{
    "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已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examAreaDetail.xsp?id=241&resVer=21000&platform=iphone&isShare=1

学车后台开发环境： http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/getExamAreaById.do?id=
学车后台线上环境：

说明

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

缓存时间

0

提交方式

GET

是否登录

否

数据来源

学车后台

资源包存放路径

 http://dev40.pcauto.com.cn:8002/configs.jsp
 http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_examAreaDetail.json
 http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_examAreaDetail.json

参数

参数名 参数含义 类型 默认值 是否必须 说明
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 第一张图片

3.基础知识

3.1基础知识主页

(mrobot已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/basicKnowledge.xsp?id=6483971

cms开发环境： http://dev5.pcauto.com.cn:8082/interface/pcauto/mrobot_articles_v5.jsp?id=6483971
cms线上环境：

说明

获取基础知识主页

缓存时间

分钟

提交方式

GET

是否登录

否

数据来源

cms

参数

参数名 参数含义 类型 默认值 是否必须
id 文章id int 是

返回 

{
    "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 标题 urlpc端链接
wapUrl wap链接

4.五大项目

4.1五大图集

(mrobot已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/picGroup.xsp?groupId=2506

图库开发环境： http://dev31.pconline.com.cn:8042/intf/group_photo.jsp?groupId=2506
图库线上环境：

说明

获取图集内容

缓存时间

无

提交方式

GET

是否登录

否

数据来源

图库后台

参数

参数名 参数含义 类型 默认值 是否必须
groupId图集idstring""是

返回 

{
    "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已完成，请连开发机进行测试)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/questionList.xsp?type=1

cms栏目开发环境： http://www.pcauto.com.cn/client/xcbd/1508/intf7491.html
cms栏目线上环境： http://www.pcauto.com.cn/client/xcbd/1508/intf7491.html

说明

获取问答栏目列表

缓存时间

0

提交方式

GET

是否登录

否

数据来源

cms栏目录入

参数

参数名 参数含义 类型 默认值 是否必须
type 项目类型 1:倒车入库，2：侧方停车，3：斜坡起步，4：曲线行驶，5：直角转弯 int 必须

返回 

{
    "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页）接口：
 http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.1.0/interface#a1.1考试文章终端页web页

5分享

5.1图集分享（后端线上已有接口，制作增加下载头部）

图库开发环境：
图库线上环境： http://beauty.pcauto.com.cn/pcautophoto/template/pcauto_bbs/wap/photo.jsp?groupId=10766

非mrobot接口

说明

分享图集，wap版

缓存时间

0

提交方式

GET

是否需要登录

否

数据来源

图库后台

参数

参数名 参数含义 类型 默认值 是否必须
groupId图集idint无是
sd是否显示下载头部int无是（学车宝典app要传1，显示学车宝典下载头）

返回

返回HTML页面

返回参数说明

参数名 参数含义 参数名参数含意