[[TOC]] == 1.基本约定 == {{{ 接口通用参数 req_enc=utf-8 resp_enc=utf-8 common_session_id=xxxx 接口URL: 接口URL 必填参数：参数名=xxx(多种情况用括号解析) 非必填参数：参数名=xxx(多种情况用括号解析) 说明文档参数：添加某特定参数可以直接看接口文档 是否需要登录：是,否 返回格式：json,ssi,xml 缓存方式：接口缓存，对象缓存 缓存时间：缓存时间 返回结果：结果可能情况 }}} == 2.接口列表 == === 2.1 [=#point201 头像以及昵称修改]=== {{{ 修改昵称 接口URL:http://my.pcauto.com.cn/intf/syncNickName.jsp 必填参数： act:save nickName:昵称 提交方式：POST 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 返回结果：{"code":0}表示成功, {"code":非0,"message":"提示"} 修改头像 接口URL:http://upc.pcauto.com.cn/upload_head.jsp 必填参数: 二进制图片数据 提交方式：POST 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 返回结果： 成功：{retCode: 0} 失败：{retCode: xxx} }}} === 2.2 [=#point202 获取用户信息]=== {{{ 接口URL:http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo 参数: uid:用户ID,如果没有次参数则返回当前用户信息 提交方式：GET 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 返回结果： { "image":头像 "isVip":是否认证车主 "level":用户级别 "name":用户名 "nickname":用户昵称 "serialId":认证车系ID "serialName":认证车系名 "userId":用户ID "friends":关注好友数 "fans":粉丝数 } }}} === 2.3 [=#point203 验证码和发私信]=== {{{ 验证码接口 接口URL:http://captcha.pcauto.com.cn/captcha/v.jpg 无参数 返回一张验证码图片 发私信接口 接口URL: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.添加关键词库过滤 */ 提交方式：POST 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 结果返回 {code:0,message:"提示"} }}} === 2.4 [=#point204 我的论坛接口]=== {{{ 接口URL:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/{UID:用户ID} 参数 filter:post|pick(post:回帖,pick:精华贴),缺省参数为主贴 pageNo=页码 pageSize=一页条数，默认20，最大500 提交方式：POST 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 结果返回: { "total":18, "pageNo":1, "pageSize":20, "topicList":[ { "flag":"图",//主贴标识 "forumName":"北京分会",//论坛名字 "replyCount":70,//主贴回复数 "title":"妞开妞车---和我的小七一起臭美一下",//主贴标题 "topicId":3840024,//主贴ID "updateAt":1382084688000,更新时间 "view":43267//主贴阅读数 "content":"{顶}{顶}{顶}",//回帖内容(filter:post) "topicAuthorId":"28087017",//主贴作者ID(filter:post) "topicAuthorNickName":"北京大妞儿",//主贴作者昵称(filter:post) } ] } }}} === 2.5 [=#point205 我的收藏夹论坛列表]=== {{{ 接口URL:http://bbs.pcauto.com.cn/intf/user/_favForums.jsp 必填参数: userId:用户ID 提交方式：POST 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 结果返回: { "listCount":2, "list":[ { "banzhuList":[ { "userId":25508566, "userName":"牛仔bu忙", "userNickName":"牛仔", "userUrl":"http://my.pcauto.com.cn/25508566" } ], "favoriteId":134760, "forumIcon":"", "forumId":18976, "name":"最汽车主版", "url":"http://bbs.pcauto.com.cn/forum-18976.html" } ] } }}} === 2.6 [=#point206 获取用户评论列表]=== {{{ 接口URL:http://mrobot.pcauto.com.cn/v3/cmt/userCmtList/{UID} 必填参数： UID:用户ID webSite:pcauto 提交方式：GET 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 结果返回: { "total":18, "uid":8749870, "status":0, "pageNo":1, "pageSize":20, "data":[ { "content":"烂马6", "id":26631960, "articleId":3819521, "createTime":1391850176000, "topicTitle":"最高降幅5.4万 10款主流B级车迎新春促销", "topicUrl":"http://www.pcauto.com.cn/qcbj/381/3819521.html", "floor":58, "status":2, "nickname":"小星星", "replyRef":{ "content":"认了他就老老实实喊教练，要不当初你就不要让他教。发这种言论，你俩不愧是狗教的", "uid":0, "id":26269691, "createTime":1384150537000, "floor":21, "status":2, "nickname":"浙江省嘉兴市网友", "replyRef":{ }, "ip":"192.168.239.90-115.230.213.159" }, "topicId":13107080, "url":"http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13107080.html", "ip":"192.168.239.108-14.23.114.34" } ] } }}} === 2.7 [=#point207 获取用户的好友列表]=== {{{ 返回包括关注的好友和粉丝 接口URL:http://my.pcauto.com.cn/intf/app/focus.jsp 参数: accountId=用户ID,如果没有改参数的话则返回当前用户的好友列表 act=findFocus为关注,findFocusBy为粉丝 pageNo=页码 pageSize=页长度 提交方式：GET 是否需要登录：是 返回格式：json 缓存方式：无 缓存时间：无 返回 { "total":18, "pageCount":2, "pageNo":1, "pageSize":20, "resultList":[ { "accountId":用户ID "focusNum":关注好友数 "fanNum":粉丝数 "nickName":用户昵称 "image":头像 } ] } }}} === 2.8 [=#point208 收到的私信列表]=== {{{ 接口URL: http://mrobot.pcauto.com.cn/v3/bbs/getMessageList 必填参数： type=1 siteId=网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网） status=-1(-1为已读和未读，0表示未读，1表示已读) 非必要参数： pageNo=页码 pageSize=一页条数，默认20，最大500 是否需要登录：是 返回格式：json 支持跨域：是 支持回调：是 缓存方式：无 缓存时间：无 返回结果： { total: 总的条数 pageNo: 页码 pageCount: 页数 pageSize: 每页条数 resultList:{ id: 消息ID content: 消息内容 createTime: 发送时间 status: 阅读状态 accountId: 用户ID senderId: 发送者ID receiverNickname:发送者昵称 receiverFace:头像 replyId: 回复ID showStatus: 显示状态 } } }}} === 2.9 [=#point209 发出的私信列表]=== {{{ 接口URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList 必填参数： type=0 siteId=网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网） status=-1(-1为已读和未读，0表示未读，1表示已读) 非必要参数： pageNo=页码 pageSize=一页条数，默认20，最大500 是否需要登录：是 返回格式：json 支持跨域：是 支持回调：是 缓存方式：无 缓存时间：无 返回结果： { total: 总的条数 pageNo: 页码 pageCount: 页数 pageSize: 每页条数 resultList:{ id: 消息ID content: 消息内容 createTime: 发送时间 accountId: 用户ID receiverIds: 发送者ID receiverId: 发送者ID receiverNickname:发送者昵称 userhead:头像 } } }}} === 2.10 [=#point210 获取系统消息接口]=== {{{ 接口URL:http://bip.pcauto.com.cn/intf/sysnotice.jsp 必填参数： act=find siteId=网站ID（1是电脑网，2是汽车网，3是游戏网，4是女性网，5是亲子网，6是家居网） status=-1(-1为已读和未读，0表示未读，1表示已读) 非必要参数： typeIds=消息分类，开发人员提供 groupType=消息分组，默认全部，开发人员提供 status=0是未读，1是已读，默认-1是全部 startDate=开始时间 endDate=结束时间 beforeDay=在某个时间前 pageNo=页码 pageSize=一页条数，默认20，最大500 noTemplate=true不需要模板，false需要模板，默认是false 是否需要登录：是 返回格式：json 支持跨域：是 支持回调：是 缓存方式：无 缓存时间：无 返回结果： { total: 总的条数 pageNo: 页码 pageCount: 页数 pageSize: 每页条数 resultList:{ id: 消息ID type: { //消息类型 name: 消息类型名称 id: 消息分类ID description: 描述 siteId: 网站ID templateId: 模板ID groupType: 分组ID } content: 模板内容 createTime: 发送消息时间戳 status: 状态 accountId: 接收消息人 siteId: 网站ID typeId: 分类ID senderId: 发送者ID groupSend: 是否群发 groupType: 消息分组 resultText: 操作结果 } }}} === 2.11 [=#point211 收集推送token接口]=== {{{ token数据放在passport2,赖子粼负责 接口URL:http://dev1.pcauto.com.cn/passport2/api/mobilePushInfo.jsp 必填参数： act=addMobilePushInfo deviceType=iOS//设备类型 token=xxx//推送token 是否需要登录：是 返回格式：json 支持跨域：是 支持回调：是 缓存方式：无 缓存时间：无 返回 {"code":0,"message":"数据已经插入"} 接口是否已经完善:测试环境 }}} === ~~2.12 [=#point212 获取他人信息接口]~~ === {{{ 参照2.2 }}} === 2.13 [=#point213 获取他人最新动态接口]=== {{{ 接口URL:http://mrobot.pcauto.com.cn/v3/bbs/newsfeed/{UID}|{?night} 参数: UID:用户ID ?night:夜间模式 返回: html页面 }}} === ~~2.14 [=#point214 获取他人帖子列表]~~ === {{{ 参照2.4 }}} === ~~2.15 [=#point215 获取他人评论列表]~~ === {{{ 参照2.6 }}} === 2.16 [=#point216 获取爱车列表]=== {{{ 接口URL:http://my.pcauto.com.cn/intf/getCars.jsp 参数 act{ =getCars 获取该用户所有爱车； =getCarSeries获取该用户的添加的车型； =getCarModels获取该用户的添加的车系； } accountId = (不传此参数，将获取登录ID，)； pageNo = (次参数不传，则为默认为1，即第一页); pageSize = (次参数不传，则为默认为20，最小为1，最大为100); callback = (回调函数) 返回值： 失败:{"code":-1,"message":""} 成功:{ "total":5, "pageNo":1, "pageCount":1, "pageSize":20, "resultList":[ "createTime":"2013-11-28 08:24:21", "accountId":8749870, "carSeriesId":4580, "carModelId":0, "updateTime":"2013-11-28 08:24:21", "carPic":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/17/c2/28719139_1384678383261_270x202.jpg", "brandId":932, "buyPlaceId":0, "id":270094, "driveStatus":0, "buyPlace":null, "name":"残缺的F5", "brand":" 长城汽车 ", "carSeriesName":"哈弗H6" ] } 注意： 用户须登录； 调用接口时需把common_session_id传过来； 因为act=getCars是旧接口，不能改动，所以没有做任何改变，没有分页，act=getCarSeries, act=getCarModels是新接口，可传分页参数，新旧接口返回json结构不一样。 }}} === ~~2.17 [=#point217 获取他人好友列表] ~~=== {{{ 参照2.7 }}} === 2.18 [=#point218 关注&取消关注]=== {{{ 接口URL:http://m.pcauto.com.cn/bip/intf/focus.jsp 必填参数: act=add|delete(add:关注,delete:取消关注) accountId=xxxxxx 当前用户ID friendId=xxxxxx 关注用户ID 是否需要登录：是 返回格式：json 支持跨域：是 支持回调：是 缓存方式：无 缓存时间：无 返回: {"code":0}成功 判断与某用户的关系 act=isHisFocus accountId=xxxxxx 当前用户ID friendId=xxxxxx 关注用户ID 返回:0:没关注,1:关注,2:被关注,3:相互关注 }}} === 2.19 [=#point219 精准选车-车系列表接口]=== {{{ 接口URL:http://mrobot.pcauto.com.cn/v2/price/models/search 必填参数: queryJson:查询条件 type=1 是否需要登录：否 返回格式：json 支持跨域：是 支持回调：是 缓存方式：无 缓存时间：无 返回结果: { "data":[ { "displacement":"1.3", "gearbox":"5档手动", "horsePower":"88", "id":"24000", "kind":"中型SUV", "lowestPrice":"4.78万", "photo":"", "price":"47800", "serialId":"4207", "serialName":"野马F99", "size":"4510x1720x1630", "title":"野马F99 2012款 1.3L 两驱 手动基本型" } ], "pageCount":1, "pageNo":1, "pageSize":1000, "total":347 } }}}