pcauto_club_4.4.0/api – iphone

wiki:pcauto_club_4.4.0/api

Context Navigation

接口索引

1. 1. 车友会提供APP接口4.4
  1. 车友会相关接口
2. 2. mrobot 合并

1. 车友会提供APP接口4.4

车友会相关接口

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.4
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.3
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.0
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0

2. mrobot 合并

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.3
APP4.3的相关接口，在开发环境已可以
车友会的，开发环境URL前缀：http://dev18.pcauto.com.cn/
论坛的，开发环境URL前缀：http://dev11.pcauto.com.cn:12085/bbs7/

车友会的，测试环境URL前缀：http://v71.pcauto.com.cn:82
论坛的，测试环境URL前缀：http://v15.pcauto.com.cn

mrobot：开发：http://dev40.pcauto.com.cn
        测试：http://v80.pcauto.com.cn
        线上：http://mrobot.pcauto.com.cn

登陆：http://test232.pcauto.com.cn/passport2
车友会：http://v37.pcauto.com.cn:82
passport: 开发环境 https://dev30.pcauto.com.cn/passport3/rest/login.jsp?username=3edc4rfv&password=123456
          测试环境：https://v46.pcauto.com.cn/passport3/rest/login.jsp?username=3edc4rfv&password=123456

2.0 话题页

接口： /xsp/s/club/v4.4/topicsPage.xsp?pageNo=1&pageSize=10&subjectId=993&title=&userId=33953964
说明 : 话题详情页面

是否分页:否
是否缓存:否
是否登陆:否

返回结果：
{
    "subjectHead": { //话题头部，当翻页的时候此处为空
        "code": 0,
        "description": "欢迎大家参与讨论！dfdfdf d<br><br>dfdf非官方个非官方<br>速度是多少",
        "logo": "http://www1.pcauto.com.cn/20150323/hotTopic/img/defLogo.jpg",
        "message": "操作成功",
        "pvCount": 30,
        "replyCount": 3,
        "subjectId": 993,
        "title": "#我我我#",
        "version": "v1.0(latest)"
         shareUrl:分享Wap链接
    },
    "subjectImages": { //话题图片，当翻页的时候此处为空
        "code": 0,
        "imageList": [],
        "message": "操作成功",
        "subjectId": 993,
        "version": "v1.0(latest)"
    },
    "subjectTopList": { //置顶话题列表，当翻页的时候此处为空
        "code": 0,
        "message": "操作成功",
        "subjectId": 993,
        "topList": [
            {
                "brandLogo": "",
                "content": " #我我我#",
                "createAt": 1435891522000,
                "createBy": 35631313,
                "dynaInfoId": 1249752,
                "images": [],
                "isVip": 0,
                "nickName": "test_th1002",
                "postCount": 0,
                "praiseCount": 0,
                "hadPraise": 0
            },
            {
                "brandLogo": "",
                "content": " #我我我#和交换机和",
                "createAt": 1435891573000,
                "createBy": 35631313,
                "dynaInfoId": 1249753,
                "images": [],
                "isVip": 0,
                "nickName": "test_th1002",
                "postCount": 0,
                "praiseCount": 0,
                "hadPraise": 0
            }
        ],
        "version": "v1.0(latest)"
    },
    "dynaListHot": {//最热话题列表，当翻页的时候最热和最新的都会返回数据，客户端可以把两边的数据都整理好，那切换的时候就不用再请求了
        "code": 0,
        "dynaList": [
            {
                "brandLogo": "",
                "content": " #我我我#",
                "createAt": 1435891263000,
                "createBy": 35631313,
                "dynaInfoId": 1249751,
                "images": [],
                "isVip": 0,
                "nickName": "test_th1002",
                "postCount": 0,
                "praiseCount": 0,
                "hadPraise": 0
            }
        ],
        "message": "操作成功",
        "pageCount": 1,
        "pageNo": 1,
        "pageSize": 10,
        "total": 1,
        "version": "v1.0(latest)"
    },
    "dynaListNew": {//最新话题列表,当翻页的时候最热和最新的都会返回数据，客户端可以把两边的数据都整理好，那切换的时候就不用再请求了
        "code": 0,
        "dynaList": [
            {
                "brandLogo": "",
                "content": " #我我我#",
                "createAt": 1435891263000,
                "createBy": 35631313,
                "dynaInfoId": 1249751,
                "images": [],
                "isVip": 0,
                "nickName": "test_th1002",
                "postCount": 0,
                "praiseCount": 0,
                "hadPraise": 0
            }
        ],
        "message": "操作成功",
        "pageCount": 1,
        "pageNo": 1,
        "pageSize": 10,
        "total": 1,
        "version": "v1.0(latest)"
    }
}

