雲朵後臺接口文檔

雲朵後臺接口文檔

---

概述

雲朵是一款專注於學生的教育app,立足於學生每次考試的大數據容量,依託特色的知識點體系分析,着力於爲廣大學生提供更針對,更具體的教育資源,爲學生更好的提高自己提供科學化的方案

開發指南

簡介

系統後臺採用spring+springMVC+JDBC構建,爲前端Android及ios提供接口支持.系統架構輕量,當前系統主要包含以下幾個模塊

• 基礎接口 commom 包含登錄,註冊,用戶相關操作等
• 學生成績 stuScore

通用方法 commom

jhmm庫用戶登錄 commom/jhmmLogin.do （同步sso）

傳入參數 
    loginName  登錄名
    password   密碼（已加密）
返回參數
{
    "userUid":5530121,                  //  用戶Uid
    "userName":"肖祖逸",           //  用戶名
    "userType":"10",            //  用戶類型：10-學生  20-教師  30-家長
    "sex":"0",              //  性別：0-未知  1-男  2-女
    "headPortrait":"http://192.168.0.30:8083/jhapp/images/road_from_default_pic/10181.png"  //頭像圖片url
    classesInfo:[
    {
    "schoolName":"漢口輔仁小學",       
    "classesName":"小學五年級07班",   //用來獲取羣組消息建socket，classesUid即爲groupId
    "schoolUid":10086,
    "classesUid":4140385,
    "unReadNum:10
    }
    ],
    "flag":1,                 // 通用標示：flag=0 則表示失敗，應不再進行下面的操作，直接讀"msg"
    "msg":"登錄成功！"   //服務端返回錯誤原因  flag時讀取
}

jhmm庫用戶登錄 commom/loginByUserUid.do （通過userUid登錄，不同步sso）

傳入參數 
    userUid 用戶Uid
返回參數
{
    "userUid":5530121,                  //  用戶Uid
    "userName":"肖祖逸",           //  用戶名
    "userType":"10",            //  用戶類型：10-學生  20-教師  30-家長
    "sex":"0",              //  性別：0-未知  1-男  2-女
    "headPortrait":"http://192.168.0.30:8083/jhapp/images/road_from_default_pic/10181.png"  //頭像圖片url
    classesInfo:[
    {
    "schoolName":"漢口輔仁小學",       
    "classesName":"小學五年級07班",   //用來獲取羣組消息建socket，classesUid即爲groupId
    "schoolUid":10086,
    "classesUid":4140385,
    "unReadNum:10
    }
    ],
    "flag":1,                 // 通用標示：flag=0 則表示失敗，提示登錄過期，否則不管
    "msg":"登錄成功！"   //服務端返回錯誤原因  flag時讀取
}

修改用戶密碼 systemUsers/modifyPwd.do （同步sso）

傳入參數 
    userUid  用戶Uid
    oldPassword   舊密碼（已加密）
    newPassword   新密碼（已加密）
返回參數
{
    flag   //通用標示
    msg    //返回的文本提示 包含各種文本 修改成功，失敗，舊密碼不對，密碼爲空，用戶不存在等等
}

上傳用戶頭像 systemUsers/JhmmUploadHeadPortrait.do

傳入參數 
    userUid  用戶Uid 
    attachments     圖片文件    file類型
返回參數
{
    headPortrait //新頭像絕對地址
    flag   //通用標示
    msg    //返回的文本提示 包含各種文本 修改成功，失敗，舊密碼不對，密碼爲空，用戶不存在等等
}

發送手機驗證碼 smssApp/appSendPhoneCode.do

傳入參數 
    loginName  登錄名
    password   密碼（已加密）
    phone 手機號（傳此項爲綁定手機號發送驗證碼，登錄發驗證碼不傳此項）
返回參數
{
    "code":553012,                  //  驗證碼
    "flag":1,           //  狀態標識 1-發送成功  0-發送失敗,請直接顯示msg 201-未綁定手機號,跳轉到綁定手機號頁面
    "msg":"獲取成功",           //  提示語
}

