wiki:pcauto_4.8.2/interface

Version 30 (modified by lanzhenhua, 10 years ago) (diff)

--

资讯4.8.2接口文档 (已完成接口开发机可测)

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视频栏目列表

(开发已完成,调试请连开发机代理)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.8/columnList.xsp
video开发环境: http://dev32.pcauto.com.cn:9991/interface/pcauto/i_category_list.jsp

video线上环境: http://v.pcauto.com.cn/interface/pcauto/i_category_list.jsp

说明

获取视频栏目列表

缓存时间

提交方式

GET

是否登录

数据来源

video

请求参数

返回

{
    "data": [
        {
            "id": "0",
            "name": "全部视频"
        },
        {
            "id": 92,
            "name": "原创视频"
        },
        {
            "id": 42,
            "name": "新车视频"
        },
        {
            "id": 1,
            "name": "试车视频"
        },
        {
            "id": 3,
            "name": "安全警示"
        },
        {
            "id": 43,
            "name": "个性展示"
        },
        {
            "id": 44,
            "name": "技术视频"
        },
        {
            "id": 32,
            "name": "车展视频"
        },
        {
            "id": 2,
            "name": "广告视频"
        }
    ]
}

返回参数说明

参数名 参数含义 参数名 参数含义
id 栏目名称 name 栏目名称

1.2 获取某个栏目下视频列表

(开发已完成,调试请连开发机代理)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.8/videoList.xsp

video开发环境: http://dev32.pcauto.com.cn:9991/interface/common/video_videoList.jsp
video线上环境: http://v.pcauto.com.cn/interface/common/video_videoList.jsp

说明

获取视频栏目列表

缓存时间

提交方式

GET

是否登录

数据来源

video

请求参数

参数名 参数含义 类型 默认值 是否必须 说明
cid 栏目id int 0 接口数据是某个分类的视频。当采用默认值时,接口数据为最新发布视频倒序
pageNo 页码 int 1
pageSize 分页大小 int 20
viewCount 是否需要评论 boolean false
desc 是否需要视频描述信息 boolean false

返回

{
    "total": 25039,
    "pageNo": 1,
    "data": [
        {
            "id": 46314,
            "pubDate": "2015-12-21",
            "categoryName": "个性展示",
            "duration": "00:17:13",
            "desc": "",
            "image": "http://img.pcauto.com.cn/images/autovideo/autovideo/201512/21/14506783936184410_s2.jpg",
            "url": "http://dev32.pcauto.com.cn:9991/video-46314.html",
            "title": "《四万说车》之奥迪Q7抢鲜体验",
            "bigCover": "http://img.pcauto.com.cn/images/autovideo/autovideo/201512/21/14506783936184410_s5.jpg",
            "isYuanChuang": 0,
            "durationSimple": "17:13",
            "viewCount": 0,
            "type": 9
        },
        {
            "id": 46308,
            "pubDate": "2015-12-20",
            "categoryName": "安全警示",
            "duration": "00:02:44",
            "desc": "",
            "image": "http://img.pcauto.com.cn/images/autovideo/autovideo/201512/20/14506164606938720_s2.jpg",
            "url": "http://dev32.pcauto.com.cn:9991/video-46308.html",
            "title": "货车翻到之际见真情",
            "bigCover": "http://img.pcauto.com.cn/images/autovideo/autovideo/201512/20/14506164606938720_s5.jpg",
            "isYuanChuang": 0,
            "durationSimple": "02:44",
            "viewCount": 0,
            "type": 9
        }
    ],
    "pageSize": 20
}

返回参数说明

参数名 参数含义 参数名 参数含义
total 视频总数 pageNo 当前页数
pageSize 当前页大小 id 视频id
title 视频名称 categoryName 视频所属栏目名称
duration 视频的时长,hh:mm:ss 格式 durationSimple 视频的时长,mm:ss 格式
desc 视频的描述信息 image 120x68尺寸的封面图
bigCover 284x160尺寸的封面图 url 视频的PC播放页链接
isYuanChuang 表示是否含有"原创"标签 viewCount 视频播放数
pubDate 视频上传日期 yyyy-MM-dd 格式 type type为9表示视频类型

