wiki:pcauto_4.7.4/interface

Version 11 (modified by liguokai, 11 years ago) (diff)

--

汽车资讯4.7.4接口文档

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

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

返回

返回参数说明

参数名 参数含义

2.资讯


2.1栏目接口

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

mrobot地址: http://mrobot.pcauto.com.cn/v2/cms/channels/{id}?pageNo=1&pageSize=20&v=4.0.0

例如: http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0
cmt开发环境: http://test2.pcauto.com.cn:8002/app/json/
cmt线上环境: http://www.pcauto.com.cn/app/21json

说明

此接口为资讯客户端15个栏目集合,涉及参数以及各种情景太多,实在不能穷举,以下只列出新增内容。
对于客户端逻辑,此版本只需要新增一个pageNo的返回值处理,当接口返回JSONObject为文章类型,并且返回pageNo时,打开文章页且跳到对应的pageNo页

缓存时间

首页列表5分钟,其余栏目30分钟

提交方式

GET

是否登录

数据来源

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

参数

请参照客户端旧逻辑,此版本对传入参数无修改。
返回

{
    "data": [
        {
            "articleType": "y",
            "channelId": 1,
            "channelName": "头条",
            "count": 0,
            "downs": 0,
            "id": "6929470",
            "image": "http://img0.pcauto.com.cn/pcauto/1509/14/g_6959543_1442223329657_240x160.jpg",
            "pageNo": 3,
            "pubDate": "2013-01-01",
            "title": "测试旧文章",
            "type": 1,
            "ups": 0,
            "url": "http://www.pcauto.com.cn/teach/692/6929470_2.html"
        }
    ],
    "focus": [ 
        {
            "articleType": "n",
            "id": "1623455",
            "image": "http://img0.pcauto.com.cn/pcauto/app/daogou/1108/201108311.jpg",
            "pubDate": "2011-08-31",
            "title": "哈弗H6挑战比亚迪S6/瑞虎/海马骑士",
            "topicUrl": "http://www.pcauto.com.cn/teach/1108/1622411.html",
            "url": "http://www.pcauto.com.cn/app/daogou/1108/1623455.html"
        }
    ],
    "pageNo": 1,
    "pageSize": 1,
    "topData": [
        {
            "cc-uri": "http://count.imofan.com/count?url=http://www.pcauto.com.cn/nation/669/6690671.html&ad=132",
            "channelId": 0,
            "channelName": "",
            "count": 0,
            "downs": 0,
            "id": "161",
            "image": "http://img0.pcauto.com.cn/pcauto/1503/15/6055040_567.jpg",
            "isExtend": "0",
            "preView": "央视3·15晚会正在直播 消费在阳光下",
            "pubDate": "2015-03-15",
            "seq": 1,
            "title": "央视3·15晚会直播回顾 消费在阳光下",
            "to-uri": "pcautobrowser://information-article/161?template=live",
            "type": 4,
            "updateAt": 1436284800000,
            "ups": 0
        }
    ],
    "topFocus": [
        {
            "image": "http://www1.pcauto.com.cn/test/qwegf3wrefgvazv.jpg",
            "seq": 1,
            "title": "驾名爵锐腾1.5T四驱豪华版",
            "to-uri": "http://m.pcauto.com.cn/x/guangzhou/?type=zt&FromApp=1&browser=commonwebview&v=4.5.0",
            "updateAt": 1437408000000
        }
    ],
    "total": 150
}

返回参数说明
在data与focus数组内的每一个JSONOject增加以下参数返回
注意:pageNo是此版本客户端要新增的处理,客户端同事特别注意。

参数名 参数含义
type 1文章,2帖子,3图集,4直播,5专题,6活动,0其他
to-uri 论坛版块pcautobrowser://bbs-topics/,图库图片pcautobrowser://album-photo/,车系界面pcautobrowser://serial/,车型界面pcautobrowser://model/
pageNo 当type等于1(文章)时,假如有返回pageNo,要跳转到文章相应的pageNo页
articleType 值为y表示旧文章

3.苹果审核


3.1服务条款接口

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

mrobot地址: http://mrobot.pcauto.com.cn/v3/cms/protocol

后端接口:无

说明

太平洋网络服务条款

缓存时间

提交方式

GET

是否登录

数据来源

mrobot

参数

返回 HTML

返回参数说明

参数名 参数含义

3.2举报页面

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

mrobot地址: http://mrobot.pcauto.com.cn/v2/bbs/report?topicId=8660338&postId=85629947&isBBS=1

后端接口:无

说明

用户点击举报按钮后跳转到该页面,填写举报内容

缓存时间

提交方式

GET

是否登录

数据来源

mrobot

参数

参数名 参数含义 类型 默认值 是否必须 说明
topicId 帖子id string 0
postId 楼层id string 0
isBBS是否从帖子页跳转过来 string 0 值为1表示来源为帖子,其他值表示来源文章评论

返回 HTML

返回参数说明
返回协议:
pcaction://submit-report?topicId=23542523&postId=235256356&reason=恶意灌水 ------ 正常提交举报
pcaction://article-report ------ 来自于文章评论的举报,不需发请求,直接提示举报成功
pcaction://no-reason ------ 提示用户需要选择或输入举报内容

参数名 参数含义 参数名 参数含义 参数名 参数含义
topicId 帖子id postId 楼层id reason 举报原因

3.3提交举报接口

非mrobot接口

bbs线上环境: http://bbs.pcauto.com.cn/action/post/reportAbuse.do?tid=8660338&pid=85629947&reason=%E5%B8%96%E5%AD%90%E5%86%99%E7%9A%84%E5%A4%AA%E5%A5%BD%E4%BA%86%EF%BC%8C%E6%88%91%E5%AB%89%E5%A6%92%E3%80%82

说明

帖子提交举报接口

缓存时间

提交方式

POST

是否登录

数据来源

论坛

参数

参数名 参数含义 类型 默认值 是否必须 说明
tid 帖子id string 0
pid 楼层id string 0
reason 举报原因 string 0

返回

{
    "desc": "您没有权限举报帖子",
    "status": -1
}

返回参数说明

参数名 参数含义
desc 提交结果描述
status 提交结果状态:0成功;-1失败