wiki:appapi/4.5

需求原型: http://trac.pc.com.cn/iphone/wiki/pcauto_club_4.5.0

1. 车友会提供APP接口4.5

PC端开发环境域名:dev18.pcauto.com.cn

WAP端开发环境域名:dev43.pcauto.com.cn:83/club

PC端线上环境域名:club.pcauto.com.cn

WAP端线上域名:m.pcauto.com.cn/club

1. 举报管理相关

1.1. 内容举报接口

接口:/appapi/1.0/report/addReport.do [POST]

请求参数:
    reporterId: 举报人id [long, not null]
    reporterNickname: 举报人昵称 [not null]
    targetUserId: 被举报人id [long]
    targetUserNickname: 被举报人昵称 
    targetId: 举报内容ID [long](如果是论坛帖子,这个id,传的是楼层的id)
    targetExtId: (简单做法:1、如果是相片,这个id,传的就是相片所对应相册的id;2、如果是论坛帖子,这个id,传的就是帖子id;3、其他类型,不需要传)
    targetUrl: 举报内容URL

    targetType: 举报类型(1:帖子;2:动态;3:话题;4:照片;5:活动;6:投票;7:WebView') [int, not null]
    content: 举报原因
    otherReson: 其他原因(举报原因和其他原因不能同时为空)[String, maxSize:100]
    reportContent:举报内容(即标题)[String, not null maxSize:35]


是否登录 :是
缓存时间 : 否
是否分页 : 否
    
返回结果:

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

2. 用户管理相关

2.1. 用户权限接口

原有接口:/1.0/user/getUserPermission.do

1、添加锁用户判断

2、添加用户爱车信息,最终返回结果:

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

    // 新增字段,如果用户被锁,没有该字段
    // 认证车主:取认证车型;否则取保存的车型信息;没有就为空
    carInfo: {
        isVip: 是否认证车主(0-否;1-是)

        // 出现脏数据或者有些旧数据,会没有下面这几个字段
        brandId: 品牌id
        brandName: 品牌名
        serialId: 车系id
        serialName: 车系名
    },

    // 保持原来字段不变,如果用户被锁,不用有该字段
    permissions: [
        
    ]
}

3.车系印象详情页

3.1.车系印象详情页

  接口:/impressApp-${id}.html
  是否分页:否
  是否缓存:否
  是否登录:是
  请求参数:
         ${id}: 车系Id[long, not null]
  返回: 无
  协议:
        pcautoclub://auto-ask-price/   :点击“询底价”、“置换”、“试驾”都跳到询价页,
        pcautoclub://bbs-topic/            :“必看帖子”里的帖子,点击要进入帖子终端页(即主题终端页),
        pcautoclub://bbs-topics/         :“必看帖子”最后的“查看更多”,点击进入该车系的圈子终端页,
        pcautoclub://bbs-topic/           :“车友问答”里的帖子,点击进入帖子终端页(即主题终端页),
        pcautoclub://user-center/       :“车友问答”里的用户昵称,点击进入该用户的个人中心,
        pcautoclub://user-center/        :“吐槽OR点赞”,点击头像或用户昵称都进入该用户的个人中心
        pcautoclub://bbs-topics-ask/圈子id :车提问
 
       
  

4.最新提问帖id列表

4.1.最新提问帖id列表

  接口:/appapi/1.0/topic/getNewestQuestionTopicIds.do

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

  请求参数:
      pageNo
      pageSize

  返回:

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

    pageCount: 11,
    pageNo: 3,
    pageSize: 20,
    total: 220,

    idList: [    
    ]
}
  

3. 论坛提供APP4.5接口

PC端开发环境域名:dev39.pcauto.com.cn

WAP端开发环境域名: http://dev43.pcauto.com.cn:83/bbs/

PC端线上环境域名:bbs.pcauto.com.cn

WAP端线上域名:m.pcauto.com.cn/bbs/

