[[PageOutline(1-100,接口索引)]]

== 1. 车友会提供APP接口4.5 ==

=== 车友会相关接口
{{{
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.5
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.5/clubHomePage.xsp?pageNo=1
说明 : 首页

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

返回结果：
{
   activelist: [ //焦点图
      {
        title: "卡拉丁200个空调滤清器免费送",
        url: "http://bbs.pcauto.com.cn/topic-7886091.html",
        appUrl: "pcautoclub://bbs-topic/7886091",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/syfocus/1507/660-330_3.jpg",
        dynaInfoId: "",
        createBy: ""
       },
      {
        title: "新蒙女神当车模",
        url: "http://bbs.pcauto.com.cn/topic-7909340.html",
        appUrl: "pcautoclub://bbs-topic/7909340",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/syfocus/1507/4fg.jpg",
        dynaInfoId: "",
        createBy: ""
      },
      {
        title: "#女子练车被教练摸胸#",
        url: "http://club.pcauto.com.cn/topic/2083.html",
        appUrl: "pcautoclub://club-talk/2083",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp/1507/shiahisda.jpg",
        dynaInfoId: "",
        createBy: ""
      },
      {
        title: "【摄影】提车娶媳妇 走上人生巅峰",
        url: "http://bbs.pcauto.com.cn/topic-7677662.html",
        appUrl: "pcautoclub://bbs-topic/7677662",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp/1507/hunlia.jpg",
        dynaInfoId: "",
        createBy: ""
      },
     {
        title: "58到家家政35元优惠券免费领",
        url: "http://bbs.pcauto.com.cn/topic-7913425.html",
        appUrl: "pcautoclub://bbs-topic/7913425",
        img: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/1507/660X330.jpg",
        dynaInfoId: "",
        createBy: ""
      }
   ],
   discover: [ //话题推荐
    {
        appUrl: "pcautoclub://club-talk/2111",
        title: "#宝马奔驰对撞#"
    },
    {
        appUrl: "pcautoclub://club-talk/2101",
        title: "#女司机奇葩事#"
    },
    {
        appUrl: "pcautoclub://club-talk/2081",
        title: "#解读仪表盘图标#"
    },
    {
        appUrl: "http://www.pcauto.com.cn/forum/club/goddess/",
        title: "更多精彩话题"
     }
   ],
   pics: [ //三个图片链接
       {
            img: "http://img.pcauto.com.cn/images/upload/upc/tx/bbs6/1505/25/c4/7330412_1432490607019_400x400.jpg",
            link: ""
        },
       {  
            img: "http://img.pcauto.com.cn/images/upload/upc/tx/bbs6/1505/25/c4/7330412_1432490607019_400x400.jpg",
            link: ""
        },
       {
             img: "http://img.pcauto.com.cn/images/upload/upc/tx/bbs6/1505/25/c4/7330412_1432490607019_400x400.jpg",
             link: ""
        }
     ],
   txts: [//文字链接
        {
            txt: "文字描述",
            link: ""
        }
     ]
   data: [//精选日报
        {
             title: "【有奖活动】秀招牌动作赢智能扫地机",
             url: "http://club.pcauto.com.cn/topic/3521.html",
             pic: "http://img0.pcauto.com.cn/pcauto/forum/club/activeapp_v2/1510/640-240_2_.jpg",
             summary: "",
             userId: "",
             appUrl: "pcautoclub://club-talk/3521",
             topicid: "",
             userfaceUrl: ""
        },
        {
             title: "【车展美拍】网友分享国庆期间车展上的靓丽模特",
             url: "http://bbs.pcauto.com.cn/topic-8657466.html",
             pic: "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/wapshequ/wapshequhot/1510/chezhan.jpg",
             summary: "三月三日天气新，长安水边多丽人。态浓意远淑且真，肌理细腻骨肉匀。绣罗衣裳照暮春，蹙金孔雀银麒麟。头上何所有？翠微榼叶垂鬓唇。背后何所见？珠压腰衱稳称 身。",
             userId: "31812249",
             appUrl: "pcautoclub://bbs-topic/8657466",
             topicid: "",
             userfaceUrl: "http://i6.3conline.com/images/upload/upc/face/31/81/22/49/31812249_100x100"
         }
      ]

跳转协议：
    {
        主题：pcautoclub://bbs-topic/
        说说：pcautoclub://club-dyna/
        话题：pcautoclub://club-talk/
        圈子：pcautoclub://bbs-topics/
        其它：url
    }

后端应用接口：
//三个图片链接
http://www.pcauto.com.cn/forum/club/app/1510/intf7931.html
//文字链接
http://www.pcauto.com.cn/forum/club/app/1510/intf7971.html
//焦点图
http://www.pcauto.com.cn/forum/club/activeapp_v2/
//精选日报:
正常数据
http://www.pcauto.com.cn/forum/club/shequ/wapshequ/1503/intf6627.html
送审数据：
http://www.pcauto.com.cn/forum/club/shequ/wapshequ/1510/intf8011.html


}}}
    协议参数说明:
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||
   ||pageNo||String||是||页码||
   ||inreview||String||否||IOS APP送审用，1为送审期间||


==== 2.1 提问详情页 ====
{{{
接口： /club/bbs/forumTopics?topicId=8757624&userId=35631572&pageNo=1&pageSize=19&authorId=0&topicTemplate=3.1.0&app=pcautoclub&size=18&picRule=2&desc=false
说明 : 提问详情页,所有的处理跟普通的帖子页是一样的

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

返回结果：
HTML页面

后端应用接口：


}}}
    协议参数说明: 跟之前的贴子页一样，这里不做详细列了
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||
   
   页面内协议说明：
   ||协议串||说明||
   ||pcautoclub://report||跳转到举报页面||
   ||pcautoclub://adopt||采纳按钮协议||
   ||inreview||String||否||IOS APP送审用，1为送审期间||


==== 2.2 举报wap ====
{{{
接口： /club/bbs/report
说明 : 举报wap，提交结果是app触发协议提交的。

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

返回结果：
html页面

后端应用接口：
1.1. 内容举报接口 接口：/appapi/4.5/report/addReport.do [POST]

}}}
    协议参数说明:
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||
   ||reporterId||String||是|| 举报人id ||
   ||reporterNickname||String||是||举报人昵称||
   ||targetUserId||String||是||被举报人id||
   ||targetUserNickname||String||是||被举报人昵称||
   ||targetId||String||是||举报内容ID (如果是论坛帖子，这个id，传的是楼层的id）||
   ||targetExtId||String||否||（简单做法：1、如果是相片，这个id，传的就是相片所对应相册的id；2、如果是论坛帖子，这个id，传的就是帖子id；3、其他类型，不需要传）||
   ||targetUrl||String||否||举报内容URL||
   ||targetType||String||是||举报类型(1:帖子;2:动态;3:话题;4:照片;5:活动;6:投票;7:WebView')||
   ||reportContent||String||是||举报内容（即标题）||

   页面内协议说明：
   ||协议串||说明||
   ||pcautoclub://submit-report||提交内容接口，提交到车友会的/appapi/4.5/report/addReport.do接口，参数已经付在协议后面||
==== 2.3 车友圈 ====
{{{
接口： 
说明 : 车友圈

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

返回结果：
{
    
}

后端应用接口：


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


==== 2.4 询价页 ====
{{{
接口：/club/price/askprice?v=1.1.0&serialId=12381&cityName=广州&provinceName=广东&modelName=威朗%202015款%2015S%20自动领先型&modelId=40152&dealerId=0&image=http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1507/21/c19/10039984_10039984_1437463397365_120x90.JPG&isMain=1&name=格瓦拉&tel=13760741234&appKey=4f4277c7a1428d2000000483&chId=app_store&devId=9741deed71cb3dec887d9eb618363b95f348236b&countDevId=020000000000&referer=sg_sum

说明 : 我要询价

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

返回结果：
html页面

后端应用接口：
//获取询价经销商
http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp?rid=" + areaId + "&sgid=" + serialId + "&type=0
//意向车型
http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?vs=1.3&serialGroupId="+ serialId
//地区
http://mrobot.pcauto.com.cn/v3/price/allRegionList

}}}

   协议参数说明:
  ||= 参数名 =||= 类型 =||= 是否必须 =||= 说明 =||
  ||serialId||string||是||车系id||
  ||modelId||string||是||车型id||
  ||url||string||否||车型图片的url,当车型有图片的时候传||
  ||modelName||string||是||车系名称+车型名称||
  ||serialName||string||是||车系名称||
  ||provinceName||string||是||省名称||
  ||cityName||string||是||市名称||
  ||dealerId||string||是||经销商id，由车系综述页进入询底价页时，取0；由车型综述页中的经销商列表进入询底价页时，取对应的经销商id值||
  ||name||string||否||询价者姓名，不为空时“询底价页”的姓名一栏会填入该值||
  ||tel||string||否||询价者手机号，不为空时“询底价页”的手机号一栏会填入该值||
  ||appKey||string||否||应用id，即应用的魔方key||
  ||chId||string||否||来源渠道id，如应用在苹果商店下载安装的，取值为"app_store"||
  ||devId||string||否||设备id||
  ||referer||string||否||来源url，详见附件《汽车报价宝典线索入口来源对应参数表（重要）.txt》||
  ||isMain||string||否||是否需要提供车型选择的跳转协议，0：不需提供，1：需提供，跳转协议为：pcautoclub://choose-car/。注：只有当dealerId为0时该参数有效||
  ||v||string||是||接口版本，固定取值"1.1.0"||

[[BR]]
   页面内协议说明：
   ||协议串||说明||
   ||pcautoclub://choose-car/||车型选择||
   ||pcautoclub://showtip/||经销商的选择个数超过上限，APP的提示文案为"最多选择3个经销商"（注：协议串不带文案信息）||
   ||pcautoclub://pcauto-model-choosecity||城市选择||  
   ||pcautoclub://pcauto-ask4price-result||询价成功后，提示结果并返回之前页面reslut:1成功，0失败[[BR]] pcautoclub://pcauto-ask4price-result?ret=0&name=abcd&tel=12366363636&retult=1&message=恭喜您，询价成功。稍后会有商家与您联系 [[BR]]pcautoclub://pcauto-ask4price-result?ret=0&name=abcd&tel=12366363636&retult=0&message=非常抱歉！询价信息提交失败。请您重新提交||

==== 2.5 收到的回复 ====
{{{
接口： /club/bbs/getClubReplyRemindsV46?resp_enc=UTF-8&req_enc=UTF-8&source_agent=1
说明 : 收到的回复

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

返回结果：
{
	pageCount: 1,
	pageNo: 1,
	pageSize: 20,
	resultList: [
		{
                        createBy: "", //主贴的创建者
			createTime: 1445594323000,
			replyContent: "hsjsjsjsjsk ",
			replyId: 93991506,
			replyType: 1,
			replyUserId: 28999678,
			replyUserImg: "http://i6.3conline.com/images/upload/upc/face/28/99/96/78/28999678_50x50",
			replyUserName: "大鳗鱼",
			targetId: 9892481,
			time: 1445593982000,
			toReplyContent: "111113",
			toReplyId: 9892481,
                        topicType: "" //是否帖文贴，值为"question"提问贴
		},
		{
			createTime: 1445594315000,
			replyContent: "刚回家看看看 ",
			replyId: 93991507,
			replyType: 1,
			replyUserId: 28999678,
			replyUserImg: "http://i6.3conline.com/images/upload/upc/face/28/99/96/78/28999678_50x50",
			replyUserName: "大鳗鱼",
			targetId: 9892481,
			time: 1445593989000,
			toReplyContent: "111113",
			toReplyId: 9892481,
                        topicType: ""
		}
	],
	total: 2
}

后端应用接口：


}}}
    协议参数说明: 是在之前接口里面加了个字段，参数就不在列了
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||


==== 2.6 热门话题送审接口 ====
{{{
接口： /xsp/s/club/v4.5/hotSubjectList4Review.xsp
说明 : 热门话题送审接口

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

返回结果：
{
   subjectList : [{
       subjectId:话题ID
       title:话题标题
       description:导语
       logo:话题图标   

   }]
   
   total:总条数
   pageNo:页码
   pageSize:每页条数
   pageCount:总共几页

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

后端应用接口：
//CMS录入一下话题
http://www.pcauto.com.cn/forum/club/app/1510/intf8051.html
//trac4.1, 1.1.1 最热话题列表
/appapi/1.0/subject/subjectDetailByPostCont.do

}}}
    协议参数说明:
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||

==== 2.7  向我求助====
{{{
接口：/xsp/s/club/v4.5/listAsk4AdviceTopics.xsp?pageNo=1&pageSize=10

说明 : 向我求助加上图片和头像url

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

返回结果：
{
  code: 0,
  forum: {
      bbs: 19,
      forumId: 14674,
      lastQuestionCreateAt: 0,
      name: "嘉年华论坛",
      parentId: 298
   },
  message: "操作成功",
  pageNo: 1,
  pageSize: 10,
  version: "v1.0(latest)",
  topicList: [
     {
       authorId: 41652740,
       content: "请教，双闪按钮上方的带锁符号的按钮起什么作用？",
       createAt: 1444724566000,
       dynaType: 4, //1为普通  4为提问帖
       isBestAnswer: false,
       isPick: false,
       isRecommend: false,
       lastpostAt: 1444796172000,
       replyCount: 3,
       title: "请教，双闪按钮上方的带锁符号的按钮起什么作用？",
       topicId: 8699533,
       uri: "http://dev39.pcauto.com.cn/topic-8699533.html",
       author: {
           isVip: false,
           validBrandIcon: "",
           name: "qz35631572",
           nickname: "朕",
           userface: "http://dev2.pcauto.com.cn:9191/upchead/35/63/15/72/35631572_100x100",
           userId: 35631572
         },
       images: [
           "http://imgm.pconline.com.cn/images/upload/upc/tx/madmin/1510/28/c0/14573988_1446018972361.jpg"
       ],
       imagesSize: 1
    }
  }


后端应用接口：
车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.5
4.1.最新提问帖id列表 接口：/appapi/1/forum/listTopicsByForumId.do?forumId=

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.2.9 获取用户认证信息 接口 /appapi/1/forum/getAuthorsInfo [GET]
1.2.10 获取帖子的前三张图片及主题帖图片总数 接口 /appapi/1/forum/getTopicsImages [GET]


}}}

    协议参数说明:
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||
   ||userId||String||是||用户ID||
   ||sgId||String||是||车系id(不传版块id时通过车系id匹配版块)||
   ||forumId||String||是||板块id||
   ||orderby||String||是||选择最新贴时"postat"发布时间排序, 其它可以不传||
   ||pageSize||String||是||每页条数||
   ||pageNo||String||是||页码||
   ||pageSize||String||是||每页条数||


==== 2.8 最新提问列表 ====
{{{
接口：  /xsp/s/club/v4.5/listQuestionTopics.xsp?forumId=14674&sgId=443&pageNo=1&pageSize=10&userId=63145&orderby=
说明 : 车问答列表页最新提问列表

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

返回结果：
{
  code: 0,
  idList: [
   8757648,
   8757647,
   8757655,
   8757646,
   8757645,
   8757644,
   8757654,
   8757643,
   8757653,
   8757634
  ],
  message: "操作成功",
  pageCount: 23,
  pageNo: 1,
  pageSize: 10,
  total: 225,
  version: "v1.0(latest)",
  topicList: [
     {
       content: "",
       createAt: 1446437718000,
       fid: 298,
       forumName: "福克斯论坛",
       isPick: false,
       isRecommend: false,
       lastPostAt: 1446437718000,
       nickName: "xiechuyu",
       replyCount: 0,
       tid: 8757674,
       title: "",
       uid: 32010420,
       uri: "http://dev39.pcauto.com.cn/topic-8757674.html",
       userName: "xiechuyu",
       view: 1,
       floorId: 298,// 跟fid一样，只是为了跟车友圈字段名一样
       topicId: 8757674,// 跟tid一样，只是为了跟车友圈字段名一样
       userId: 32010420,// 跟uid一样，只是为了跟车友圈字段名一样
       author: {
           isVip: false,
           validBrandIcon: "",
           name: "qz35631572",
           nickname: "朕",
           userface: "http://dev2.pcauto.com.cn:9191/upchead/35/63/15/72/35631572_100x100",
           userId: 35631572
         },
       images: [
           "http://imgm.pconline.com.cn/images/upload/upc/tx/madmin/1510/28/c0/14573988_1446018972361.jpg"
       ],
       imagesSize: 1
    }
  }

后端应用接口：
车友会
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.5
4.1.最新提问帖id列表 接口：/appapi/1.0/topic/getNewestQuestionTopicIds.do
接口： /appapi/1/topic/getTopics.do?tids=

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.2
1.2.9 获取用户认证信息 接口 /appapi/1/forum/getAuthorsInfo [GET]
1.2.10 获取帖子的前三张图片及主题帖图片总数 接口 /appapi/1/forum/getTopicsImages [GET]

}}}
    协议参数说明:
   ||= 参数名 =||= 类型 =||= 必须 =||= 说明 =||
   ||pageNo||String||是||页码||
   ||pageSize||String||是||每页条数||

{{{
#!html
<div style="background-color: #dfdede; border-radius: 5px 0 0 5px; height: 35px; overflow: hidden; width: 30px; z-index: 9999; float: right; padding: 3px 0px 0px 2px; right: 0; top: 300px;position: fixed;">
  <a href="#a1.车友会提供的接口汇总"><em>返回<br>顶部</em></a>
</div>
}}}