綁定手機號 smssApp/bindPhone.do

傳入參數 
    loginName  登錄名
    password   密碼（已加密）
    phone 手機號（要綁定的）
返回參數
{
    "flag":1,           //  狀態標識 1-發送成功  0-綁定失敗,請直接顯示msg 
    "msg":"獲取成功",     //  錯誤提示語
}

---

yunduoApp首頁 homePage

獲取首頁數據接口 homePage/getHomePage.do

傳入參數 
    userUid 用戶Uid
    noticePageNum 通知的頁數 從1開始
    noticePageSize  每頁的數量 默認15
返回參數
{
    "userUid":5530121,                  //  用戶Uid
    "userName":"肖祖逸",           //  用戶名
    "userType":"10",            //  用戶類型：10-學生  20-教師  30-家長
    "sex":"0",              //  性別：0-未知  1-男  2-女
    "headPortrait":"http://192.168.0.30:8083/jhapp/images/road_from_default_pic/10181.png" , //頭像圖片url
    "carouselFigure":[    //首頁輪播圖List
        "http://59.175.213.78:30164/jhapp/images/carouselFigure/1.png",
        "http://59.175.213.78:30164/jhapp/images/carouselFigure/1.png",
        "http://59.175.213.78:30164/jhapp/images/carouselFigure/1.png"
    ],
    "noticeMap":{ //下方區級通知的消息
        "notices":[  //通知列表  list
            {
            "noticeTitle":"你好", //標題
            "noticeNote":"今天下午沒課" //正文
            "noticeDatetime":"2017-10-30 17:11:20", //時間
            "creatorUid":11, //創建人
            "noticeDept":10180, //通知發行的機構
            "noticeUid":6,  //通知Uid
            "noticeUrl":"http://www.daluob.com", //網址鏈接,暫時不管            
            "enableId":"1",
            "contentDetailUrl":
        "http://192.168.0.73:30164/jhapp/homePage/getNoticeDetail.do?noticeUid=3&userUid=5457051"//點擊直接進入詳情頁
            }
        ],
        "pageTotalCount":27,
        "pageTotalPage":2//總頁數
        "pageSize":15,
        "pageNum":1
    }
    "flag":1,                 // 通用標示：flag=0 則表示失敗，提示登錄過期，否則不管
    "msg":"獲取首頁成功！"   //服務端返回錯誤原因  flag爲0時讀取
}

---

yunduoApp demo相關

獲取折線圖/知識地圖/體育三個Div yunduoApp/getAllDiv.do 的鏈接接口

傳入參數
    userUid  用戶Uid
返回參數
{
    "scoreUrl":"http://192.168.0.30:8083/jhapp/yunduoApp/getScore.do?userUid=5530121",//折線圖接口
    "knowitemMapUrl":"http://192.168.0.30:8083/jhapp/yunduoApp/getKnowiteMap.do?userUid=5530121",//知識地圖接口
    "physicalUrl":"http://192.168.0.30:8083/jhapp/yunduoApp/getPhysical.do?userUid=5530121&gradeType=11",//體育接口
    "msg":"獲取路徑成功",
    "flag":1
}

注：折線圖已實現；知識地圖已實現，體育已實現

返回體育成績數據 yunduoApp/getPhysical.do

傳入參數
    userUid  用戶Uid
    gradeTypeId  年級Id
