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


需求原型：http://trac.pc.com.cn/mobile/pototype/pcauto-club/4.6.1/pre1/#p=1_1热门话题页改版

== 1. 车友会提供APP接口4.7 ==
   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 话题列表--最新 ====
最新100条数据，按照话题有logo优先，创建时间倒序排序

{{{
    接口：/appapi/1.0/subject/getNewestSubjects.do [GET]

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

    参数：
         pageNo:
         pageSize: 默认20条
         xssEncode: 是否过滤xss(0: 原内容；1：过滤，默认为1)
    {
        subjectList: [
            {
                subjectId：话题Id
                title：话题标题
                description： 话题导语
                logo：话题封面图
                replyCount: 讨论数
                pvCount: 阅读数

            }
        ]
       code:0成功，-1失败
       message:提示信息

       pageCount: 总页数,
       pageNo: 页码
       pageSize: 页码条数,
       total: 总数
    }

}}}

==== 1.2 话题列表--热门 ====

{{{
    接口：/appapi/2.0/subject/hotSubjectList.do [GET]

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

    参数：
         pageNo:
         pageSize: 默认20条
         xssEncode: 是否过滤xss(0: 原内容；1：过滤，默认为1)

    返回结果新增字段：
    {
        subjectList: [
            {
                replyCount: 讨论数
                pvCount: 阅读数
            }
            ....
        ]
    }

}}}


==== 1.3 话题头部 ====

{{{
    接口：/appapi/2.0/subject/getSubjectHead.do [GET]
   
    请求参数 ：
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）

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

    返回结果新增字段：
    {
        nickName:话题发起人昵称
    }

}}}

==== 1.4 话题置顶列表4.6.1 ====
备注：兼容4.6.1 过滤掉帖子
{{{
    接口：/appapi/1.0/subject/getSubjectTopList.do [GET]
    请求参数 ：
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）

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

    返回结果新增字段：
    {
        photoCount：图片数
        title:帖子标题
        topicId:帖子ID
        shareCount：分享数

    }

}}}

==== 1.5 话题详情动态列表4.6.1（最热） ====
备注：兼容4.6.1 过滤掉帖子
{{{
    接口：/appapi/1.0/subject/getDynaListHot.do [GET]

    请求参数 ：
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）
    pageNo:
    pageSize: 默认20条
    xssEncode: 是否过滤xss(0: 原内容；1：过滤，默认为1)


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

    返回结果新增字段：
    {
        photoCount：图片数
        title:帖子标题
        topicId:帖子ID
        shareCount：分享数

    }

}}}


==== 1.6 话题详情动态列表（最新）4.6.1 ====
备注：兼容4.6.1 过滤掉帖子
{{{
    接口：/appapi/1.0/subject/getDynaListNew.do [GET]
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）
    pageNo:
    pageSize: 默认20条
    xssEncode: 是否过滤xss(0: 原内容；1：过滤，默认为1)


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

    返回结果新增字段：
    {
        photoCount：图片数
        title:帖子标题
        topicId:帖子ID
        shareCount：分享数

    }

}}}


==== 1.7 根据话题标题获取话题ID ====

{{{
    接口：/subject/getSubjectByTitle.do [GET]

    参数：title话题标题（不带##）
    {
        subjectId;话题ID
        code:（0：正确；-1：错误）
        message:提示信息

    }

}}}

==== 1.8 话题置顶列表4.7 ====

{{{
    接口：/appapi/2.0/subject/getSubjectTopList.do [GET]
    请求参数 ：
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）

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

    返回结果新增字段：
    {
        photoCount：图片数
        title:帖子标题
        topicId:帖子ID
        shareCount：分享数

    }

}}}

==== 1.9 话题详情动态列表4.7（最热） ====
{{{
    接口：/appapi/2.0/subject/getDynaListHot.do [GET]

    请求参数 ：
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）
    pageNo:
    pageSize: 默认20条
    xssEncode: 是否过滤xss(0: 原内容；1：过滤，默认为1)


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

    返回结果新增字段：
    {
        photoCount：图片数
        title:帖子标题
        topicId:帖子ID
        shareCount：分享数

    }

}}}


