pcauto_club_dev_4.6.0: 4.6.api.from.gathered.201512011155.2.txt

File 4.6.api.from.gathered.201512011155.2.txt, 14.7 KB (added by linyuzhong, 10 years ago)

车友会4.6.0接口需求

Line 
1默认返回格式json
2
3旧接口修改：
4==================================================
5
61.1.1.http://mrobot.pcauto.com.cn/xsp/s/club/v4.2/forumsHomePage.xsp?pageNo=1&forumId=21085&pageSize=15&userId=37962411&orderby=postat
7应用接口：
81.1.5 获取主题对应的动态ID,点赞数等 /appapi/1.0/forum/getDynaByTopicId.do
91.2.3 车友圈主题列表 /appapi/1/forum/listTopicsByForumId.do
101.2.4 车友圈置顶主题列表 /appapi/1/forum/getForumTop.do [GET]
111.2.2 车友圈基本信息 接口/appapi/1/forum/findForumsByIds.do [GET]
121.1.4 判断用户是否绑定某车友圈 /appapi/1.0/forum/isBound.do [GET]
13
14    新增字段：
15        分享数：加在原接口返回值的topicList中的每个帖子数据里
16    例：{
17        ...,
18        topicList: [
19            {
20                ...,
21                shareCount:100,            //新增分享数量
22                ...,
23            }, ...
24        ],
25        ...,
26    }
27。。。。。。。。。。
28
291.2.1.http://mrobot.pcauto.com.cn/club/bbs/forumTopics?topicId=9210458&userId=9645401&pageNo=1&pageSize=19&authorId=0&topicTemplate=3.1.0&app=pcautoclub&size=18&picRule=2
30    新增参数:
31        是否定位到评论模块
32。。。。。。。。。。
33
34
35新增接口：
36==================================================
37
382.1.1.车头条详情(列表)页
39是否分页：是
40是否缓存：否
41是否登录：否
42参考接口:
43        http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0
44参数:{
45    pageNo:1,                                               // 页码
46    pageSize:20                                             // 每页条数(默认20)
47}
48返回{
49    code:0,                                                 // 状态码，非0表示请求失败
50    message:"操作成功",                                     // 提示信息
51    pageNo:1,                                               // 页码
52    pageCount:12,                                           // 分页数量
53    focusList:[                                             // -- 焦点图，最大限制是多少？
54        {
55            articleId:43323,                                // 文章id
56            title:"实拍体验奔驰AMG C63性格分裂再进",        // 标题
57            imageUrl:"http://pconline.club.ccxcxc.jpg",     // 图片url
58            //以下3字段非必需
59            replyCount:23,                                  // 回复数
60            createTime:1435454,                             // 创建时间
61            flag:"新车",                                    // 新车，自媒体，导购，评测，用车，游记，文化，行业，赛事，技术
62        }, ...
63    ],
64
65    datasList:[                                             // -- 列表项
66        {
67            "articleType": "n",
68            "channelId": 2,
69            "channelName": "新车",
70            "count": 5,
71            "downs": 0,
72            "id": "7428665",
73            "image": "http://img0.pcauto.com.cn/pcauto/1511/27/g_7409963_1448555317399_240x160.jpg",
74            "pubDate": "2015-12-01",
75            "title": "红标哈弗H1上市 7款车型5.49-7.09万元",
76            "type": 1,
77            "ups": 0,
78            "url": "http://www.pcauto.com.cn/nation/742/7428665.html"
79        }, ...
80    ]
81}
82。。。。。。。。。。
83
842.1.2.文章详情页(wap)
85是否分页：是
86是否缓存：否
87是否登录：否
88接口:server/xxx/xxx/xxx
89参数:{
90    articleId:43223         // 文章id
91    pageNo:1                // 页码
92}
93返回:{
94    code:0,                 // 状态码
95    message:"操作成功",     // 提示信息
96    replyCount:123,         // 回复数
97    pageCount:23,           // 分页数量
98    pagesList:[             // 分页列表
99        {
100            pageNo:2,                       // 页码
101            pageTitle:"十月轿车销量排行",   // 页标题
102        }, ...
103    ]
104}
105相关协议:
106    询底价　    pcautoclub://auto-ask-price/423323      // 423323:车系id
107    个人中心    pcautoclub://user-center/43242          // 43242:用户id
108    文章评论    pcautoclub://article-comments/
109    参看大图    pcaction://big-photo?data=
110。。。。。。。。。。
111
1122.1.3.获取最新评论楼层数
113是否分页：否
114是否缓存：否
115是否登录：否
116参考接口:
117    文档：http://trac.pc.com.cn/iphone/wiki/pcauto_4.4.0/interface#a2.3.1获取图集最新评论楼层数
118    例子：http://mrobot.pcauto.com.cn/v3/cmt/get_newest_floor?url=http://www.pcauto.com.cn/nation/741/7419803.html
119参数:
120{
121    url:文章url,
122}
123返回:
124{
125    availableTotal:1,           // ???
126    floor:1,                    // ???
127    id:13309111,                // 帖子id
128    total:1,                    // 评论楼层数
129    turl:"http://www.pcauto.com.cn/nation/741/7419803.html",            // ???
130    url:"http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps30/t13309111.html",  // ???
131    url43g:"http://cmt.pcauto.com.cn/topic/3g/a0/r0/t13309111.html",    // ???
132}
133。。。。。。。。。。
134
1352.1.4.评论列表页
136是否分页：是
137是否缓存：否
138是否登录：否
139参考接口:
140    http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.7/newTopics.xsp?topicId=13308849&articleId=7410504&reverse=0&pageNo=2&pageSize=20
141参数:
142{
143    topicId=13308849,       // 帖子id
144    articleId=7410504,      // 文章id
145    reverse=0,              // 是否为倒序
146    pageNo:1,               // 页码
147    pageSize:20,            // 每页条数(默认20)
148}
149返回:
150{
151    "comments": [
152        {
153            "1": {                                  // 第几层引用评论
154                "id": "29494122",                   // 评论id
155                "userId": "35652465",               // 用户id
156                "name": "旅行",                     // 用户名
157                "floor": "56",                      // 楼层
158                "time": "2015-11-28 11:46:18",      // 时间
159                "client": "1",                      // ???
160                "content": "外观很是炫酷啊，不过还是觉得之前的款好看一些"   // 内容
161            },
162            "current": "1",                         // 目前引述数量
163            "support": "0",                         // 顶/点赞
164            "expand": false                         // ???
165        },
166        {
167            "1": {
168                "id": "29495407",
169                "userId": "42237840",
170                "name": "骑着蜗牛狂奔",
171                "floor": "127",
172                "time": "2015-11-28 23:10:29",
173                "client": "1",
174                "content": "众泰车标不好看，你看大众用的是三个VVV，你可以用三个人，车标一换保证大卖，我一直关注Z700不知道报价是多少"
175            },
176            "2": {
177                "id": "29495456",
178                "userId": "0",
179                "name": "广东省深圳市网友",
180                "floor": "130",
181                "time": "2015-11-29 00:39:20",
182                "client": "6",
183                "content": "兄弟，大众是vw"
184            },
185            "3": {
186                "id": "29496350",
187                "userId": "0",
188                "name": "甘肃省甘南州网友",
189                "floor": "160",
190                "time": "2015-11-29 21:03:44",
191                "client": "2",
192                "content": "三个人的标志早就有了，上海通达汽车的标志就是三个人"
193            },
194            "current": "3",
195            "support": "0",
196            "expand": false
197        }, ...
198    ]
199}
200。。。。。。。。。。
201
2022.1.5.发起评论(直接用原接口)
203是否分页：否
204是否缓存：否
205是否登录：否
206参考接口:
207    http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
208参数:
209{
210    anonymous:1,        // 是否匿名
211    client:3,           // ???
212    columnId:0,         // ???
213    content:"马力很足，外观漂亮，沉稳结实。。。",               // 内容
214    id:13309111,        // 帖子id
215    replyFloor2:1,      // 回复楼层，如果是评论而不是回复则不传
216    title:"新一代马自达MX-5台湾约售25.4万*屏蔽的关键字*",       // 标题
217    url:"http://www.pcauto.com.cn/nation/741/7419803.html",     // 文章url
218    username:"来自广东省广州市网友",                            // 用户名
219}
220返回:
221{
222    brief:"马力很足，外观漂亮，沉稳结实。。。",         // ???
223    commentId:29496571,                                 // 评论id
224    createTime:"2015-11-30 02:13:41",                   // 创建时间
225    floor:3,                                            // 楼层
226    resultCode:0,
227    resultMsg:"您的评论已经成功发表。注：评论在审核后才能出现在列表中,谢谢！",  // 提示信息
228    showName:"广东省广州市网友",                        // 用户名
229    status:0,
230    userId:"-1",                                        // 用户id
231}
232。。。。。。。。。。
233
2342.1.6.点赞 (直接用原接口)
235是否分页：否
236是否缓存：否
237是否登录：否
238参考接口:
239    http://cmt.pcauto.com.cn/action/comment/support_json.jsp?cid=29491723&sp=1
240参数:
241{
242    cid:29496563,   // 评论id
243    sp:1,           // ???
244}
245返回:
246{
247    floor:5,            // 楼层
248    postId:29496563,    // 评论id
249    status:0,
250    support:0,          // 顶/点赞数
251    topicId:13309111,   // 帖子id
252}
253。。。。。。。。。。
254
2552.2.1.车友圈首页最新列表
256是否分页：是
257是否缓存：否
258是否登录：否
259参考接口:
260   
261参数:
262{
263    pageNo=1,           // 页码
264    pageSize=20,        // 每页条数
265    userId=37962411,    // 用户id
266}
267返回:
268{
269    topicList: [
270        {
271            shareCount:100,            //新增分享数量
272            authorId: 41438580,
273            content: "我是第一次去看车就直接订车了，毕竟对这个车还是很认可的。正是以为很喜欢这个车的外形，并且还是小油耗，总之性价比很高，所以就赶紧订车了。再一个是因为自己上班比较紧张，我这等了好久的车可是到现在还没来到，并且了我这工地还要再上一段时间才能正式放年假了，工地放年假比较早。正是因为订车的原因，我就一直在家等着等提车了再走。可是看到网上说等了时间更长的也有。但自己工作实在是等不及，所以我就赶紧匆匆忙忙上...",
274            createAt: 1448608915000,
275            dynaType: 1,
276            isPick: false,
277            isRecommend: false,
278            lastpostAt: 1448608915000,
279            replyCount: 0,
280            title: "等待是可以理解的",
281            topicId: 9149317,
282            uri: "http://bbs.pcauto.com.cn/topic-9149317.html",
283            praiseCount: 0,
284            postCount: 0,
285            isPraise: 0,
286            dynaInfoId: 3693150,
287            appTitle: "等待是可以理解的",
288            author: {
289                isVip: false,
290                validBrandIcon: "",
291                name: "暨耙信",
292                nickname: "暨耙信",
293                userface: "http://i6.3conline.com/images/upload/upc/face/41/43/85/80/41438580_100x100",
294                userId: 41438580
295            },
296            images: [ ],
297            imagesSize: 0
298        }, ...
299    ]
300}
301。。。。。。。。。。
302
3032.2.2.车友圈首页精华列表
304    参数、返回值格式与2.2.1相同
305。。。。。。。。。。
306
3072.3.1.车友会签到条目
308是否分页：否
309是否缓存：否
310是否登录：否
311参数:
312{
313    车友会id,
314}
315返回:
316{
317    结果状态码,
318    提示信息,
319    签到人数,
320    用户列表条目[
321        {
322            用户id ,
323        }, ...
324    ]
325}
326。。。。。。。。。。
327
3282.3.2.车友会签到排行榜
329是否分页：是
330是否缓存：否
331是否登录：否
332参数:
333{
334    车友会id,
335    页码,
336    每页条数,
337}
338返回:
339{
340    结果状态码,
341    提示信息,
342    页码,
343    每页条数,
344    总页数,
345    签到人数,
346    总人数,
347    用户列表条目[
348        {
349            用户id,
350            昵称，
351            总签到，
352            连续签到，
353            签到时间(时分秒),
354            是否签到,
355        }, ...
356    ]
357}
358。。。。。。。。。。
359
3602.4.1.购车优惠页
361参考接口:
362    http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/serial.xsp?devId=cd797e4caf953a90a04f36a911783a23&appKey=782ae91ba147435a00000539&serialId=4313&areaId=1&isSubscribed=0&modelIds=&v=1.1.0
363请求参数:
364{
365    devId,
366    appKey,
367    sgId,
368    modelId,
369    areaId （地区id为车友会对应地区id）,
370    areaName,
371    cityName,
372    pageNo,
373    pageSize,
374}
375返回:
376    参照原来接口返回
377。。。。。。。。。。
378
3792.4.2.我要优惠页wap
380参考接口:
381    http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/getPromotion.xsp?devId=cd797e4caf953a90a04f36a911783a23&appKey=782ae91ba147435a00000539&areaId=2&dealerId=79574&serialId=3524&modelId=41612&modelName=%E5%A5%A5%E8%BF%AAA4L%202016%E6%AC%BE%2035%20TFSI%20%E8%87%AA%E5%8A%A8%E6%A0%87%E5%87%86%E5%9E%8B¤tPrice=18.28&disString=%E8%B4%AD%E8%BD%A6%E7%9B%B4%E9%99%8D13%E4%B8%87&image=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_80x60.jpg&v=1.1.0&chId=qcbj01&referer=sg_discount
382请求参数:
383    无
384返回:
385    无
386协议:
387    选城市　    pcautoclub://pcauto-model-choosecity/
388    优惠结果    pcautoclub://auto-get-promotion-result/
389。。。。。。。。。。
390
3912.4.3.优惠详情页wap
392参考接口:
393    http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionDetail.xsp?devId=&appKey=782ae91ba147435a00000539&marketId=9868696&modelId=39051&areaId=1
394请求参数:
395    无
396返回:
397    无
398协议:
399    电话　　    pcaction://webview_tel/
400    我要优惠    pcautoclub://auto-get-promotion/
401    地图　　    pcautoclub://abc-map/?jing=113.3545972946317&wei=23.00336254009504&name=%E5%B9%BF%E5%B7%9E%E5%B8%82%E7%95%AA%E7%A6%BA%E9%87%91%E5%86%A0%E6%B1%BD%E8%BD%A6%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8&address=%E5%B9%BF%E4%B8%9C%E7%9C%81%E5%B9%BF%E5%B7%9E%E5%B8%82%E7%95%AA%E7%A6%BA%E5%8C%BA%E7%95%AA%E7%A6%BA%E5%A4%A7%E9%81%93%E5%8C%97338%E5%8F%B7%EF%BC%88%E5%8D%B3%E5%8D%97%E6%9D%91%E9%95%87%E9%87%8C%E4%BB%81%E6%B4%9E%E8%B7%AF%E6%AE%B5%EF%BC%89
402。。。。。。。。。。
403
404mrobot合并：
405==================================================
4063.1.1.车友圈首页，需要合并：
407    http://mrobot.pcauto.com.cn/xsp/s/club/v4.5/clubHomePage.xsp?pageSize=20&clubId=1121&pageNo=1
408    2.2.1.车友圈首页最新列表
409    2.2.2.车友圈首页精华列表
410。。。。。。。。。。