返回參數
    {"myHealth":[     //一般項成績 如肺活量，一分鐘跳繩等  可能爲空
            {"health_level_name":null,         //等級  如及格，優秀
            "health_item_name":"體重身高指數", //項目名  如肺活量，一分鐘跳繩
            "health_item_unit":"",         //單位  沒有爲空
            "user_name":"黃數",          //用戶名  無意義項
            "my_health_score":60,              //得分
            "user_uid":3928084,        //
            "my_health_data":"25.3         //數據  如120
            }
            ,{"health_level_name":"及格","health_item_name":"總分","health_item_unit":"","user_name":"黃數","my_health_score":76.4,"user_uid":3928084,"my_health_data":null}
           ],
    "myHealthST":[  //身高體重數據
            {"health_level_name":null,
            "health_item_name":"身高",
            "health_item_unit":"釐米",
            "user_name":"黃數",
            "my_health_score":null,
            "user_uid":3928084,
            "my_health_data":"167.2"
            },
            {"health_level_name":null,"health_item_name":"體重","health_item_unit":"公斤","user_name":"黃數","my_health_score":null,"user_uid":3928084,"my_health_data":"70.6"}],
    "myHealthScore":76.4,  //體育得分
    "flag":1,              //通用標示
    "msg":"獲取學生體育成績成功"    //
}

返還三個demodiv

• yunduoApp/getScore.do 返回成績折線圖Div

傳入參數
    userUid 用戶Uid
    type   查詢類型  1-外面小圖   其它或不傳-詳細圖
    width  div寬度
    height div高度
返回參數
    html頁面

• yunduoApp/getKnowiteMap.do 返回知識點Div
  

傳入參數
    userUid 用戶Uid
    type   查詢類型  1-外面小圖   其它或不傳-詳細圖
    width  div寬度
    height div高度
返回參數
    html頁面

• yunduoApp/getPhysicalDiv.do 返回體育成績Div
  

 

傳入參數 

userUid 用戶Uid 

type   查詢類型  1-外面小圖   其它或不傳-詳細圖  

返回參數 

html頁面 

注：pony做了自適應，不需要傳width和height

---

appMessage app消息系統

獲取用戶發送與接受的消息 appMessage/myNews.do

傳入參數
    userUid     用戶Uid  5693563
    pageSize    接受的信息分頁數量  //不傳默認爲30 傳0爲返回所有
    pageNum     接受的信息當前頁碼（從1開始）//不傳默認爲1

    pageSizeS   發出的的信息分頁數量  //不傳默認爲30 傳0爲返回所有
    pageNumS    發出的的信息當前頁碼（從1開始）//不傳默認爲1
返回參數
{
    "getMessage":{   //收到的消息
        "result":[                      //具體收到的消息list
            {
                "messageUid":3,         //消息Uid
                "messageMemberUid":2,           //分消息uid
                "editTime":"2016-12-15 14:13", //消息創建的時間
                "userUid":3736049,      //發送人uid
                "userName":"summer",        //發送人賬號
                "messageRead":"0",      //0-未讀   1-已讀
                "messageNote":"這是我收到的 --- summer to herb",  //消息文本
                "messageTitle":"我是標題"   //消息標題
            }
            ],
        "pageSize":30,   //分頁行數
        "pageTotalCount":1,  總數據量
        "pageNum":1 //當前頁碼
        },
    "unReadMessagenum":1,  //未讀的數目,所有數目在上面的pageTotalCount
    "sendMessage":{ //發出的信息
        "result":[   //發出的信息的list
            {
                "messageUid":3,         //消息Uid
                "messageMemberUid":1,       //分信息uid
                "editTime":"2016-12-15 14:12",  //信息創建的時間
                "userUid":3736049,      //接收人uid
                "loginName":"summer",       //接收人登錄名
                "userName":"y111",      //接收者姓名
                "messageNote":"這是我發出的--herb to summer",   //文本
                "messageTitle":"我是標題"   //消息標題
            }
            ],
        "pageSize":30,
        "pageTotalCount":1,
        "pageNum":1
        },
    "flag":1,
    "msg":"獲取成功！"
}

注：page（pageSize，pageNum，pageTotalCount）以後不再贅述

發送消息 appMessage/newMessage.do （接受者登錄名應先校驗，校驗用下一個方法）