1.3 视频详情页

1.4评论接口

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

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/newTopics.xsp?topicId=13285745

cmt开发环境:暂无
cmt线上环境: http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13285745&arch=0&reverse=0

 http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13285745

说明

获取某个话题评论列表

缓存时间

提交方式

GET

是否登录

数据来源

cmt

参数

参数名 参数含义 类型 默认值 是否必须 说明
pageNo 页数 int 1
pageSize 每页条数 int 20
topicId 挂评论的话题id string 应用端需要
articleId文章id string
reverse是否倒序 string

返回

{
    "comments": [
      
        {
            "1": {
                "id": 29245573,
                "userId": 0,
                "name": "四川省成都市网友",
                "floor": 110,
                "time": "2015-09-09 09:22:31",
                "client": 1
            },
            "2": {
                "id": 29245573,
                "userId": 0,
                "name": "四川省成都市网友",
                "floor": 110,
                "time": "2015-09-09 09:22:31",
                "client": 1
            },
           
            "current": 2,
            "support": 2,
            "expand": false
        },
        {
            "1": {
                "id": 28918767,
                "userId": 40609440,
                "name": "蓝天7763",
                "floor": 96,
                "time": "2015-06-18 10:39:09",
                "client": 1
            },
            "current": 0,
            "support": 0,
            "expand": false
        },
        {
            "1": {
                "id": 28916485,
                "userId": 34280943,
                "name": "圈圈的小黑",
                "floor": 95,
                "time": "2015-06-17 17:49:35",
                "client": 1
            },
            "current": 1,
            "support": 1,
            "expand": false
        },
        {
            "1": {
                "id": 28916007,
                "userId": 34796550,
                "name": "宠儿飞飞",
                "floor": 93,
                "time": "2015-06-17 16:23:27",
                "client": 1
            },
            "current": 0,
            "support": 0,
            "expand": false
        }
        
    ],
    "hot-comments": [
       
        {
            "1": {
                "id": 28870318,
                "userId": 29841302,
                "name": "Gold_Agent",
                "floor": 49,
                "time": "2015-06-05 17:27:27",
                "client": 1
            },
            "current": "4",
            "support": 5,
            "expand": false
        }
    ],
    "docUrl": "http://mrobot.pcauto.com.cn/v3/cms/articles/0",
    "pageNo": 1,
    "pageCount": 6
}

返回参数说明

参数名 参数含义

2.找车

2.1预约试驾

(开发已完成,调试请连开发机代理)

mrobot地址: http://mrobot.pcauto.com.cn/v3/price/testdriverv45/?serialId=4313&dealerName=%E5%B9%BF%E4%B8%9C%E4%B8%AD%E5%A5%A5%E5%A5%A5%E8%BF%AA&areaId=1&areaName=%E5%B9%BF%E5%B7%9E&appKey=b5d3828499d0590300000003&chId=app_store&devId=cdef0dde8e82323c2a0df5bad5bce8646971f0f5
开发环境: http://dev40.pcauto.com.cn/v3/price/testdriverv45/?serialId=4313&dealerName=%E5%B9%BF%E4%B8%9C%E4%B8%AD%E5%A5%A5%E5%A5%A5%E8%BF%AA&areaId=1&areaName=%E5%B9%BF%E5%B7%9E&appKey=b5d3828499d0590300000003&chId=app_store&devId=cdef0dde8e82323c2a0df5bad5bce8646971f0f5[[BR]]

说明

预约试驾

缓存时间

提交方式

GET

是否登录

数据来源

请求参数 和原版本保持一致

返回 HTML

2.2车型页

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.8/models.xsp?mid=41610&areaId=1&hasDealers=1

