wiki:appapi/4.7
Last modified 10 years ago

接口索引

    1. 1. 车友会提供APP接口4.7
      1. 1. 车友会接口
        1. 1.1 话题列表--最新
        2. 1.2 话题列表--热门
        3. 1.3 话题头部
        4. 1.4 话题置顶列表4.6.1
        5. 1.5 话题详情动态列表4.6.1（最热）
        6. 1.6 话题详情动态列表（最新）4.6.1
        7. 1.7 根据话题标题获取话题ID
        8. 1.8 话题置顶列表4.7
        9. 1.9 话题详情动态列表4.7（最热）
        10. 1.10 话题详情动态列表（最新）4.7
        11. 1.11 接口修改
      2. 2. 论坛接口
        1. 2.1 发帖接口
        2. 2.2 我的主贴
        3. 2.3 我的回贴
        4. 2.4 我的默认发帖版块
        5. 2.5 修改车友圈版块页列表接口
        6. 2.6 修改按id取用户接口
        7. 2.7 修改帖子详情页接口
        8. 2.8 取发帖绑定手机开关状态
        9. 2.9 回帖接口
      3. 3. 车友会接口
        1. 3.1 获取用户粉丝数

需求原型： 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做参数
     参数:
          fid/forumId:版块id
          sgId:如果没有fid,用来匹配版块的车系id
          type:帖子类型
          appTitle:标题
          message:正文
          messageImage:图片加文字
          agent:发帖端标识
     返回:
          status:状态
          desc:描述

    话题发帖接口：http://bbs.pcauto.com.cn/intf/topic/create.ajax [POST]

    说明：
          话题：
            开关打开时发到固定可配置的版块
            开关关闭时 认证车系匹配/爱车匹配/地区匹配 不会自选版块/车系
    参数:
          postToSubjectForum:是否发到固定话题版块
          fid/forumId:如果postToSubjectForum关闭,发到的版块id
          sgId:如果没有fid,用来匹配版块的车系id
          type:帖子类型
          appTitle:标题
          message:正文
          messageImage:图片加文字
          agent:发帖端标识
    返回:
          status:状态
          desc:描述

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)

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

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

2.8 取发帖绑定手机开关状态

    接口：http://bbs.pcauto.com.cn/appapi/1/switchStatus.do[GET]

    返回结果字段：
    {
        pc:           pc/wap接口开关
        app:          资讯app接口开关
        clubapp：     车友会app接口开关
        xcapp:        学车app接口开关
        pc_reply:           pc/wap回帖接口开关
        app_reply:          资讯app回帖接口开关
        clubapp_reply：     车友会app回帖接口开关
        xcapp_reply:        学车app回帖接口开关
    }

2.9 回帖接口

    接口：http://bbs.pcauto.com.cn/appapi/1/post/create.do [POST]

    从http://bbs.pcauto.com.cn/rest/topics/独立出来,参数返回不变

3. 车友会接口

3.1 获取用户粉丝数

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