傳入參數
    userUid  當前用戶Uid
    messageTitle   消息標題
    messageNotes 消息文本
    userLoginName 接受人loginName（多個用@隔開）
返回參數
{
    flag
    msg
}

校驗登錄名是否存在 appMessage/checkUserLoginName.do

傳入參數
    userUid  當前用戶Uid
    userLoginName 接受人loginName（多個用@隔開）
返回參數
{
    flag,
    msg   //最後一個校驗失敗的人的loginName
}

注：暫未使用

#### 刪除信息 appMessage/delMessage.do ####

傳入參數
    userUid  當前用戶Uid
    selectedUids  消息Uid（多個用,隔開） 參見消息列表的messageMemberUid
返回參數
{
    flag,
    msg,   
    count  //刪除的信息的數目
}

標記爲已讀 appMessage/messageRead.do

傳入參數
    userUid  當前用戶Uid
    selectedUids  消息Uid（多個用,隔開） 參見消息列表的messageMemberUid
返回參數
{
    flag,
    msg,   
    count  //標記爲已讀的信息的數目
}

讀取消息 appMessage/lookMessage.do

傳入參數
    userUid  當前用戶Uid
    messageUid  消息Uid（多個用,隔開） 參見消息列表的messageUid
    type  消息類型  get--得到的消息  send--發出的消息
返回參數
    {
    "iMessage":{        //消息參數
            "messageUid":2,  //消息Uid
            "editTime":"2016-12-15 00:00",
            "userUid":3736049,  //發送人
            "messageNote":"這是我收到的 --- summer to herb",  //文本信息
            "messageTitle":"我是標題"   //消息標題

        },
    "type":"send",   //消息類型
    "userLoginNames":"herb", //接受人或的發送人loginName 依據上面的type  get-發送人  send-接收人
    "userNames"  //接受人或的發送人userName 依據上面的type  get-發送人  send-接收人
    "msg":"獲取成功！",
    "flag":1
}

---

appExamEvaluate app考試評價系統（及歷史考試）

注：暫未使用

獲取我的考試列表 appExamEvaluate/myExamList.do

傳入參數
    userUid     用戶Uid  5457051
    pageSize    接受的信息分頁數量  //不傳默認爲30  傳0爲返回所有 
    pageNum     接受的信息當前頁碼（從1開始）//不傳默認爲1

返回參數
{
    "bannerData":[   //banner數據項
        ["調考","校考","能力測試","共有"],
        ["6次","27次","4次","37次"]
    ]
    "examList":[    //考試信息list
        {
        "exam_name":"回民201504綜合練習一",  //考試名
        "exam_uid":7234827,//考試uid
        "exam_type_name":"一般考試",         //考試類型  1一般考試 2調考 3能力測試
        "exam_time":"2015-04-15",        //考試日期
        "user_name":"吳琪",            //用戶名
        "school_name":"回民小學",        //所屬學校
        "class_name":"小學一年級01班",         //班級
        "exam_score_uid":6978274, //成績uid
        "exam_score_status_id":"9,//分數狀態id" 0:未完成登分 7:健康狀況 8:缺考 9:正常成績
        "course_id":14 ,//考試科目id
        "course_name":"數學",  //考試科目名稱
        "exam_score":"88.0",     //實際分數 可能字段:"缺考","未發佈分數"
        "exam_standard_score":"92.8", //標準分
        "level":1//分數等級  1:A+ 2:A 3:B+ 4:B 5:C+ 6:C
        "exam_stu_no":"03011017",            //考號
        "exam_paper_total":100 ,             //試卷總分
        "exam_room_no":1,            //考場號  此代表第1考場
        "exam_stu_no_uid":5679934,       //考場安排Uid，無意義
        "classes_uid":305068, //考試時所屬的班級uid
        "grade_type_id":15,//年級類型uid
        "school_uid":10154,//學校Uid
        "statInfo:{  //統計信息(map)
            "avg_score":80 //平均分
            "max_score":98,//最高分
            "ranking":"暫無",//排名
            "riseRanking":"暫無",//上升排名
            "all_num":145,//人數(有效分數)
            }
        },
    "pageNum":1,
    "pageSize":30,
    "pageTotalCount":39,
    "pageTotalPage":2, //總頁數
    "flag":1,
    "msg":"獲取考試信息成功！ "
}

