wiki:pcauto_4.2.0/interface

1.基本约定

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数:参数名=xxx(多种情况用括号解析)
非必填参数:参数名=xxx(多种情况用括号解析)
说明文档参数:添加某特定参数可以直接看接口文档
是否需要登录:是,否
返回格式:json,ssi,xml
缓存方式:接口缓存,对象缓存
缓存时间:缓存时间
返回结果:结果可能情况

2.接口列表

2.1 头像以及昵称修改

修改昵称
接口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 获取用户信息

接口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 验证码和发私信

验证码接口
接口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 我的论坛接口

接口URL:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/{UID:用户ID}

参数
filter:post|pick(post:回帖,pick:精华贴),缺省参数为主贴
pageNo=页码
pageSize=一页条数,默认20,最大500
maxLength=50内容截取长度

提交方式: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 我的收藏夹论坛列表

接口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 获取用户评论列表

接口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 获取用户的好友列表

返回包括关注的好友和粉丝
接口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 收到的私信列表

接口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 发出的私信列表

接口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 获取系统消息接口&清零系统消息

获取系统消息
接口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=2004

非必要参数:
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: 操作结果
}

清零系统消息
接口URL:http://mrobot.pcauto.com.cn/v3/bbs/setNewMsgState

参数:
messageType=1
typeIds=2004

提交方式:POST

2.11 收集推送token接口

token数据放在passport2,赖子粼负责
接口URL:http://passport2.pconline.com.cn/passport2/api/mobilePushInfo.jsp

必填参数:
act=addMobilePushInfo
deviceType=1//设备类型,1:iOS,2:android
token=xxx//推送token

提交方式:POST
是否需要登录:是
返回格式:json 
支持跨域:是
支持回调:是
缓存方式:无
缓存时间:无

返回
{"code":0,"message":"数据已经插入"}

接口是否已经完善:测试环境

2.12 获取他人信息接口

参照2.2

2.13 获取他人最新动态接口

接口URL:http://mrobot.pcauto.com.cn/v3/bbs/newsfeed/{UID}|{?night}

参数:
UID:用户ID
?night:夜间模式

返回:
html页面

2.14 获取他人帖子列表

参照2.4

2.15 获取他人评论列表

参照2.6

2.16 获取爱车列表

接口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":""}
成功:[
    { 
        "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 获取他人好友列表

参照2.7

2.18 关注&取消关注

接口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 精准选车-车系列表接口

接口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
}

2.20 车型库-品牌列表

接口URL:http://mrobot.pcauto.com.cn/v2/price/brands

请求方式:get
是否需要登录:否
请求参数:无

2.21 车系图片列表-部分

接口URL:http://mrobot.pcauto.com.cn/v2/price/pictures
请求方式:get
是否需要登录:否
 
请求参数:
     serialGroupId:车系id
     fmt:返回格式
     typeId:部件,1为外观,2为内饰,3为其他细节,4为官方图

2.22 推荐图集

 备注:滚动到图集最后一张图后显示推荐图集,使用范围:汽车网app
 请求URL:http://mrobot.pcauto.com.cn/v2/photo/recommendAlbums
 
 HTTP请求方式:get
 是否需要登录:否
 返回格式:json
 缓存方式:无
 缓存时间:无
 请求参数:无返回参数:
 
 [
    {
       "id":130583,  // 图集id
       "image":"http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",  // 图集封面图,尺寸待定
       "photoCount":"10",//图片数
       "title":"图集标题"
   }
 ]