[[TOC]]

= 摩登学院1.0.0接口文档 =
>mrobot代理环境说明： 
     192.168.10.198：1080(192.168.74.80)[[BR]] 
     192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] 
     ps1:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能） [[BR]] 
     ps2:common_session_id都是在cookies中添加此参数，测试环境为common_session_id1 [[BR]]

     [http://192.168.33.102/CAT/index.html "框架"][[BR]]
     [http://192.168.50.171/2015/2015-12-02/index.html "设计稿地址"][[BR]]
     [http://rdtrac.pc.com.cn/iphone/wiki/pclady_modern1.0.0终端协议 "终端协议"][[BR]]

==  1.公用接口 ==
----------

=== 1.1新增用户 ===

开发环境：http://dev15.pclady.com.cn/app/addUser.jsp  [[BR]]
线上环境：http://modern.pclady.com.cn/app/addUser.jsp [[BR]]

**说明**

>初次登录后，通知平台添加用户

**缓存时间**

>0

**提交方式**

>POST

**是否需要登录**

>是

**数据来源**

> passport

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||

**返回**

{{{#!java
{
  status:0,
  msg:”请求成功”
}

}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||
||= status =||= 0:成功，-1：已存在，-2：用户被禁用 ,-3：其它原因=||


=== 2.2启动上报 ===
开发环境：http://dev15.pclady.com.cn/app/reportStartUp.jsp  [[BR]]
线上环境：http://modern.pclady.com.cn/app/reportStartUp.jsp [[BR]]

**说明**

> 当天用户第一次启动时，需要上报一次。便于判断活跃度，以后发送通知时会用到

**缓存时间**

>0

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

>魔方token

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||==||
||= type =||= 客户端类型 =||= int =||= "" =||= 否 =||= 1:IOS,2:Android =||
||= token =||= 魔方推送apns token =||= String =||= "" =||= 否 =||= IOS为魔方的token,安卓为deviceid =||

**返回**

{{{#!java
{
  "status":0,
  "msg":"请求成功"
}

}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||

----------

== 2.首页 ==

=== 2.1首页 ===
开发环境：http://dev15.pclady.com.cn:8004/app/index.jsp [[BR]]
线上环境：http://modern.pclady.com.cn/app/index.jsp [[BR]]
mrobot地址：http://mrobot.pclady.com.cn/x-300/choice-choice/app/index.jsp

**说明**

> 根据需求文档返回对应的节点[[BR]]
> 由于需要查询正在直播的视频，先不考虑缓存[[BR]]

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>摩登后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||

**返回**

{{{#!java
{
    "status": 0,
    "msg": "请求成功",
    "focus": [
        {
            "typeName": "焦点图类型",
            "imageUrl": "http://img.pconline.com.cn/7.jpg",
            "url": "外链url",
            "contentId": "14324"
        }
    ],
    "recommend": [
        {
            "contentId": 1111,
            "typeName": "推荐类型,类型同焦点图",
            "imageUrl": "http://img.pconline.com.cn/7.jpg",
            "url": "外链url",
            "recommendId": "14324",
            "title": "标题",
            "desc": "推荐描述"
        }
    ],
    "liveVideo": [
        {
            "liveId": 11,
            "liveType": 1,
            "imageUrl": "http://img.pconline.com.cn/7.jpg",
            "techId": 1111,
            "techJobName": "××御用化妆师",
            "techNickName": "老师姓名",
            "techIconUrl": "http://img.pconline.com.cn/7.jpg",
            "techType": 1,
            "title": "课程标题",
            "startTime": "MM.dd hh:mm",
            "watchTotal": 100
        }
    ],
    "teacher": [
        {
            "techId": 111,
            "techJobName": "××御用化妆师",
            "techNickName": "老师姓名",
            "techIconUrl": "http://img.pconline.com.cn/7.jpg",
            "techType": 1
        }
    ],
    "chosenVideo": [
        {
            "liveId": 11,
            "liveTime": "6'33''",
            "imageUrl": "http://img.pconline.com.cn/7.jpg",
            "techId": 1111,
            "techJobName": "××御用化妆师",
            "techNickName": "老师姓名",
            "techIconUrl": "http://img.pconline.com.cn/7.jpg",
            "techType": 1,
            "title": "课程标题",
            "watchTotal": 100,
            "tag": [
                "标签1",
                "标签2",
                "标签3"
            ]
        }
    ],
    "hotVideo": [
        {
            "liveId": 11,
            "liveTime": "6'33''",
            "imageUrl": "http://img.pconline.com.cn/7.jpg",
            "techId": 1111,
            "techJobName": "××御用化妆师",
            "techNickName": "老师姓名",
            "techIconUrl": "http://img.pconline.com.cn/7.jpg",
            "techType": 1,
            "title": "课程标题",
            "watchTotal": 100
        }
    ]
}

}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= typeName =||= 直接课:liveCourse，视频课程:videoCourse，一对一课程:lesson，老师:teach，标签:tagInfo，外接:webview =||= focus =||= 焦点图节点，返回5张焦点图 =||
||= recommend =||= 推荐节点，返回三条 =||=liveVideo =||= 直接视频节点，3条 =||
||= liveType =||= 1:直播,2:预告 =||=imageUrl =||= liveVideo节点中为封面图 =||
||= techID =||= 老师ID =||=techJobName =||= 头衔 =||
||= startTime =||= 如果为预告，要返回开始时间 =||=watchTotal =||= 如果是直播，返回观看人数 =||
||= techIconUrl =||= 老师等级icon =||=techType =||= 老师类型，1：老师，2：达人 =||
||= teacher =||= 老师推荐节点，7条 =||=chosenVideo =||= 精选直播课节点，3条 =||
||= liveTime =||= 视频时长 =||=tag =||= 标签，最多三个 =||
||= hotVideo =||= 热点视频节点，6个 =||=tag =||= 标签，最多三个 =||
[[BR]]