wiki:pcauto_drive_1.2.0/interface

Version 14 (modified by liguokai, 11 years ago) (diff)

--

1.基本约定

mrobot开发机代理:192.168.10.199 端口为 1080
mrobot测试机代理:192.168.10.198 端口为 1080

2.接口列表

2.1 圈子广场

2.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 圈子入口用户数及头像

    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

2.1.3 精彩推荐帖子列表

    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

2.1.4 论坛帖子列表

    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

2.2 我的圈子

2.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 我的帖子

    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

2.2.3 获取最新消息数

    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

2.3 话题详情

    请求url:
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
    无
    
    返回结果:

3.1 成绩排行

3.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本周成绩排行榜列表

(开发已完成,测试请连开发机代理)

    请求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总排行榜列表

(开发已完成,测试请连开发机代理)

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