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

需求原型：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)表示最新版本
}
}}}