[[TOC]]
== 1.基本约定 ==
mrobot开发机代理：192.168.10.199 端口为 1080
[[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请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

}}}
==== 2.1.4 [=#point2.1.4 论坛帖子列表] ====
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

}}}
=== 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://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.2 [=#point2.2.2 我的帖子] ====
{{{
    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

}}}
==== 2.2.3 [=#point2.2.3 获取最新消息数] ====
{{{
    请求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)表示最新版本
             }

}}}