獲取單次考試的評價appExamEvaluate/getExamEvaluateByScoreUid.do

傳入參數
    userUid     用戶Uid  5457051
    examScoreUid 分數Uid(參見上個接口返回的exam_score_uid) 6457976

返回參數
{
    //---------------------------------------------------------
    "examInfo":{   //考試信息Map        
        "exam_name":"回民201504綜合練習一",  //考試名
        "exam_uid":7234827,//考試uid
        "exam_type_name":"一般考試",           //考試類型  1一般考試 2調考 3能力測試
        "exam_time":"2015-04-15",        //考試日期
        "user_name":"吳琪",            //用戶名
        "school_name":"回民小學",        //所屬學校
        "class_name":"小學一年級01班",         //班級
        "exam_score_uid":6978274, //成績uid
        "exam_score_status_id":"9,//分數狀態id"
        "course_id":14 ,//考試科目id
        "course_name":"數學",  //考試科目名稱
        "exam_score":"88.0",     //實際分數 可能字段:"缺考","未發佈分數"
        "exam_standard_score":"92.8", //標準分
        "level":1//分數等級  1:A+ 2:A 3:B+ 4:B 5:C+ 6:C
        "exam_stu_no":"03011017",            //考號
        "exam_paper_total":100 ,             //試卷總分
        "exam_room_no":1,            //考場號  此代表第1考場
        "exam_stu_no_uid":5679934,       //考場安排Uid，無意義
        "classes_uid":305068, //考試時所屬的班級uid
        "grade_type_id":15,//年級類型uid
        "school_uid":10154,//學校Uid
        "statInfo:{  //統計信息(map)
            "avg_score":80 //平均分
            "max_score":98,//最高分
            "ranking":"暫無",//排名
            "riseRanking":"暫無",//上升排名
            "all_num":145,//人數(有效分數)
            }
    },
    //---------------------------------------------------------
    "topicRadar":{         //小題分析雷達圖
        "titleName":["我的","平均"],  //分類
        "myScore":[18,18,4,4,24,26],   //我的
        "avgScore":[17.3,15.9,3.3,3.5,20.3,23],  //平均分
        "totalScore":[18,18,4,4,26,30], //總分 (軸最大值)
        "indicatorName":["第1題","第2題","第3題","第4題","第5題","第6題"], //類目(軸名稱)
        "explainName":["第1題：填空題","第2題：單項選擇題","第3題：判斷題","第4題：閱讀材料，按要求答題","第5題：閱讀短文，完成練習","第6題：習作"] //解釋(軸名稱)
    },
    //---------------------------------------------------------
    ""topicTable":{   //小題分析數據
        "titleName":"小題得分點",
        "topicTableList":[   //小題分數評價表格  (數據可直接按行展示)
            ["名稱","得分(總分)","得分率","題目難度"],  //數據  表頭
            ["填空題","18.0(18.0)","100.0%","0.04(易)"],  //題目1數據
            ["單項選擇題","18.0(18.0)","100.0%","0.12(易)"],//題目2數據
            ["判斷題","4.0(4.0)","100.0%","0.18(易)"],
            ["閱讀材料，按要求答題","4.0(4.0)","100.0%","0.13(易)"],
            ["閱讀短文，完成練習","24.0(26.0)","92.31%","0.22(易)"],
            ["習作","26.0(30.0)","86.67%","0.23(易)"]
    ],
    //---------------------------------------------------------
    "scoreSection":{  //全區一分一段圖
        "titleName":"全區排名",//標題
        "min":0,  //x軸起始座標
        "max":100,  //X軸終止座標
        "myScore":94,  //我的分數,用於定點
        "defeat":"97.57%", //打敗比例
        "Ranking":59, //排名
        "stuTotal":3757,//參加考試的有效成績人數
        "sectionNum":  [//一分一段的人數  從0開始到最大座標
                0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,
                0,0,0,1,0,0,0,0,1,0,0,0,1,0,0,1,0,1,0,0,
                1,2,1,1,0,0,3,1,1,2,0,1,2,0,2,1,3,1,7,6,
                12,7,10,6,5,11,15,15,17,20,21,37,42,38,54,
                71,70,82,103,129,176,194,203,247,258,293,
                275,294,217,221,160,98,71,39,26,13,2,1,0,0
                ],  
        "sectionNumAll":[//一分一段的累積人數 從0開始到最大座標
                0,0,0,0,0,0,0,0,0,0,0,0,0,0,
                0,1,1,1,1,1,1,1,1,2,2,2,2,2,
                3,3,3,3,4,4,4,5,5,6,6,6,7,9,
                10,11,11,11,14,15,16,18,
                18,19,21,21,23,24,27,28,
                35,41,53,60,70,76,81,92,
                107,122,139,159,180,217,
                259,297,351,422,492,574,
                677,806,969,1145,1339,1542,
                1789,2047,2340,2615,2909,
                3126,3347,3507,3605,3676,
                3715,3741,3754,3756,3757,3757,3757
            ]
    },
    "scoreSection":{  //班級一分一段圖(結構和上面的一樣)
        "titleName":"班級排名",//標題
        "min":0,  //x軸起始座標
        "max":100,  //X軸終止座標
        "myScore":94,  //我的分數,用於定點
        "defeat":"97.57%", //打敗比例
        "Ranking":59, //排名
        "stuTotal":35,//參加考試的有效成績人數(班級)
        "sectionNum":  [//一分一段的人數  從0開始到最大座標
                0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,
                0,0,0,1,0,0,0,0,1,0,0,0,1,0,0,1,0,1,0,0,
                1,2,1,1,0,0,3,1,1,2,0,1,2,0,2,1,3,1,7,6,
                12,7,10,6,5,11,15,15,17,20,21,37,42,38,54,
                71,70,82,103,129,176,194,203,247,258,293,
                275,294,217,221,160,98,71,39,26,13,2,1,0,0
                ],  
        "sectionNumAll":[//一分一段的累積人數 從0開始到最大座標
                0,0,0,0,0,0,0,0,0,0,0,0,0,0,
                0,1,1,1,1,1,1,1,1,2,2,2,2,2,
                3,3,3,3,4,4,4,5,5,6,6,6,7,9,
                10,11,11,11,14,15,16,18,
                18,19,21,21,23,24,27,28,
                35,41,53,60,70,76,81,92,
                107,122,139,159,180,217,
                259,297,351,422,492,574,
                677,806,969,1145,1339,1542,
                1789,2047,2340,2615,2909,
                3126,3347,3507,3605,3676,
                3715,3741,3754,3756,3757,3757,3757
            ]
    },
    //---------------------------------------------------------
    "knowItemTable":{
        "titleName":"最差知識點排行", //標題
        "min":0,                                   //繪圖時最小值
        "max":100,                              //繪圖時最大值       
        "knowItemTableData":[ //具體數據  知識點名稱-知識點標準分-打敗人數(掌握情況)-等級(1:A+ 2:A 3:B+ 4:B 5:C+ 6:C)
            ["小數的加減運算",77.22,"41.38",1],
            ["圖形平移的應用",77.78,"44.83",4],
            ["圖形對稱的應用",77.79,"44.83",4],
            ["觀察物體",77.78,"44.83",5],
            ["除法的性質",78.44,"44.83",6],
            ["減法的性質",78.44,"44.83",4]
        ]
    },
    //---------------------------------------------------------
    "historyScore":{
            "titleName":"歷史成績",  //標題
            "min":0,   
            "max":100,
            "myScore":[   //我的分數  沒有分數爲 "-"
                    91,98,97,91,92,96,88,99,100,
                    89.5,91,93.5,96,93,92,88]
            "myStandardScore":[  //標準分
                    98.5,95.8,95.5,91.3,87.5,94,87.4,94.3,95.9,
                    92.1,96.2,92.9,90.9,97.9,95.9,92.8],
            "avgScore":[  //所有參加考試的平均分
                    66.42,76.43,76.24,73.77,80.84,79.03,79.98,77.76,
                    76.91,71.78,64.45,71.2,77.07,60.35,65.97,66.37],
            "examTime":[ //考試時間  X軸
                    "2015-11-24","2015-12-15","2016-01-21",
                    "2016-04-07","2016-05-26","2016-06-13",
                    "2016-06-28","2016-10-18","2016-11-18",
                    "2016-12-07","2017-01-12","2017-04-06",
                    "2017-04-26","2017-05-16","2017-06-06",
                    "2017-06-27"],
            "examName":[ //考試名稱
                    "鄔小201511","鄔小201512","20160121鄔家期末考試",
                    "鄔小201604","鄔小201605","鄔小201506",
                    "20160628鄔家期末考試","鄔小201610",
                    "鄔小201611（一、二、三、五年級）","鄔小201612",
                    "20170112鄔家墩小學期末考試",
                    "鄔小201704（一、二、三、五年級）",
                    "2017.4.26.區期中單項測試","鄔小201705（三、五年級)",
                    "鄔小201706（三、四、五、六）",
                    "201706鄔家墩小學全區期末考試"],
            "examType":[  //考試類型  1一般考試 2調考 3能力測試
                    "1","1","1","1","1","1","1","1",
                    "1","1","1","1","3","1","1","1"],
            "scoreStatus":[ //分數狀態  7:健康問題 8缺考  9正常分數
                    "9","9","9","9","9","9","9","9",
                    "9","9","9","9","9","9","9","9"],
            "examScoreUids":[  //分數對應的examScoreUid 用於調用
                    6039272,6085038,6187695,6232225,6332797,
                    6400722,6457976,6512517,6635702,6669946,
                    6710488,6810398,6842927,6887092,6915064,7031978]
            },
    //---------------------------------------------------------
    "flag":1,
    "msg":"獲取考試評價信息成功！ "
}

