wiki:pcauto_4.10.0/interface

Version 26 (modified by dengyurong, 10 years ago) (diff)

--

Table of Contents

  1. 1.视频
    1. 1.1 视频列表
    2. 1.2 车系视频列表
    3. 1.3 视频详情页
    4. 1.4 首页列表
  2. 2.论坛
    1. 2.1 帖子详情页
  3. 3.资讯
    1. 3.1 直播详情页
    2. 3.2 文章页
  4. 4.车型库
    1. 4.1 新车栏目最近新车
    2. 4.1 车系综述页

资讯4.10.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 视频列表

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

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

说明

此接口为已有接口，详见： http://trac.pc.com.cn/iphone/wiki/pcauto_4.8.2/interface#a1.2获取某个栏目下视频列表 新增了视频类型和视频id两个字段

返回参数说明

参数名 参数含义
mediaId 视频id
mediaType 视频类型,0:乐视 1：自己公司 2：优酷
cover 640*360的封面图

1.2 车系视频列表

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

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.8/serialVideoList.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

请求参数

参数名 参数含义 类型 默认值 是否必须 说明
sid 车系id 是
pageNo 页码 int 1 否
pageSize 分页大小 int 20 否
viewCount 是否需要播放数 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,
            "mediaType":2,
            "mediaId":"XMTQxNzQ1NDk4OA==",
            "timestamp":1451405833000
        },
        {
            "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,
            "mediaType":2,
            "mediaId":"XMTQxNzQ1NDk4OA==",
            "timestamp":1451405833000
        }
    ],
    "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表示视频类型
mediaId 视频id mediaType 视频类型,0:乐视 1：自己公司 2：优酷
timestamp 时间戳 cover 640*360的封面图

1.3 视频详情页

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

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

video开发环境： http://dev32.pcauto.com.cn:9991/interface/pcauto/video_video.jsp?vid=
video线上环境： http://v.pcauto.com.cn/interface/pcauto/video_video.jsp?vid=

说明

视频详情页

缓存时间

无

提交方式

GET

是否登录

否

数据来源

video

参数

参数名 参数含义 类型 默认值 是否必须 说明
vid 视频文章id int 否
showVideo 是否显示播放器 int 1 否 1：显示播放器，0：不显示播放器
inreview 是否审核中 int 否 1：审核中
night 是否夜间模式 int 否 不传这个参数为非夜间模式

返回 HTML页面

协议 评论：pcautobrowser://reply?topicId=&topicUri=&name=&replyFloor=
个人中心：pcautobrowser://m?userId=
举报： pcautobrowser://report
注释：/*@_HTML_META_START_ {"shareUrl":" http://v.pcauto.com.cn/video-46283.html","image":"http://img.pcauto.com.cn/images/autovideo/autovideo/201512/18/14504285843224700.jpg","title":"年轻实力派 试驾东风日产全新逍客2.0L","desc":"作为一台城市中使用的SUV车型，全新逍客非常好地扮演着这个角色，而且它的安全配置方面很丰富，你很难在同级别同价位当中，找到一个安全配置那么丰富的车型，所以我觉得，这台全新逍客会更加适合年轻消费者。" } _HTML_META_END_@*/
分享按钮：pcautobrowser://share
相关视频：pcautobrowser://videoDetail?vid=&night=1&inreview=&mediaType=&mediaId=&showVideo=

相关视频协议参数

参数名 参数含义
vid 视频文章id
night 是否夜间模式(1：是，0：否)
inreview 是否审核中
mediaId 视频id
mediaType 视频类型,0:乐视 1：自己公司 2：优酷
showVideo 是否显示视频播放器

1.4 首页列表

(未开发，请不要对号入座)

mrobot地址： http://mrobot.pcauto.com.cn/v2/cms/channel1?pageNo=1&pageSize=20

cms开发、测试环境： http://test2.pcauto.com.cn:8002/app/21json/
说明

此版本增加预告模块数组，增加自媒体公众号名称，增加视频源与视频类型

缓存时间

5分钟。

提交方式

GET

是否登录

否

数据来源

cms、快搜、cmt、直播后台等等

参数

参数名 参数含义 类型 默认值 是否必须 说明
inreview 是否苹果审核中 int 0 否 审核阶段不出广告
pageNo页码 int 1 否
pageSize每页条数 int 200 否

返回 

