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


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

== 1. 车友会提供APP接口4.6.1 ==
   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/2.0/club/getRecommendClubs.do [GET]、
    备注：比1.0版本多了theme、area、introduce字段
    参数：
      provinceId：必须填
      cityId：
      pageNo：页码 不填默认是1
      pageSize：每页的条数  不填默认是20
     
     是否登录:否
     缓存时间:3600s
     是否分页:是
    {
        recommendClubs: [
            {    
                clubId:XXX //车友会Id
                level：XXX //车友会等级
                logo: XXX  //车友会LOGO
                memberNum：XXX //车友会人数
                name ：XXX  //车友会名称
                seriesName：XXX //车系名称 
                theme: XXX //车友会主题
                area:XXX //地区 
                introduce：XXX //车友会简介

            }
            ....
        ]
       total:总条数
       pageNo:页码
       pageSize:每页条数
       pageCount:总共几页
       code:0成功，-1失败
       message:提示信息

    }

}}}

==== 1.2 申请中车友会列表 ====

{{{
    接口：/appapi/2.0/club/getApplyClubs.do [GET]
    备注：比1.0版本多了theme、area、introduce字段
      
     是否登录:是
     缓存时间:否
     是否分页:否
    返回结果新增字段：
    {
        applyClubs: [
            {
                clubId:XXX //车友会Id
                level：XXX //车友会等级
                logo: XXX  //车友会LOGO
                memberNum：XXX //车友会人数
                name ：XXX  //车友会名称
                seriesName：XXX //车系名称 
                theme: XXX //车友会主题
                area:XXX //地区 
                introduce：XXX //车友会简介
            }
        ]
       code:0成功，-1失败
       message:提示信息


    }

}}}

==== 1.3 话题列表--本周最新 ====

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

    {
      原来的字段没变，增加按照图片的排序，有图片的先排
    }

}}}

=== 2. 新增接口

==== 2.1 话题列表--最新 ====
最新100条数据，按照有图优先，创建时间倒序排序
{{{
    接口：/appapi/1.0/subject/getNewestSubjects.do [GET]

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

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

    返回字段：
    {
      code：状态码
      message: 提示

      subjectList: [
          {
              description: 描述
              logo: 图片
              subjectId: 话题id
              title: 标题
          }
      ],
      pageNo: 
      pageSize: 
      pageCount:
      total:
    }

}}}