---

noticeMessage app聊天功能（班級）

獲取某個人擁有的羣組及人員 noticeMessage/getChatUserList.do

傳入參數
    userUid     用戶Uid  5530121
    groupIds   羣組Uid(@分隔)  4140385  參見登錄時返回的classesUid
返回參數
{
    "classesInfoList": [  //班級羣組信息   list
        {
            "classesName": "小學五年級07班",
             "schoolName": "漢口輔仁小學",
            "classesUid": 4140385,
            "schoolUid": 10086,
            "userInfo": [   
                {
                   "sex": "0",
                    "position": "學生",//用戶身份
                    "userType": "1",//用戶類型  1-學生 2-老師  3-家長
                    "userName": "肖祖逸",
                    "headPortrait": "/171204/1043/182e436b-7299-40a3-a2b8-7671c2510b35.jpeg",
                    "headPortraitHD": "/171204/1043/1b297401-b90a-43b6-8c19-12133cbf682e.jpeg",
                    "userUid": 5530121
                },
                {
                    "sex": "1",
                    "position": "語文老師",
                    "userType": 2,
                    "userName": "herb",
                    "headPortrait": null,
                    "headPortraitHD": null,
                    "userUid": 5493563
                }
            ]
        }
    ],
    "flag": 1,
    "msg": "獲取羣組用戶成功！"
}