说明

此接口只通过判断后端接口返回状态(state)字段是否为即将上市;如果为即将上市修改相关协议以及文案,询底价文案改为预约试驾,其他一切不变

缓存时间

提交方式

GET

是否登录

参数 返回
返回HTML

返回参数说明
(车型页—“本地最低价”下面的预约试驾,增加协议)
serialId 且有modelId 及名称
pcautobrowser://pcauto-appoint4driving/?serialId=1&modelId=1
(车型综述页—(将上市)经销商列表的预约试驾,增加协议)
车系、车型、经销商、经销商名称
pcautobrowser://pcauto-appoint4driving/?serialId=1&modelId=1&dealerId=30829&dealerName=广州璟众

参数名 参数含义
serialId车系id
modelId 车型id
dealerId经销商id
dealerName 经销商名称

3.论坛

3.1车友社区首页

(开发已完成,调试请连开发机代理)

mrobot地址: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/communityHomePage.xsp?pageNo=1
开发环境: http://dev40.pcauto.com.cn/xsp/s/auto/info/xueChe/communityHomePage.xsp?pageNo=1[[BR]] 线上环境: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/communityHomePage.xsp?pageNo=1

说明

车友社区首页

缓存时间

提交方式

GET

是否登录

数据来源

请求参数

参数名 类型 必须 说明
pageNoString页码
inreviewStringIOS APP送审用,1为送审期间

返回

{
    "activelist": [
        {
            "title": "#一个字总结你的2015年#",
            "url": "http://club.pcauto.com.cn/topic/4712.html",
            "appUrl": "pcautoclub://club-talk/4712",
            "img": "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp_v2/1512/cbc.jpg",
            "dynaInfoId": "",
            "createBy": ""
        }
    ],
    "discover": [
        {
            "appUrl": "pcautoclub://club-talk/4353",
            "title": " #国产品牌的希望#"
        },
        {
            "appUrl": "pcautoclub://club-talk/4381",
            "title": "#这次油价不降啦#"
        },
        {
            "appUrl": "pcautoclub://club-talk/4352",
            "title": "#京6排放标准#"
        },
        {
            "appUrl": "http://www.pcauto.com.cn/forum/club/goddess/",
            "title": "更多精彩话题"
        }
    ],
    "pics": [
        {
            "img": "http://img0.pcauto.com.cn/pcauto/forum/club/app/000088206/1512/fhtf.jpg",
            "link": "pcautoclub://bbs-topic/9631395"
        },
        {
            "img": "http://img0.pcauto.com.cn/pcauto/forum/club/app/000088206/1512/fhf_1.jpg",
            "link": "pcautoclub://bbs-topic/9460170"
        },
        {
            "img": "http://img0.pcauto.com.cn/pcauto/forum/club/app/000088206/1512/rtui_1.jpg",
            "link": "pcautoclub://bbs-topics/22265"
        }
    ],
    "txts": [
        {
            "txt": "说说那些影响了一代人的车坛老炮儿 ",
            "link": "pcautoclub://club-talk/4721"
        }
    ],
    "data": [
        {
            "title": "【提车】分分钟变极光 我的伙伴金色X7",
            "url": "http://bbs.pcauto.com.cn/topic-9463208.html",
            "pic": "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/wapshequ/wapshequhot/1512/2_5.jpg",
            "summary": "车是我的朋友,兄弟,我从小就很喜欢车,小时候我就想拥有一辆属于自己的车。记得我父亲在我五岁生日的时候给我买了一个玩具车,那时候真是把我高兴坏了",
            "userId": "42458858",
            "appUrl": "pcautoclub://bbs-t32pic1",
            "topicid": "",
            "userfaceUrl": "http://i6.3conline.com/images/upload/upc/face/42/45/88/58/42458858_100x100"
        }
    ],
    "total": "200",
    "pageSize": "10",
    "pageNo": "1",
    "totalPage": 20
}

4.其他