Ticket #57 (closed 需求: 已处理)

Opened 13 years ago

Last modified 13 years ago

汽车网独立论坛客户端1.0(pcauto_bbs_1.0.0)接口

Reported by: qinhongyuan Owned by: qinhongyuan
Priority: 重要的(3) Milestone:
Component: 汽车网论坛 Version:
Keywords: 论坛 客户端 接口 Cc:
Due Date: 16/04/2013

Description

汽车网独立论坛客户端1.0(pcauto_bbs_1.0.0)接口
开发汽车网独立论坛客户端1.0(pcauto_bbs_1.0.0)接口,接口相关文档详见下面链接:
项目文档: http://trac.pc.com.cn/iphone/wiki/pcauto_bbs_1.0.0
接口文档: http://trac.pc.com.cn/iphone/wiki/pcauto_bbs_1.0.0/intfs

Change History

comment:1 Changed 13 years ago by qinhongyuan

论坛对外接口介绍:http://trac.pc.com.cn/bbs/wiki/intf

2.2我的回帖
http://bbs.pcauto.com.cn/intf/user/_posts.jsp?help=xx
Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:2 Changed 13 years ago by qinhongyuan

个人中心接口

2.1新消息
http://bip.pcauto.com.cn/intf/message.jsp?act=getNumToJson&siteId=2&status=0
参数:accountId 用户id,不填取登录用户id

返回结果{"messageCount":0,"systemNoticeCount":2,"fansCount":0}
messageCount为短消息,systemNoticeCount为系统消息,fansCount为粉丝数
数据代表未读消息,即是新消息

comment:3 Changed 13 years ago by qinhongyuan

上传头像接口
 http://upc.pcauto.com.cn/upload_head.jsp

  请求:{server url}/upload_head.jsp
  参数:
  common_session_id:如果与上传中心不同域的应用在本地读取cookie并上传。
  uploadType: 上传类型,缺省为正式头像。如果是"temp"则保存在头像临时目录待处理。
  返回(json):
  失败:{retCode: xxx}
  成功:{retCode: 0}

如有问题联系黄贤端

Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:4 Changed 13 years ago by qinhongyuan

发短消息

http://bip.pcauto.com.cn/intf/message.jsp?act=create
参数:
accountId 发送给某个用户
content 消息内容
captcha 验证码

            /*
             * 发送限制 add by handy 2012.04.01
             * 1.post 2.验证码 3.黑名单
             * 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户 edit by handy 2012.04.10
             * 5.发送频率 50次/ID/24H
             * 6.白名单最多一次发送50个用户,非白名单则每次只能发一个 7.添加关键词库过滤
             */

结果返回
{code:0,message:"提示"}

comment:5 Changed 13 years ago by qinhongyuan

用户信息

http://bbs.pcauto.com.cn/action/user/user_setting_json.jsp
需要当前用户登录

结果返回:
nickname为昵称
rank为level
name为用户名
userId用户id

用户头像根据userId来获取

已上线

Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:6 Changed 13 years ago by qinhongyuan

我回复的

http://bbs.pcauto.com.cn/intf/user/_posts.jsp?userId=903&pageNo=1&pageSize=20&maxLength=20
加参数help=xxx可以看文档

结果返回:
floor所处楼层
content回复内容
topicId主帖id
postCreateAt回帖发表时间
authorName帖子用户名
authorNickName帖子用户昵称
authorId帖子用户id
title主题
replyCount回复数
viewCount浏览数
topicUrl主题url
url帖子url

已上线

Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:7 Changed 13 years ago by qinhongyuan

我的帖子

http://bbs.pcauto.com.cn/intf/user/_topics.jsp?userId=903&pageNo=1&pageSize=20&maxLength=20
加参数help=xxx可以看文档

结果返回:
topicCreateAt发帖时间
pick大于0表示精华
isContainImage包含图片
replyCount回复数
viewCount浏览数
floor楼层数
title主题
topicId主帖id
url主帖url

已上线

Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:8 Changed 13 years ago by qinhongyuan

系统消息

http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&groupType=-1&pageNo=1&pageSize=10
需要登录(siteId表示网站,2为汽车网)
status(-1为已读和未读,0表示未读,1表示已读)

结果返回:
content消息内容
accountId用户id
createTime消息时间

头像根据用户ID来处理

已上线

Version 3, edited 13 years ago by qinhongyuan (previous) (next) (diff)

comment:9 Changed 13 years ago by qinhongyuan

短消息(站内信)