==== 1.10 话题详情动态列表（最新）4.7 ====

{{{
    接口：/appapi/2.0/subject/getDynaListNew.do [GET]
    subjectId:话题ID（如果>0,则忽略title参数）
    title:话题标题（不带#）
    pageNo:
    pageSize: 默认20条
    xssEncode: 是否过滤xss(0: 原内容；1：过滤，默认为1)


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

    返回结果新增字段：
    {
        photoCount：图片数
        title:帖子标题
        topicId:帖子ID
        shareCount：分享数

    }

}}}

==== 1.11 接口修改 ====

{{{
    接口：/1.0/user/getUserPermission.do [GET]
    
    增加字段：
          userForum{
                     forumId:版块Id
                     forumName：版块名称
                     creatDate：创建时间
                     updateDate：更新时间
                    }

}}}

=== 2. 论坛接口

==== 2.1 发帖接口  ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/topic/create.ajax [POST]

    说明：车问答:
            用户自己选车系匹配/认证车系匹配/爱车匹配/地区匹配
          车友圈首页:
            用户自己选车系匹配/认证车系匹配/爱车匹配/地区匹配
          单个圈子：
            版块id做参数
          车友会：
            版块id做参数
          话题：
            开关打开时发到固定可配置的版块
            开关关闭时 认证车系匹配/爱车匹配/地区匹配 不会自选版块/车系

}}}

==== 2.2 我的主贴 ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/my/topicList.ajax [GET]
          uid:用户id
          pageNo:页号
          pageSize:分页大小
          xssEncode:是否过滤xss(0: 原内容；1：过滤，默认为1)

    返回结果字段：
    {
        tid:        帖子id
        title：     标题
        forumName:  板块名
        createAt:   发帖时间
        replyCount：回复数
        viewCount:  浏览数
    }

}}}

==== 2.3 我的回贴 ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/my/postList.ajax [GET]
          uid:用户id
          pageNo:页号
          pageSize:分页大小
          xssEncode:是否过滤xss(0: 原内容；1：过滤，默认为1)

    返回结果字段：
    {
        
        content：      内容
        quoteAuthor:   引用楼层作者:{uid,nickname}
        quoteId:       引用楼层id,主贴留0
        quoteTitle：   如果是回复主贴,该主贴的标题
        quoteContent:  如果是引用回复,引用楼层的内容
        postCreateAt:  回帖时间
    }

}}}

==== 2.4 我的默认发帖版块 ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/my/defaultForum.ajax [GET]
          uid:用户id

    说明：按认证车系匹配/爱车匹配/地区匹配的顺序,返回用户默认发帖版块
    {
        forumId：   版块id
        forumName:  版块名

    }

}}}

==== 2.5 修改车友圈版块页列表接口 ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/forum/listTopicsByForumId.ajax [GET]
          参数不变

    说明：添加版主版副信息
    [{
        uid：      用户id
        nickname:  昵称
    }]

}}}

==== 2.6 修改按id取用户接口 ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/forum/getAuthorsInfo.do [GET]
          参数不变

    新增字段：
        roleName: 用户角色，返回字符串，按 编辑>分站>版主>版副 判断好了直接给字符串，如果都不是则不返回或者返回空
        isExpert: true/false

}}}

==== 2.7 修改帖子详情页接口 ====

{{{
    接口：http://bbs.pcauto.com.cn/appapi/1/forum/topic.do [GET]
          参数不变

    每层结果里新增字段：
        authorRoleName: 作者用户角色，返回字符串，按 编辑>分站>版主>版副 判断好了直接给字符串，如果都不是则不返回或者返回空
        authorIsExpert: true/false

}}}


=== 3. 车友会接口

==== 3.1 获取用户粉丝数 ====

说明：这是一个BIP提供的接口，请参考http://trac.pc.com.cn/bip/wiki/focus 第14点