[[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?pageNo=&pageSize=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
       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表示普通帖子
        }        
      ]
    }

}}}
==== 2.1.4 [=#point2.1.4 论坛帖子列表] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getTopicList.xsp?forumId=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数: forumId  (必填)
              pageNo （选填）
              pageSize（选填） 
              tagName(选填) 
    返回结果:
    {
    "code": 0,
    "message": "操作成功",
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "topicList": [
        {
            "createBy": 31457462,
            "createDate": 1435221397000,
            "forumId": 22486,
            "forumName": "科目一",
            "imageList": [],
            "isPick": 0,
            "postCount": 8,
            "praiseCount": 0,
            "tagName": "原创",
            "title": "学车1.2测试",
            "topicId": 7809290,
            "userName": "Crazydemon",
            "userId": "31457462",
            "nickName": "Crazydemon",
            "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/31/45/74/62/31457462_100x100"
        },
       
        {
            "createBy": 13128876,
            "createDate": 1435717316000,
            "forumId": 22486,
            "forumName": "科目一",
            "imageList": [],
            "isPick": 0,
            "postCount": 12,
            "praiseCount": 0,
            "tagName": "原创",
            "title": "测试bip接口",
            "topicId": 7809323,
            "userName": "3edc4rfv",
            "userId": "13128876",
            "nickName": "2222",
            "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/13/12/88/76/13128876_100x100"
        }
    ],
    "total": 2,
    "version": "v1.0(latest)",
    "topList": [
        {
            "isPick": true,
            "tag": "提问",
            "tid": 7809289,
            "title": "学车1.2－发提问帖修改版V1"
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809286,
            "title": "学车发帖测试V2"
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809273,
            "title": "学车1.2发帖"
        },
        {
            "isPick": false,
            "tag": "原创",
            "tid": 7809268,
            "title": "学车会同步科目一这个版块的帖子不V3"
        }
    ]
}
}}}
=== 2.2 [=#point2.1 我的圈子] ===
==== 2.2.1 [=#point2.2.1 回复我的] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/replyPraiseList.xsp?accountId=24998081&typeId=2043&pageNo=1&pageSize=20
    说明:回复我的列表
    HTTP请求方式:GET
    是否需要登录:是
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
          accountId：必填 用户id
          typeId: 必填 系统消息类型，(typeIds=2043,2045)可传多值，2043表示回复我的，2045表示回复帖子回复
          pageNo  可选    默认1
          pageSize  可选  默认20
    
    返回结果:
  {
    total: 1,
    pageNo: 1,
    pageCount: 1,
    pageSize: 5,
    data: [
        {
            status: 状态 1：正常状态，－1：删除状态,
            isPick: 是否精华,
            postContent: 回复内容,
            type: 帖子类型 1：普通帖子，2：提问帖子,
            createBy: 回复用户id,
            topicCreateBy: 帖子创建者id,
            title: 帖子标题,
            floor: 回复楼层,
            forumId: 板块id,
            tagName: 标签,
            userId: 回复用户id,
            topicId: 主帖id,
            replyId: 回复id,
            createDate: 回复时间,
            nickName: 回复用户昵称,
            userPhoto: 回复用户头像，
            postReplyId 被回复帖子回复id （回复帖子回复才有）
            postReplyCreateBy  被回复的帖子回复的创建者（回复帖子回复才有）
            postToMessage   被回复的帖子回复的内容（回复帖子回复才有）
        }
    ]
  }
}}}
==== 2.2.2 [=#point2.2.2  赞我的] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/replyPraiseList.xsp?accountId=24998081&typeId=2044&pageNo=1&pageSize=20
    说明:回复我的列表
    HTTP请求方式:GET
    是否需要登录:是
    返回格式:json
    缓存方式:无
    缓存时间:无
    请求参数:
          accountId：必填 用户id
          typeId: 必填 系统消息类型，2044表示赞我的，
          pageNo  可选    默认1
          pageSize  可选  默认20
    
    返回结果:
  {
    total: 1,
    pageNo: 1,
    pageCount: 1,
    pageSize: 5,
    data: [
       {
        topicCreateBy: 帖子创建者,
        praiseTime: 点赞时间,
        topicTitle: 帖子title,
        forumId: 板块id,
        status: 状态 1：正常状态，－1：删除状态,
        tagName: 标签,
        isPick: 是否精华,
        userId: 赞用户的id,
        topicId: 帖子id，
        nickName: 赞用户昵称,
        userPhoto: 赞用户头像
        }
     ]
   }
}}}
==== 2.2.3 [=#point2.2.3 我的帖子] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getMyTopicList.xsp?pageNo=&pageSize=
    说明 : 我的帖子/回帖列表
    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/s/auto/info/xueChe/getNewMessage.xsp?accountId=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:json
    缓存方式:对象缓存
    缓存时间:4小时
    请求参数:     
      accountId：必填  用户ID  
      
    返回结果:
     {
        replyCount: 0,    //回复我的未读数
        praiseCount: 0    //赞我的未读数
     }
}}}
==== 2.2.5 [=#point2.2.5 清空回复我的/赞我的新消息数] ====
（开发已完成，测试请连开发机代理）
{{{
    请求url:http://mrobot.pcauto.com.cn/xsp/x/bip.pcauto.com.cn/intf/sysnotice.jsp?act=readAll&siteId=2&typeIds=2043,2044
    HTTP请求方式:POST
    是否需要登录:是
    返回格式:json
    缓存方式:
    缓存时间:
    请求参数:     
      act: 必填 readAll表示修改所有消息状态为已读
      siteId: 必填 2表示汽车网
      typeIds: 必填 系统消息类型，可传多值，2043表示回复,2044表示点赞
      
    返回结果:
      {"code":-1,"message":"非法请求"} 必须post提交
      
      {"code":-1,"message":"缺少参数"} 未登录或者缺少siteId参数

      {"code":0}  操作成功
}}}
=== 2.3 [=#point2.3 话题详情] ===
（开发已完成，测试请连开发机代理）
{{{
    请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topicDetail.xsp?tid=
    HTTP请求方式:GET
    是否需要登录:否
    返回格式:HTML
    缓存方式:无
    缓存时间:无
    请求参数: 
     tid :帖子ID（必填）
     sessionId ：登录后拿到的session （选填）
    返回结果:HTML
    页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ 数据内容为
    {
    "title": "学车发帖测试V2",(标题)
    "url": "http://dev11.pcauto.com.cn/bbs7/topic-7809286.html",(分享URL)
    "firstPic": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg"(第一张图)
    }
    页面协议
    pcdrive://reply/floorId  (floorId)楼层id   回复楼层协议
    pcdrive://praise/tid   (tid) 帖子id  点赞协议
    pcdrive://big-photo?data={\"total\":" + total + ",\"currentIndex\":" + currentIndex + ",\"photos\":[" +photos+ "]}  (total)图片总数  (currentIndex)当前图片位置 (photos) 所有图片URL   点击图片协议
         
}}}
=== 2.4 [=#point2.4 成绩排行] ===
==== 2.4.1[=#point2.4.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)表示最新版本
             }

}}}
==== 2.4.2[=#point2.4.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)表示最新版本
             }

}}}
==== 2.4.3[=#point2.4.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)表示最新版本
             }

}}}