[[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请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

}}}
==== 2.1.3 [=#point2.1.3  精彩推荐帖子列表] ====
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/recommendList.xsp?userId=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:userId 必填
       
    返回结果:
    {
    data: [
        {
            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请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

}}}
=== 2.3 [=#point2.3 话题详情] ===
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

}}}
=== 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)表示最新版本
             }

}}}