http://bip.pcauto.com.cn/intf/message.jsp?act=find&siteId=2&pageNo=1&status=-1&pageSize=10
需要登录(短消息是4网通用滴)
status(-1表示已读和未读,0表示未读,1表示已读)

结果返回:
accountId用户id
senderId发送方用户id
content消息内容
createTime发送时间

头像根据用户ID来处理

已上线

Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:10 Changed 13 years ago by qinhongyuan

帖子列表

http://bbs.pcauto.com.cn/rest/forums/14140?filter=pick&pageNo=1&pageSize=20
filter参数:
pick精华
replycount回复数排序
postat发帖时间排序
replyat回帖时间排序(默认)
time按时间筛选帖子,额外添加参数fval=秒数

comment:11 Changed 13 years ago by qinhongyuan

帖子终端页

level用户等级

已上线

Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:12 Changed 13 years ago by qinhongyuan

同步下载内容--我的爱车

http://my.pcauto.com.cn/intf/getCars.jsp?act=getCars
需要登录

结果返回:
id车Id
carModelId车型Id
carSeriesId车系Id
brandId品牌Id
carPic爱车图片

http://my.pcauto.com.cn/intf/getCarAttr.jsp?act=getCarAttr&carId=204707
参数carId(上面结果返回的车Id)支持批量,用逗号隔开

结果返回
series车系
model车型
brand品牌
Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:13 Changed 13 years ago by qinhongyuan

同步上传内容--我的爱车

添加车型
http://my.pcauto.com.cn/intf/modifyCar.jsp
新增 参数:act=save, series 车系Id model 车型Id driveStatus (0:未驾驶,1:驾驶) carPic 爱车图片

修改 参数:act=update, carId 爱车Id series 车系Id model 车型Id driveStatus (0:未驾驶,1:驾驶) carPic 爱车图片

删除 参数:act=delCar, carId 爱车Id

结果返回:
{"code":0} 成功

comment:14 Changed 13 years ago by qinhongyuan

同步下载内容--收藏帖子,收藏版块

收藏版块
http://bbs.pcauto.com.cn/intf/user/_favForums.jsp?userId=8578325
参数userId用户ID

结果返回:
favoriteId收藏ID
forumId版块ID
name版块名
url版块链接
收藏帖子
http://bbs.pcauto.com.cn/intf/user/_favTopics.jsp?userId=8578325
参数userId用户ID

结果返回:
favoriteId收藏ID
topicId帖子ID
url帖子链接

均支持分页

comment:15 Changed 13 years ago by qinhongyuan

同步上传内容--收藏帖子,收藏版块

http://bbs.pcauto.com.cn/action/user/favorite.jsp
需要登录(不支持批量)
参数:tid帖子ID,fid版块ID

结果返回:
{"status":0}
http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp
需要登录(支持批量)
参数:收藏ID(批量方式id=xxx&id=xxx)

结果返回:
{"status":0}
Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:16 Changed 13 years ago by qinhongyuan

把未读消息变成已读消息

http://bip.pcauto.com.cn/intf/message.jsp
需要登录
提交方式POST
参数:messageId(可以多个),act=read
结果返回:
{"code":0}
Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:17 Changed 13 years ago by qinhongyuan

把未读系统消息变成已读系统消息

http://bip.pcauto.com.cn/intf/sysnotice.jsp
需要登录
提交方式POST
参数:noticeId(可以多个),act=read
结果返回:
{"code" : 0}
Last edited 13 years ago by qinhongyuan (previous) (diff)

comment:18 Changed 13 years ago by qinhongyuan

  • Status changed from new to closed
  • Resolution set to fixed

comment:19 Changed 13 years ago by kuangjuhuan

论坛后台配置回复主楼对应BIP的typeId为2030,回复本楼typeId为2031。

论坛回帖发送信息到BIP,具体参数如下:

fid:帖子所在版块ID
tid:主题ID
topicUrl:主题链接
title:主题标题
topicCreateAt:主题创建时间(时间戳)

pid:回复帖子ID
floor:回复帖子楼层
postCreateAt:回复帖子创建时间(时间戳)
postUrl:回复帖子链接(可定位到该楼层)
postMsg:回复帖子内容(暂保留200个字符)

uid:回帖用户ID
nickname:回帖用户昵称
userUrl:回帖用户链接

beReplyPostFloor:被回复帖子楼层(如果是回复主楼则是1)
beReplyPostUrl:被回复帖子链接(如果回复主楼则没该字段返回,可定位到该楼层)
Note: See TracTickets for help on using tickets.