獲取聊天列表 noticeMessage/getChatList.do

傳入參數
    userUid     用戶Uid  5530121
    groupIds  羣組Uid(@分隔)  4140385
    dateStr    時間字符串,返回之後的消息 2017-11-15 11:34:32

返回參數
{
    "chatResultList":[ //會話列表  不分頁,全部返回
        {
            "chatUid":4140385,  //會話Uid
            "unread":"1", // 未讀數
            "chatName":"小學五年級07班",  //會話名
            "lastMessageEditTime":"2017-11-17 09:13:16",
            "userUid":5530121,
            "chatType":2, //1-單聊   2-羣聊
            "lastMessageNotes":"herb:兩瓶" //最後一條消息
        },
        {
            "chatUid":5493563,
            "unread":"2",  // 未讀數
            "chatName":"肖祖逸",
            "lastMessageEditTime":"2017-11-17 09:12:25",
            "userUid":5530121,
            "chatType":1,
            "lastMessageNotes":"我們"
        }
        ],
    "pageNum":1,
    "pageSize":2,
    "pageTotalCount":2
    "flag":1,
    "msg":"獲取成功"
        }

獲取詳細會話記錄 noticeMessage/getChatRecord.do

傳入參數
    userUid     用戶Uid  5530121
    groupId/reciverUid  獲取羣聊/單聊時(參見上面返回的chatUid)  4140385
    dateStr    時間字符串,返回之後的消息 2017-11-15 11:34:32
    pageNum
    pageSize