后端应用接口：
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.4
1.1.1 话题头部信息 接口/appapi/2.0/subject/getSubjectHead.do [GET]

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.3
1.1.2 话题导语图片列表 接口/appapi/1.0/subject/getSubjectImages.do [GET]
1.1.3 话题置顶列表 接口/appapi/1.0/subject/getSubjectTopList.do [GET]
1.1.4 话题说说列表（最热） 接口/appapi/1.0/subject/getDynaListHot.do [GET]
1.1.5 话题说说列表（最新） 接口/appapi/1.0/subject/getDynaListNew.do [GET]
阅读数加一    接口/appapi/1.0/subject/updatePv.do?subjectId=[POST]

协议参数说明:

参数名类型必须说明
subjectId String Y 话题ID（如果>0,则忽略title参数）
title String Y 话题标题(与话题ID至少有一个)
userId String N 用户ID
pageNo String N 页码
pageSize String N 页面大小

2.1 动态详情

接口：/xsp/s/club/v4.4/dyna_detail.xsp
请求参数：
	*dynaInfoId：动态id
        *userId: 当前用户的id，用于判断该用户是否已赞

{
	code:0成功，-1失败
        message:提示信息
        version: 接口版本号如1.0，1.0（latest)表示最新版本

	dynaDetail:[
		{
                  shareUrl:分享Wap链接
	          authorId: 28999678,
                  authorName: "yumanjie1",
                  authorPhoto: "http://i6.3conline.com/images/upload/upc/face/28/99/96/78/28999678_50x50",
                  brandLogo: "",
                  content: "#哈弗H9断轴#安全最重要",
                  contribution: 0,
                  createBy: 28999678,
                  dynaInfoId: 1999583,
                  dynaTargetId: 1999583,
                  dynaType: 2,
                  dynaUrl: "",
                  forumId: 0,                  
                  isHasImg: 0,
                  isPick: 0,
                  isRecommend: 0,
                  isVip: 0,
                  nickname: "鐏忓繘纭规ジ?",
                  postCount: 0,
                  praiseCount: 2,
                  pubTime: 1431095451000,
                  topicId: 0,
                  topicTitle: "",
                  hadPraise: 1
                  images:[
	                {
                  	    url:http://xxxx.jpg,
		             //真实宽度
		             width:960,
		            //真实高度
		           height:1000,
		            //质量参数,默认为0，10月上线
		            qua:80
		         },
                           {
 		            url:http://xxxx.jpg,
		            //真实宽度
		             width:960,
		           //真实高度
 		           height:1000,
		           //质量参数,默认为0，10月上线
		            qua:80
		           }		
	             ]
                   urlList
                     [
                        {
                            "url": "http://club.pcauto.com.cn/topic/2861.html"
                        },
                        {
                            "url": "http://my.pcauto.com.cn/33330900/dt/3120078/"
                        },
                        {
                            "url": "http://bbs.pcauto.com.cn/topic-8444470.html"
                        }
                    ]
	      }
      ]
}

后端接口
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.4
1.1 获取动态详情接口4.0
说明：获取动态
接口：/appapi/4.0/dyna/getDynaDetail.do [GET]

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0
1.1.31 判断是否已赞
接口：/appapi/1.0/dyna/getHadPraiseList.do [GET]
返回增加
hadPraise：已赞,
当前用户是否已赞字段

2.2 主题终端页

接口： /club/bbs/forumTopics?topicId=7885193&pageNo=1&pageSize=10&userId=9112159&authorId=0


接口  [GET]
说明 : 在帖子终端页里新添加视频播放和倒序功能
请求参数 ：
  topicId：主题ID
  userId: 用户ID
  authorId：作者ID //查看楼主时候用
  pageNo=1
  pageSize=10
  desc //不填默认false正序，true 倒序，

是否登录 : 提交报名活动时候需要
缓存时间 : 无
是否分页 : 是


返回结果：HTML页面


后端应用接口：
车友会帖子：
/appapi/1/forum/topic.do

车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.2.5 主题终端 接口/appapi/1/forum/topic.do [GET]
1.1.5 获取主题对应的动态ID /appapi/1.0/forum/getDynaByTopicId.do

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0
1.1.29 获取动态点赞用户列表 接口：/appapi/1.0/dyna/getPraiseUserList.do [GET]

