wiki:pcauto_4.7.4/interface

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

--

Table of Contents

  1. 1.互动
    1. 1.1评论接口
  2. 2.资讯
    1. 2.1栏目接口
  3. 3.苹果审核
    1. 3.1服务条款接口
    2. 3.2举报页面
    3. 3.3提交举报接口
    4. 3.4帖子页接口增加参数说明

汽车资讯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

说明

帖子提交举报接口

缓存时间

无

提交方式

POST

是否登录

是

数据来源

论坛

参数

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

返回 

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

返回参数说明

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

3.4帖子页接口增加参数说明

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

bbs线上环境： http://bbs.pcauto.com.cn/appapi/1/post/getList.do?topicId=8610123&pageNo=1&pageSize=19&authorId=0&topicTemplate=4.5.0&app=pcautobrowser&picRule=2&size=18&inreview=1[[BR]]

说明

此接口只增加一个inreview参数；以及举报按钮增加一个点击协议，其他一切不变

缓存时间

无

提交方式

GET

是否登录

否

数据来源

论坛

参数

只增加一个inreview请求参数，其他请参照客户端旧逻辑。

参数名 参数含义 类型 默认值 是否必须 说明
inreview app是否审核中 int 0 是 1表示审核中（该值与审核阶段是否出现广告读取同样的配置值）

返回
返回HTML

返回参数说明
此版本增加一个举报按钮点击协议返回：pcautobrowser://user-report/?topicId=8610123&postId=84686257

参数名 参数含义
topicId 帖子id
postId 楼层id