3.1. 删除帖子接口

接口:/appapi/1/post/delete.do [POST]

请求参数:
    topicId: 主题id [long, not null]
    postId: 帖子id [long, not null]

是否登录 :是
缓存时间 : 否
是否分页 : 否
    
返回结果:

{
    status:0成功,-1失败
    desc:提示信息
}

3.2. 恢复帖子接口

接口:/appapi/1/post/restore.do [POST]

请求参数:
    topicId: 主题id [long, not null]
    postId: 帖子id [long, not null]
    deleteAt: 删除时间(时间戳) [long, not null]

是否登录 :是
缓存时间 : 否
是否分页 : 否
    
返回结果:

{
    status:0成功,-1失败
    desc:提示信息
}

3.3 车问答发帖接口

接口/appapi/1/topic/create.ajax [POST]
说明 : 主题图片表
请求参数 :
        forumId:板块id
        sgId: 车系id(不传版块id时通过车系id匹配版块)
        type: (""/"question")发帖的种类(普通贴)/提问)
        appTitle:标题
        message:正文  必填
        messageImage:图片+图片描述
        agent: 6代表ios  7 代表android   必填

是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
   "Location":"http://localhost.pcauto.com.cn/bbs7/topic-7808773.html", 
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

3.4 设置最佳答案接口

接口/appapi/1/post/bestAnswer.do [POST]
说明 : 主题图片表
请求参数 :
        tid:   必填
        pid: 必填(被设置最佳答案的回帖)
        doNotOverride: 是否覆盖现有最佳答案(true/false,不传默认覆盖)

是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
   status:0,
   desc:  "操作成功"
}
{
   status:1,
   desc:  "操作失败"
}

3.5 全站最新提问帖列表接口

接口/appapi/1/question/newest.do [POST]
说明 : 主题图片表
请求参数 :
        pageNo:
        pageSize:
是否登录 : 是
缓存时间 : 无
是否分页 : 否


返回结果:
{
    "message": "操作成功",
    "pageNo": 1,
    "pageSize": 50,
    "topicList": [
           {
            "authorId": 826717,
            "content": "正文[表情]下一个呢[表情]后面就是上传的图片了\n\n\n\n",
            "createAt": 1431941116000,
            "dynaType": 4, 1为普通  4为提问帖
            "isPick": false,
            "isRecommend":false,
            "lastpostAt": 1431941116000,
            "replyCount": 0,
            "title": "普通贴",
            "topicId": 7808734,
            "uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
        },
   ]
   "total": 18048,
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}

3.6 提问帖列表

接口/appapi/1/forum/listTopicsByForumId.do [GET]
说明 : 按版块取提问帖列表 
请求参数 :
         forumId:板块id
         sgId: 车系id(不传版块id时通过车系id匹配版块)
         filter: question 提问帖
         orderby: 选择最新贴时"postat"发布时间排序, 其它可以不传
         pageNo:  页码
         pageSize:  页码大小

是否登录 : 否
缓存时间 : 无
是否分页 : 是


返回结果:
{
"forum": {
        "bbs": 19,
        "forumId": 14674,
        "name": "嘉年华论坛",
        "parentId": 298
    },
    "message": "操作成功",
    "pageNo": 1,
    "pageSize": 50,
    "topicList": [
           {
            "authorId": 826717,
            "content": "正文[表情]下一个呢[表情]后面就是上传的图片了\n\n\n\n",
            "createAt": 1431941116000,
            "dynaType": 4, 1为普通  4为提问帖
            "isPick": false,
            "isRecommend":false,
            "lastpostAt": 1431941116000,
            "replyCount": 0,
            "title": "普通贴",
            "topicId": 7808734,
            "uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
        },
   ]
   "total": 18048,
   code : 0成功,-1失败
   message : 提示信息
   version : 接口版本号如1.0,1.0(latest)表示最新版本
}