返回參數
{
    "chatRecordList": [ //會話消息List
        {
            "chatDetailsUid": "1142",  //詳情Uid
            "senderName": "肖祖逸",  //發送人姓名
            "messageType": "21",      //消息類型  21-普通  22-圖片 23-語言  24-公告
            "chatUid": "5493563",
            "sender": 5530121,   //發送人Uid
            "messageNotes": "我們",
            "userUid": 5530121,
            "messageEditTime": "2017-11-17 09:12:25"
        },
        {
            "chatDetailsUid": "1139",
            "senderName": "herb",
            "messageType": "21",
            "chatUid": "5493563",
            "sender": 5493563,
            "messageNotes": "我換了",
            "userUid": 5530121,
            "messageEditTime": "2017-11-17 09:11:39"
        }
    ],
    "pageNum": 1,
    "pageSize": 30,
    "pageTotalCount": 2,
    "flag": 1,
    "msg": "獲取成功"
}

發送消息 noticeMessage/sendMessageOrTask.do

傳入參數
    userUid     用戶Uid  5530121
    groupId/receivers  羣聊/單聊(@分割發送多人)chatUid
    messageType  消息類型  21-普通  22-圖片 23-語言  24-公告
    messageNotes 消息文本 
    messageAttachments  消息附件url
    messageEditTime 消息編輯的時間(2017-11-17 09:12:25)

返回參數
{
    "chatDetailUid":1192  //table2 的chatDetailUid值
    "flag": 1,
    "msg": "發送成功"
}

刪除消息 noticeMessage/deleteMessages.do

傳入參數
    userUid     用戶Uid  5530121
    receiveMessageUids  接受的消息uids(@分隔),參見上面返回的chatDetailUid
    sendMessageUids  發送的消息uids(@分隔),參見上面返回的chatDetailUid

返回參數
{
    "deleteMessageUids": 1192@1321@1123@111,//刪除的chatDetailUids   @分隔
    "flag": 1,
    "msg": "刪除成功"
}

上傳圖片 systemUsers/uploadImageToFS.do

傳入參數 
    userUid  用戶Uid 
    attachments     圖片文件    file類型
返回參數
{
    imageUrlList:[  //圖片List
        "http://fs.tiilii.com/1.jpg",
        "http://fs.tiilii.com/2.jpg",
        "http://fs.tiilii.com/3.jpg",
   ] 
    flag   //通用標示
    msg    //返回的文本提示 包含各種文本 修改成功，失敗，舊密碼不對，密碼爲空，用戶不存在等等
}

---

©
author:herb
time:2017-12-4