2.3私信对话列表

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.4/message_dialogue.xsp
请求参数
必填参数：
    senderId：发送者Id
非必填参数：
    pageNo：不传默认为1
    pageSize：不传默认为20


说明：获取私信对话列表,4.4新添加urlList字段，用来把私信里面的链接做成可以点击
来源：
http://trac.pc.com.cn/bip/wiki/%E6%8E%A5%E5%8F%A3（17接口）
http://bip.pcauto.com.cn/intf/privateDialogue.jsp?
必填参数：
    senderId：388
非必填参数：
    pageNo：不传默认为1
    pageSize：不传默认为20

需要调用
20.更新指定发送者Id发给当前登录用户的所有未读私信状态为已读
http://bip.pcauto.com.cn/intf/message.jsp?
必填参数：
    act：readAllBySenderId
    senderId: 发送者ID
非必填参数：
  callback ：支持回调函数，=windowname时表示以windowname形式返回
  windowname ：1或true 以windowname形式返回，不传或0或false以json格式返回

清空未读数
请求参数
是否登录:是
缓存时间:无
是否分页:是
{
	total: 总的条数,
	pageNo: 页码,
	pageCount: 页数,
	pageSize: 每页条数,
	resultList:[
		{
			“id":私信ID,
			“content":私信内容,
			“createTime":创建时间,
			"status":私信状态,
       			“accountId”:13128876,
			“senderId”:发私信者ID,
			“replyId":回复私信ID,
			“showStatus":显示状态，如果该信息的sender_id为黑名单里面的则不显示，状态为0，否则为1
		}
	]
        urlList: [
              {
                       //话题：PC：http://club.pcauto.com.cn/topic/2861.html，APP：pcautoclub://club-talk/id
                       url: "http://club.pcauto.com.cn/topic/2861.html",
                      target : "pcautoclub://club-talk/2861"
               },
              {
                      //动态（除活动外）：PC：http://my.pcauto.com.cn/31182785/dt/3038457/，APP：pcautoclub://club-dyna/id
                      url: "http://my.pcauto.com.cn/31182785/dt/3038457/",
                      target: "pcautoclub://club-dyna/3038457"
               },
              {
                      //帖子：PC：http://bbs.pcauto.com.cn/topic-8324623.html,APP：pcautoclub:/bbs-topic/id
                      url: "http://my.pcauto.com.cn/31182785/dt/3038457/",
                      target: "pcautoclub:/bbs-topic/8324623"
               }
       ] 
}

2.4详情页面增加链接列表

主题/帖子终端：http://bbs.pcauto.com.cn/appapi/1/forum/topic.do
对应：主题终端页面

动态详情：http://club.pcauto.com.cn/appapi/4.0/dyna/getDynaDetail.do
对应：http://trac.pc.com.cn/iphone/wiki/pcauto_club_4.4.0/api#a2.1%E5%8A%A8%E6%80%81%E8%AF%A6%E6%83%85


私信详情：http://bip.pcauto.com.cn/intf/privateDialogue.jsp
对应：http://trac.pc.com.cn/iphone/wiki/pcauto_club_4.4.0/api#a2.3%E7%A7%81%E4%BF%A1%E5%AF%B9%E8%AF%9D%E5%88%97%E8%A1%A8


--------------------------------------------------------------------------------------------------------------------------------
对上面3个接口的内容进行过滤，把所有链接提取，并返回链接列表，接口增加字段内容如下：
urlList: [
   {
      url:原链接
      target:转换后的链接
   },
   {
      url:原链接
      target:转换后的链接
   }
  ]

--------------------------------------------------------------------------------------------------------------------------------
规则：如果详情内容中，包括下面几个种链接需要转换，否则target=url
话题：
PC：http://club.pcauto.com.cn/topic/2861.html
APP：pcautoclub://club-talk/id

动态（除活动外）：
PC：http://my.pcauto.com.cn/31182785/dt/3038457/
APP：pcautoclub://club-dyna/id

帖子：
PC：http://bbs.pcauto.com.cn/topic-8324623.html
APP：pcautoclub:/bbs-topic/id

返回
顶部

Download in other formats:

Plain Text

参数名	类型	必须	说明
subjectId	String	Y	话题ID（如果>0,则忽略title参数）
title	String	Y	话题标题(与话题ID至少有一个)
userId	String	N	用户ID
pageNo	String	N	页码
pageSize	String	N	页面大小