wiki:appapi/4.7

Version 15 (modified by huangchengwei, 10 years ago) (diff)

--

需求原型: 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.5 话题详情动态列表4.7(最热)

备注:兼容4.6.1 过滤掉帖子

    接口:/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.6 话题详情动态列表(最新)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:分享数

    }

2. 车友会接口

2.1 参与话题接口(即发帖)

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

    说明:当不传forumId或者forumId传0时,该帖子归属于哪个圈子交给接口判断

3. 车友会接口

3.1 获取用户粉丝数

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