[[TOC]]
== 1.基本约定 ==
[[BR]]mrobot开发机代理：192.168.10.199 端口为 1080
[[BR]]mrobot开发机域名：dev40.pcauto.com.cn       '''(warning：使用此域名或会导致某些html内嵌js请求产生跨域问题，不建议使用）'''
[[BR]]mrobot测试机代理：192.168.10.198 端口为 1080

== 2.接口列表 ==

=== 2.1 [=#point2.1 圈子广场] ===
==== 2.1.1 [=#point2.1.1 圈子广场栏目信息] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/x/dev11.pcauto.com.cn/bbs7/xcappapi/1/forum/findForums.ajax
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:
  {
    "desc": "sucess",
    "forumList": [
        {
            "forumId": 22686,
            "forumName": "学前交流",
            "tags": "原创,转载,讨论,提问,召集,公告"
        },
        {
            "forumId": 22615,
            "forumName": "挂科吐槽",
            "tags": "原创,转载,讨论,提问,召集,公告"
        }
    ],
    "status": 0,
    "version": "v1.0(latest)"
}

}}}
==== 2.1.2 [=#point2.1.2 圈子入口用户数及头像] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/authImg.xsp
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:
    {
    subject1: {
        total: 250,
        images: [
            "http://i6.3conline.com/images/upload/upc/face/30/22/93/51/30229351_120x120",
            "http://i6.3conline.com/images/upload/upc/face/34/55/13/62/34551362_120x120",
            "http://i6.3conline.com/images/upload/upc/face/34/55/13/62/34551362_120x120"
        ]
    },
    subject2: {
        total: 500,
        images: [
            "http://i6.3conline.com/images/upload/upc/face/30/22/93/52/30229352_120x120",
            "http://i6.3conline.com/images/upload/upc/face/30/22/93/81/30229381_120x120",
            "http://i6.3conline.com/images/upload/upc/face/30/22/93/84/30229384_120x120"
        ]
    },
    subject3: {
        total: 750,
        images: [
            "http://i6.3conline.com/images/upload/upc/face/24/99/80/81/24998081_120x120",
            "http://i6.3conline.com/images/upload/upc/face/33/41/39/08/33413908_120x120",
            "http://i6.3conline.com/images/upload/upc/face/30/22/93/84/30229384_120x120"
        ]
    },
    subject4: {
        total: 1000,
        images: [
            "http://i6.3conline.com/images/upload/upc/face/82/67/17/826717_120x120",
            "http://i6.3conline.com/images/upload/upc/face/34/76/82/00/34768200_120x120",
            "http://i6.3conline.com/images/upload/upc/face/34/55/13/62/34551362_120x120"
        ]
    }
    }

    注意：数据从mrobot后台录入，配置名称为：pcauto_xueche_authimg
}}}
==== 2.1.3 [=#point2.1.3  精彩推荐帖子列表] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/recommendList.xsp?userId=&pageNo=&pageSize=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
       userId 可选 用于获取用户是否点赞
       pageNo 可选 默认为1
       pageSize 可选 默认为20
    返回结果:
    {
    total:
    pageNo:
    pageSize:
    topicList: [
        {
            title: 标题
            picUrl: 图片
            to_uri: 跳转协议（若是论坛贴子则返回pcautobrowser://bbs-topic/）
            seq: 序号
            isRecommend:1  是否推荐，1表示推荐帖子
        },
        {
            authorPhoto: 作者头像
            createBy: 作者id
            createDate: 帖子发布时间（时间戳）
            forumId: 版块ID
            forumName: 版块名字
            imageList: [
               url:图片
               width:宽
               height:高
               qua:选题参数
            ],
            isPick: 是否精华（0：非,1:是）
            nickName: 作者昵称
            postCount: 评论数
            praiseCount: 赞数
            title: 帖子标题
            topicId: 帖子id
            to_uri: 跳转协议（若是论坛贴子则返回pcautobrowser://bbs-topic/）
            isRecommend:0 是否推荐，0表示普通帖子
            isPraise: 是否点赞
        }        
      ]
    }

}}}
==== 2.1.4 [=#point2.1.4 论坛帖子列表] ====
{{{
    请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/xueChe/getTopicList.xsp?forumId=&userId=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: forumId  (必填)
              pageNo （选填）
              pageSize（选填） 
              tagName(选填) 
              userId (必填)
    返回结果:
    {
    "code": 0,
    "message": "操作成功",
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "topicList": [
        {
            "createBy": 826717,
            "createDate": 1435206506000,
            "forumId": 22486,
            "forumName": "科目一",
            "imageList": [
                {
                    "height": 200,
                    "qua": 0,
                    "url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg",
                    "width": 200
                },
                {
                    "height": 200,
                    "qua": 0,
                    "url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg",
                    "width": 200
                },
                {
                    "height": 29,
                    "qua": 0,
                    "url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/08/c0/17556_1433756675100_1024x1024.jpg",
                    "width": 38
                },
                {
                    "height": 200,
                    "qua": 0,
                    "url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg",
                    "width": 200
                },
                {
                    "height": 29,
                    "qua": 0,
                    "url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/08/c0/17546_1433753457103_1024x1024.jpg",
                    "width": 38
                },
                {
                    "height": 29,
                    "qua": 0,
                    "url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/08/c0/17552_1433756601180_1024x1024.jpg",
                    "width": 38
                }
            ],
            "isPick": 0,
            "nickName": "fit10",
            "postCount": 0,
            "praiseCount": 0,
            "title": "学车1.2发帖",
            "topicId": 7809273,
            "isPraise": 0,
            "userName": "测试注册2",
            "userId": "129",
            "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/12/9/129_100x100"
        },
       
    ],
    "total": 4,
    "version": "v1.0(latest)"
}

}}}
=== 2.2 [=#point2.2 我的圈子] ===
==== 2.2.1 [=#point2.2.1  回复我的] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/listReplyToMe.do?userId=&sessionId=&pageNo=&pageSize= 
    说明:回复我的列表
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
       userId：必填 
       pageNo:选填
       pageSize:选填
       sessionId 必填 登录后拿到的session    
    
    返回结果:
    {"code":-1,"message":"登录后才能操作！"} 
    {"code":-1,"message":"参数错误"}
    {
          “data” : [
           {
            回复id,
            回复用户id,
            回复用户昵称,
            回复用户头像,
            回复时间,
            主帖id,
            主帖标题,
            标签
            是否精华
            回复内容
           }
           ]	
          “total”:
          “pageSize”:
          “pageNo”:
     }
}}}
==== 2.2.2 [=#point2.2.2  赞我的] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/listPraiseToMe.do?userId=&sessionId=&pageNo=&pageSize=
    说明：赞我的列表
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
       userId：必填 
       pageNo:选填
       pageSize:选填
       sessionId 必填 登录后拿到的session    
    
    返回结果:
    {"code":-1,"message":"登录后才能操作！"} 
    {"code":-1,"message":"参数错误"}
    {
          “data” : [
           {
            回复id,
            回复用户id,
            回复用户昵称,
            回复用户头像,
            回复时间,
            主帖id,
            主帖标题,
            标签
            是否精华
            回复内容
           }
           ]	
          “total”:
          “pageSize”:
          “pageNo”:
     }
}}}
==== 2.2.3 [=#point2.2.3 我的帖子] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/getMyTopicList.do
    说明 : 我的帖子/回帖列表
    HTTP请求方式:GET
    是否需要登录:是
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    pageNo：页数
    pageSize：每页条数
    
    返回结果:
             {
                   userId:用户ID
                   authorPhoto:用户头像
                   nickName:昵称
                   topicList:[{
                       type:主贴/回帖（1：主帖子；2：回帖）
                       topicId:帖子ID
                       title:帖子标题
                       content:内容
                       isTopicDelete:主帖是否删除（-1：是；1：否）
                       createDate:发布时间（时间戳）
                       isPick:是否精华（0：非,1:是）
                       tagName:标签名称
                       praiseCount:赞数
                       postCount:评论数
                       topicCreateBy:帖子发布者ID（回帖时）
                       topicNickname:帖子发布者昵称（回帖时）
          
                       imageSize:图片数量
                       imageList:[
                          {
                            url:图片
                            width:宽
                            height:高
                            qua:选题参数
       
                          },
                          {
                            url:图片
                            width:宽
                            height:高
                            qua:选题参数
       
                          }
                       ]
                    }]

                total:总条数
                pageNo:页码
                pageSize:每页条数
                pageCount:总共几页
             
                code : 0成功，-1失败，-2未登录
                message : 提示信息
                version : 接口版本号如1.0，1.0（latest)表示最新版本
             }

}}}
==== 2.2.4 [=#point2.2.4 获取最新回复数] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/x/bip.pcauto.com.cn/intf/sysnotice.jsp?act=getNum&accountId=&siteId=2&status=0&typeIds=2043,2044
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json或者数字返回
    缓存方式:对象缓存
    缓存时间:4小时
    请求参数:
    必填参数：
      act：getNum
      accountId：用户ID
      siteId：网站ID，2为汽车网
    非必填参数：
      status：0是未读，1是已读，-1是全部，默认是0
      typeIds：消息分类ID，2043表示学车宝典帖子回复,2044表示学车宝典帖子点赞

    
    返回结果:
      {"code":-1, "message":"缺少参数"}  缺少用户ID或者siteId参数
      {
	回复我的未读数
	赞我的未读数
      }
}}}
=== 2.3 [=#point2.3 话题详情] ===
{{{
    请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/xueChe/topicDetail.xsp?tid=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:HTML
    缓存方式:无
    缓存时间:无
    请求参数: 
     tid :帖子ID（必填）
     sessionId ：登录后拿到的session （选填）
    返回结果:HTML

}}}
=== 3.1 [=#point3.1 成绩排行] ===
==== 3.1.1[=#point3.1.1 今日成绩排行榜列表] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListToday.do
    说明 : 今日成绩排行榜
    HTTP请求方式:GET
    是否需要登录:(登陆后有个人数据，不登陆就是默认数据）
    是否分页：是
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数 ：subjectId:科目ID（必填）
    
    返回结果:
             {
   
                myRank://我在今日排行榜的排名
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      rank:我的排名
                      score:分数
                    }

                rankList:[//今日排行榜
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      score:分数
                    },
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      score:分数
                    }
                ] 

                total:总条数
                pageNo:页码
                pageSize:每页条数
                pageCount:总共几页

                code : 0成功，-1失败，-2未登录
                message : 提示信息
                version : 接口版本号如1.0，1.0（latest)表示最新版本
             }

}}}
==== 3.1.2[=#point3.1.2 本周成绩排行榜列表] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListWeek.do
    说明 : 本周成绩排行榜
    HTTP请求方式:GET
    是否需要登录:(登陆后有个人数据，不登陆就是默认数据）
    是否分页：是
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数 ：subjectId:科目ID（必填）
    
    返回结果:
             {
   
                myRank://我在本周排行榜的排名
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      rank:我的排名
                      score:分数
                    }
 
                rankList:[//本周排行榜
                   {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      score:分数
                    },
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      score:分数
                    }
                ] 

                total:总条数
                pageNo:页码
                pageSize:每页条数
                pageCount:总共几页

                code : 0成功，-1失败，-2未登录
                message : 提示信息
                version : 接口版本号如1.0，1.0（latest)表示最新版本
             }

}}}
==== 3.1.3[=#point3.1.3 总排行榜列表] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankList.do
    说明 : 成绩排行总榜
    HTTP请求方式:GET
    是否需要登录:(登陆后有个人数据，不登陆就是默认数据）
    是否分页：是
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数 ：subjectId:科目ID（必填）
    
    返回结果:
             {
   
                myRank://我在总排行榜的排名
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      rank:我的排名
                      score:分数
                    }

                rankList:[//总排行榜
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      score:分数
                    },
                    {
                      userId:用户ID
                      nickName:用户昵称 
                      authorPhoto:用户头像
                      completeTime:完成答题时间（秒）
                      score:分数
                    }
                ] 

                total:总条数
                pageNo:页码
                pageSize:每页条数
                pageCount:总共几页

                code : 0成功，-1失败，-2未登录
                message : 提示信息
                version : 接口版本号如1.0，1.0（latest)表示最新版本
             }

}}}