{
    "data": [
        {
            "articleType": "n",
            "channelId": 17,
            "channelName": "自媒体",
            "classfy": "",
            "count": 0,
            "downs": 0,
            "id": "6965263",
            "image": "http://img0.pcauto.com.cn/pcauto/1509/05/g_7003547_1441467287866_240x160.jpg",
            "media": "公众号C",
            "pubDate": "2016-03-21",
            "title": "自媒体测试CCCC",
            "type": 1,
            "ups": 0,
            "mtime":1458546249000,
            "url": "/client/696/6965263.html",
            "voteId": ""
        },
        {
            "articleType": "y",
            "channelId": 13,
            "channelName": "头条",
            "classfy": "视频",
            "count": 0,
            "downs": 0,
            "id": "46409",
            "image": "http://img0.pcauto.com.cn/pcauto/1509/05/g_7003547_1441467287866_240x160.jpg",
            "mediaType": 2,
            "pubDate": "2016-03-18",
            "title": "优酷视频测试",
            "type": 9,
            "ups": 0,
            "mtime":1458546249000,
            "url": "http://v.pcauto.com.cn/video-46409.html",
            "cover": "http://img.pconline.com.cn/images/upload/upc/tx/madmin/1603/18/c0/19349366_1458286041071.jpg",
            "mediaId": "XMTQzMTkyOTkyOA==",
            "viewCount": 0,
            "voteId": ""
        },
        {
            "articleType": "y",
            "channelId": 13,
            "channelName": "头条",
            "classfy": "视频",
            "count": 0,
            "downs": 0,
            "id": "46481",
            "image": "http://img0.pcauto.com.cn/pcauto/1603/17/g__1458186048036_240x160.jpg",
            "mediaType": 1,
            "pubDate": "2016-03-18",
            "title": "自家视频测试",
            "type": 9,
            "ups": 0,
            "mtime":1458546249000,
            "url": "http://v.pcauto.com.cn/video-46481.html",
            "cover": "自家视频测试",
            "mediaId": "http://auto.pcvideo.com.cn/pcauto/vpcauto/2016/01/07/1452155060107-vpcauto-75886-1.mp4",
            "viewCount": 0,
            "voteId": ""
        }
    ],
    "focus": [
    ],
    "foreshow": [
        {
            "des": "聊聊用车的那些事",
            "image": "http://img0.pcauto.com.cn/pcauto/3g/wap2013/000090846/1603/yugao.png",
            "isShow": "true",
            "tagColor": "#dd3939",
            "tagTitle": "直播中",
            "title": "用车下午茶",
            "type":0,
            "url":"http://k.pcauto.com.cn/online/eo/a311.html"
        }
    ],
    "pageNo": 1,
    "pageSize": 3,
    "topData": [
    ],
    "topFocus": [],
    "total": 147
}

返回参数说明
增加foreshow数组，增加视频源，自媒体公众号等

参数名 参数含义
foreshow 预告模块数组
foreshow.des 描述
foreshow.image 图片
foreshow.isShow 是否显示
foreshow.tagColor 标签颜色
foreshow.tagTitle 标签标题
foreshow.title 标题
foreshow.type 1文章，2帖子，3图集，4直播，5专题，6活动，7那种用户4.5版本提完需求自己就忘掉了是什么的列表专题，9视频，10投票，11gif，12广告，0其他
foreshow.url 跳转链接（跟data数组一样，先判断type，再拼文章id、帖子id...之类的终端页）
foreshow.id 文章、帖子...等id
media 自媒体公众号名称
cover 视频终端页封面图
mediaId 视频源
mediaType 视频类型（优酷、乐视、自家）
mtime 发布时间毫秒值

2.论坛

2.1 帖子详情页

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

mrobot地址： http://mrobot.pcauto.com.cn/v2/bbs/topics/8760024?pageNo=1&pageSize=19&authorId=0&topicTemplate=4.5.0&app=pcautobrowser&picRule=2&size=18

说明

已有接口，新增了最佳回复


3.资讯

3.1 直播详情页

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

mrobot地址： http://mrobot.pcauto.com.cn/v3/zbDetail?broadcastId=62&order=0&pageNo=1

说明

已有接口，新增置顶内容

3.2 文章页

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

mrobot地址： http://mrobot.pcauto.com.cn/v3/cms/articlesv410/{articleId}

cms开发环境： http://test2.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v3.jsp
cms线上环境： http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp

说明

文章页

缓存时间

1小时

提交方式

GET

是否登录

否

数据来源

cms

参数

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

返回 HTML页面

新增协议 评论：pcautobrowser://reply?topicId=&topicUri=&name=&replyFloor=
分享微信：pcautobrowser://share/{articleId}?target=wechat
分享朋友圈：pcautobrowser://share/{articleId}?target=moments
分享qq：pcautobrowser://share/{articleId}?target=QQ
分享qzone：pcautobrowser://share/{articleId}?target=Qzone
点击查看更多评论：pcautobrowser://comment/${cmtTopicId}

4.车型库

4.1 新车栏目最近新车

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

mrobot地址： http://mrobot.pcauto.com.cn/v3/price/upcomingSerials_v2

车型库开发环境： http://dev49.pcauto.com.cn:8002/api/v1/interface/internal/iphone/atom/price/new_cars?size=2
车型库线上环境： http://price.pcauto.com.cn/api/v1/interface/internal/iphone/atom/price/new_cars?size=2

说明

获取新车栏目最近两款新车

缓存时间

15分钟

提交方式

GET

是否登录

否

数据来源

车型库

请求参数 无

返回 

[
    {
        "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_11980.jpg",
        "mtime": "1458489600000",
        "serialId": "11980",
        "serialName": "传祺GS4",
        "tag": "改款"
    },
    {
        "image": "http://www1.pcauto.com.cn/piclib/20000/nEO_IMG_13339.jpg",
        "mtime": "1458489600000",
        "serialId": "13339",
        "serialName": "宝马2系运动旅行车",
        "tag": "新车"
    }
]

返回参数说明

参数名 参数含义
image 图片
mtime 时间毫秒值
serialId 车系id
serialName 车系名称
tag 标签

4.1 车系综述页

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.7/serials.xsp?serialId=89&regionId=1&hasDealers=1&fmt=json

此版本只增加一个参数返回：attention，表示车型关注度，百分比，eg：
http://img.pconline.com.cn/images/upload/upc/tx/madmin/1603/21/c0/19439660_1458534383180.bmp