福建省教育資源公共服務(wù)平臺(tái)

1、福建省教育資源公共服務(wù)平臺(tái)3.0開放API接口規(guī)范福建省教育資源公共服務(wù)平臺(tái)開放API接口規(guī)（V3.0）API訪問鑒權(quán)介紹API調(diào)用時(shí)，應(yīng)用向福建省教育資源公共服務(wù)平臺(tái)請(qǐng)求token，福建省教育資源公共服務(wù)平臺(tái)分配Token信息并指明有效期，只要在Token有效期內(nèi)，應(yīng)用無需重新發(fā)起Token申請(qǐng)，被調(diào)用方在第一次接收Token時(shí)發(fā)起驗(yàn)證請(qǐng)求，并保存token信息和有效期，只要在Token有效期內(nèi)，后續(xù)調(diào)用就無需再向福建省教育資源公共服務(wù)平臺(tái)申請(qǐng)Token驗(yàn)證。應(yīng)用場(chǎng)景1.用戶使用應(yīng)用。2.應(yīng)用執(zhí)行處理邏輯。3.應(yīng)用使用APPID，時(shí)間戳等參數(shù)向平臺(tái)請(qǐng)求訪問TOKEN。4.平臺(tái)向應(yīng)用返回訪問T

2、OKEN。5.應(yīng)用攜帶訪問TOKEN請(qǐng)求調(diào)用平臺(tái)API。6.平臺(tái)對(duì)TOKEN進(jìn)行校驗(yàn)并處理API調(diào)用請(qǐng)求，向應(yīng)用返回調(diào)用結(jié)果。應(yīng)用支付介紹用戶購買應(yīng)用中商品，應(yīng)用向福建省教育資源公共服務(wù)平臺(tái)發(fā)起扣費(fèi)，福建省教育資源公共服務(wù)平臺(tái)扣取用戶云幣，并根據(jù)商務(wù)合同分成規(guī)則向應(yīng)用所屬合作伙伴帳戶存入相應(yīng)云幣。應(yīng)用場(chǎng)景用戶在應(yīng)用購買學(xué)習(xí)資料。應(yīng)用攜帶參數(shù)扣費(fèi)相關(guān)參數(shù)重定向福建省教育資源公共服務(wù)平臺(tái)進(jìn)行扣費(fèi)。福建省教育資源公共服務(wù)平臺(tái)頁面提示用戶扣費(fèi)，展示所購物品和費(fèi)用相關(guān)信息。用戶在扣費(fèi)頁面確認(rèn)扣費(fèi)。福建省教育資源公共服務(wù)平臺(tái)扣取用戶云幣，將扣費(fèi)結(jié)果返回到應(yīng)用。福建省教育資源公共服務(wù)平臺(tái)后臺(tái)通知應(yīng)用扣費(fèi)結(jié)果

3、。應(yīng)用向福建省教育資源公共服務(wù)平臺(tái)返回扣費(fèi)結(jié)果處理結(jié)果。單點(diǎn)登錄介紹福建省教育資源公共服務(wù)平臺(tái)集成多個(gè)業(yè)務(wù)系統(tǒng)，平臺(tái)的前端展示門戶對(duì)用戶實(shí)現(xiàn)統(tǒng)一登錄入口，只要在福建省教育資源公共服務(wù)平臺(tái)登錄的用戶在福建省教育資源公共服務(wù)平臺(tái)與各業(yè)務(wù)系統(tǒng)間不需要多次登錄，進(jìn)而實(shí)現(xiàn)對(duì)所有被授權(quán)的網(wǎng)絡(luò)資源進(jìn)行無縫訪問了。單點(diǎn)登錄場(chǎng)景用戶登錄福建省教育資源公共服務(wù)平臺(tái)門戶。福建省教育資源公共服務(wù)平臺(tái)保存用戶會(huì)話信息，在瀏覽器COOKIE中保存用戶TGC信息。用戶在福建省教育資源公共服務(wù)平臺(tái)選擇應(yīng)用，福建省教育資源公共服務(wù)平臺(tái)將用戶重向至應(yīng)用。用戶在應(yīng)用內(nèi)訪問受保護(hù)資源，應(yīng)用將用戶重定至福建省教育資源公共服務(wù)平臺(tái)。福建

4、省教育資源公共服務(wù)平臺(tái)從瀏覽器中獲取用戶TGC信息，并根據(jù)TGC校驗(yàn)用戶會(huì)話。福建省教育資源公共服務(wù)平臺(tái)生成ST，并攜帶ST將用戶從福建省教育資源公共服務(wù)平臺(tái)重定向至應(yīng)用。應(yīng)用使用ST請(qǐng)求平臺(tái)校驗(yàn)。平臺(tái)向應(yīng)用返回校驗(yàn)結(jié)果及用戶信息。單點(diǎn)登錄配置說明：以下給出的配置是通用的客戶端配置Demo，只適合跳轉(zhuǎn)地址固定的場(chǎng)景（即serverName對(duì)應(yīng)的value是固定的）。如有其他特殊需求，需客戶端程序自己實(shí)現(xiàn)。Java語言客戶端配置1.先把ssoclient.jar引入到項(xiàng)目的工程中（一般是lib）目錄。2.在項(xiàng)目web.xml文件添加以下內(nèi)容SSOFiltercom.whty.aam.client

5、.authentication.AuthenticationFiltercasServerLoginUrl/index.php?r=portal/user/loginserverName9:8088SSOFilter/*vlidationFiltercom.whty.aam.client.validation.Cas20ProxyReceivingTicketValidationFiltercasServerUrlPrefixhttp:/ :20014/aamif/ticketValidateserverName9:8088vlidationFilter/*com.whty.aam.clien

6、t.session.SingleSignOutHttpSessionListener SingleSignOutFiltercom.whty.aam.client.session.SingleSignOutFilterSingleSignOutFilter/*httpServletRequestWrapperFiltercom.whty.aam.client.util.HttpServletRequestWrapperFilterhttpServletRequestWrapperFilter/*AssertionThreadLocalFiltercom.whty.aam.client.util

7、.AssertionThreadLocalFilterAssertionThreadLocalFilter/*3.項(xiàng)目中取得ticket可用request.getSession().setAttribute(ticket, ticket)；用ticket這名稱從ssession中取得ticket。4.取得用戶的usessionid可用com.whty.aam.client.authentication.AttributePrincipal這個(gè)類AttributePrincipal principal = (AttributePrincipal)request.getUserPrincipal(

8、);String usessionid = principal.getName();.net語言流程說明客戶端配置需要攔截單點(diǎn)登錄請(qǐng)求（如：http:/ip:port/sso/*），但客戶端服務(wù)器攔截到單點(diǎn)登錄請(qǐng)求時(shí)重定向到登錄頁面。用戶登錄URL地址：HYPERLINK :10000/index.php?r=portal/user/login&service=:8080/ssotest;/index.php?r=portal/user/login&service=http:/ip:port/ssotest;URL拼寫說明：service參數(shù)是用戶登錄后門戶重定到客戶端的地址，此參數(shù)必傳不能缺

9、失;此處使用HYPERLINK :8080/ssotesthttp:/ip:port/ssotest為例子，需根據(jù)實(shí)際地址修改替換。用戶在門戶成功登錄認(rèn)證后，門戶會(huì)根據(jù)service參數(shù)地址重定向到客戶端（service參數(shù)傳遞的URL地址），并在URL地址后增加ticket參數(shù)。如：http:/ip:port/ssotest? ticket=*客戶端獲取到ticket值，重定向到用戶中心驗(yàn)證ticket有效和合法性， url請(qǐng)求格式為：:20014/aamif/ticketValidate?ticket= SO6YEWI93093UTYDVXBZ4513=。URL拼寫說明： URL中IP與端

10、口可替換實(shí)際的ip與端口，ticket參數(shù)是用戶中心要求必傳不能缺失.客戶端請(qǐng)求平臺(tái)驗(yàn)證ticket，通過驗(yàn)證ticket的有效性，服務(wù)端校驗(yàn)通過后，會(huì)銷毀該一次性ticket,并返回已登錄用戶名。返回驗(yàn)證后的的報(bào)文。驗(yàn)證通過的報(bào)文testss10驗(yàn)證不通過的報(bào)文Ticket SO6YEWI93093UTYDVXBZ4513= not recognized客戶端解釋XML報(bào)文對(duì)驗(yàn)證通過的報(bào)文取節(jié)點(diǎn)的值獲取到當(dāng)前登錄的用戶usessionid?？蛻舳耸盏叫ｒ?yàn)通過后的報(bào)文，取得用戶usessionid，根據(jù)usessionid建立本地的用戶會(huì)話。會(huì)話時(shí)間可默認(rèn)為一小時(shí)，或根據(jù)需要具體配置.客戶端再

11、根據(jù)usessionid調(diào)用平臺(tái)接口取得當(dāng)前用戶的用戶信息。其它語言配置流程說明客戶端配置需要攔截單點(diǎn)登錄請(qǐng)求（如：http:/ip:port/sso/*），但客戶端服務(wù)器攔截到單點(diǎn)登錄請(qǐng)求時(shí)重定向到登錄頁面。用戶登錄URL地址：HYPERLINK :10000/index.php?r=portal/user/login&service=:8080/ssotest;/index.php?r=portal/user/login&service=http:/ip:port/ssotest;URL拼寫說明：service參數(shù)是用戶登錄后門戶重定到客戶端的地址，此參數(shù)必傳不能缺失;此處使用HYPERL

12、INK :8080/ssotesthttp:/ip:port/ssotest為例子，需根據(jù)實(shí)際地址修改替換。用戶在門戶成功登錄認(rèn)證后，門戶會(huì)根據(jù)service參數(shù)地址重定向到客戶端（service參數(shù)傳遞的URL地址），并在URL地址后增加ticket參數(shù)。如：http:/ip:port/ssotest? ticket=*客戶端獲取到ticket值，重定向到用戶中心驗(yàn)證ticket有效和合法性， url請(qǐng)求格式為：:20014/aamif/ticketValidate?ticket= SO6YEWI93093UTYDVXBZ4513=。URL拼寫說明： URL中IP與端口可替換實(shí)際的ip與端口

13、，ticket參數(shù)是用戶中心要求必傳不能缺失.客戶端請(qǐng)求平臺(tái)驗(yàn)證ticket，通過驗(yàn)證ticket的有效性，服務(wù)端校驗(yàn)通過后，會(huì)銷毀該一次性ticket,并返回已登錄用戶名。返回驗(yàn)證后的的報(bào)文。驗(yàn)證通過的報(bào)文testss10驗(yàn)證不通過的報(bào)文Ticket SO6YEWI93093UTYDVXBZ4513= not recognized客戶端解釋XML報(bào)文對(duì)驗(yàn)證通過的報(bào)文取節(jié)點(diǎn)的值獲取到當(dāng)前登錄的用戶usessionid?？蛻舳耸盏叫ｒ?yàn)通過后的報(bào)文，取得用戶usessionid，根據(jù)usessionid建立本地的用戶會(huì)話。會(huì)話時(shí)間可默認(rèn)為一小時(shí)，或根據(jù)需要具體配置.客戶端再根據(jù)usessionid

14、調(diào)用平臺(tái)接口取得當(dāng)前用戶的用戶信息。接口列表API訪問鑒權(quán)接口接口名稱接口方向接口描述獲取訪問TOKEN應(yīng)用-福建省教育資源公共服務(wù)平臺(tái)應(yīng)用使用訪問憑證獲取訪問令牌用戶接口接口名稱接口方向接口描述獲取當(dāng)前登錄用戶信息應(yīng)用福建省教育資源公共服務(wù)平臺(tái)應(yīng)用根據(jù)單點(diǎn)登錄會(huì)話ID查詢用戶信息獲取用戶基本信息應(yīng)用福建省教育資源公共服務(wù)平臺(tái)應(yīng)用獲取用戶基本信息批量獲取用戶信息應(yīng)用福建省教育資源公共服務(wù)平臺(tái)應(yīng)用批量獲取添加此應(yīng)用的用戶信息獲取用戶好友應(yīng)用福建省教育資源公共服務(wù)平臺(tái)應(yīng)用獲取用戶好友列表驗(yàn)證是否為好友應(yīng)用福建省教育資源公共服務(wù)平臺(tái)應(yīng)用驗(yàn)證兩個(gè)用戶是否為好友查詢班級(jí)信息應(yīng)用福建省教育資源公共服務(wù)平臺(tái)

15、應(yīng)用根據(jù)班級(jí)ID獲取班級(jí)信息查詢班級(jí)成員信息應(yīng)用福建省教育資源公共服務(wù)平臺(tái)應(yīng)用根據(jù)班級(jí)ID獲取班級(jí)成員信息支付接口接口名稱接口方向接口描述支付請(qǐng)求應(yīng)用-福建省教育資源公共服務(wù)平臺(tái)應(yīng)用調(diào)用支付頁面，請(qǐng)求使用云幣支付頁面跳轉(zhuǎn)同步通知福建省教育資源公共服務(wù)平臺(tái)應(yīng)用用戶在福建省教育資源公共服務(wù)平臺(tái)支付完成后，返回至應(yīng)用支付成功頁面后臺(tái)異步通知福建省教育資源公共服務(wù)平臺(tái)應(yīng)用用戶在教云平臺(tái)支付完成后，福建省教育資源公共服務(wù)平臺(tái)后臺(tái)通知應(yīng)用支付結(jié)果消息接口接口名稱接口方向接口描述發(fā)送消息應(yīng)用-福建省教育資源公共服務(wù)平臺(tái)應(yīng)用調(diào)用接口向用戶發(fā)送消息或應(yīng)用以用戶的身份向用戶好友發(fā)送消息接口參考單點(diǎn)登錄單點(diǎn)登錄接口

16、登錄成功后，單點(diǎn)登錄平臺(tái)生成票據(jù)信息ticket，SSO攜帶票據(jù)信息ticket并重定向到Service參數(shù)地址接口說明url/index.php?r=portal/user/login協(xié)議http是否需要鑒權(quán)無請(qǐng)求數(shù)限制無接口方向應(yīng)用平臺(tái)請(qǐng)求說明參數(shù)名稱是否必須類型描述service必選string登錄成功后重定向的應(yīng)用的目標(biāo)地址即應(yīng)用的入口地址，例如：http:/ip:port/ssotest/返回說明登錄成功后，重定向到目標(biāo)地址 Ticket驗(yàn)證接口驗(yàn)證Ticket，驗(yàn)證成功后并返回當(dāng)前登錄用戶標(biāo)識(shí)。接口說明url:20014/aamif/ticketValidate協(xié)議http是否需要

17、鑒權(quán)無請(qǐng)求數(shù)限制無接口方向應(yīng)用平臺(tái)請(qǐng)求說明參數(shù)名稱是否必須類型描述ticket必選string單點(diǎn)登錄成功后生成的票據(jù)信息例如：:20014/aamif/ticketValidate?ticket= SO6YEWI93093UTYDVXBZ4513=返回說明驗(yàn)證通過報(bào)文testss10驗(yàn)證不通過的報(bào)文Ticket SO6YEWI93093UTYDVXBZ4513= not recognized客戶端解釋XML報(bào)文對(duì)驗(yàn)證通過的報(bào)文取節(jié)點(diǎn)的值獲取到當(dāng)前登錄的用戶usessionid?？蛻舳耸盏叫ｒ?yàn)通過后的報(bào)文，取得用戶usessionid，根據(jù)usessionid建立本地的用戶會(huì)話。會(huì)話時(shí)間可默認(rèn)

18、為一小時(shí)，或根據(jù)需要具體配置.客戶端再根據(jù)usessionid調(diào)用平臺(tái)接口取得當(dāng)前用戶的用戶信息。API訪問鑒權(quán)接口獲取訪問TOKEN接口說明應(yīng)用調(diào)用平臺(tái)開放API之前，請(qǐng)求獲取訪問TOKEN。請(qǐng)求說明url:20001/apigateway/getaccesstoken格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用平臺(tái)參數(shù)說明參數(shù)名稱是否必須類型描述appid必選String應(yīng)用IDtimestamp必選String時(shí)間戳。keyinfo必選String對(duì)APPID、APPKEY、Timestamp進(jìn)行sha1-hamc運(yùn)算，加密串為APPID和APPKEY及Ti

19、mestamp字符串相連,以APPKEY為加密參數(shù)Php使用的簽名函數(shù)：hash_hmac，hash_algos參數(shù)值為“sha1”返回值大寫usessionid可選StringTicket驗(yàn)證返回的usessionid 返回說明返回碼含義說明000000操作成功999999系統(tǒng)錯(cuò)誤4.字段說明參數(shù)名稱是否必須類型描述token必選Stringtoken信息validtime必選String有效期，只在有效期內(nèi)(2小時(shí))，應(yīng)用無需重新申請(qǐng)，服務(wù)保存token及有效期，有效期內(nèi)只需做一次驗(yàn)證。platformCode必選String平臺(tái)編碼。六位數(shù)字，標(biāo)明當(dāng)前登錄用戶所屬的平臺(tái) 例如：:2000

20、1/apigateway/getaccesstokenappid:AP000000012697,timestamp:1402968470233,keyinfo:170C718FB73BBB58D3CCEB52EB32D0CF93CA2E4B用戶接口獲取當(dāng)前登錄用戶信息接口描述取得當(dāng)前登錄用戶的用戶信息請(qǐng)求說明url HYPERLINK :22015/aam/rest/user/getuserinfo/usessionid :20001/aam/rest/user/getuserinfo/usessionid?token=xxxxxxx格式-協(xié)議get是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方

21、向應(yīng)用平臺(tái)參數(shù)說明無返回說明序號(hào)字段名約束類型長度說明1result必選string6結(jié)果000000:成功301999:usessionid驗(yàn)證失敗2desc可選string250結(jié)果描述3usessionid必選String64唯一標(biāo)識(shí)一個(gè)登錄用戶sessionid4ueserinfo可選4.1personid必選string60用戶的統(tǒng)一ID；4.2mobnum可選string16手機(jī)號(hào)碼4.3email可選string16郵箱4.4name可選string32用戶姓名4.5nickname可選string100昵稱4.6areacode可選string64用戶歸屬地區(qū)域4.8gende

22、r可選string1性別0是女，1為男4.9birthday可選date16生日4.10usertype必選string1用戶類型:學(xué)生:0老師:1家長:2機(jī)構(gòu):3學(xué)校：4學(xué)校工作人員：5機(jī)構(gòu)工作人員：64.11address可選string256通訊地址4.12postcode可選string8郵編4.13userlogolist可選-頭像LOGO（URL地址）列表4.1 logotype可選int1瀏覽渠道：1：?。?：中；3：大；4.2 logourl可選string512頭像LOGO（URL地址）4.14interests可選string512興趣，多個(gè)興趣之間用分號(hào)分開4.15pro

23、fession可選string64職業(yè)4.16credtype可選string10:身份證1:護(hù)照2:軍人證3:其他4.17idcardno可選string32證件號(hào)碼4.18singature可選string140簽名4.19fnascount可選int 粉絲數(shù)4.20teachesubjectlist可選 Json數(shù)組50如登錄用戶為教師，則返回所教學(xué)科，JSON數(shù)組4.20.1subjectid可選String32學(xué)科id4.20.2subjectname可選String50學(xué)科名稱4.20.3teachmaterialid可選string32教材id4.20.4teachmateria

24、lname可選String200教材名稱4.20.5classid可選string32用戶所在班級(jí)id4.20.6classname可選string50班級(jí)名稱4.20.7foundtime可選string4班級(jí)成立年份4.20.8grade可選String31:一年級(jí) 2：二年級(jí) 3：三年級(jí) 4：四年級(jí) 5：五年級(jí) 6：六年級(jí) 7：初一 8：初二 9：初三 10：高一 11：高二 12：高三13: 職一14:職二15:職三4.20.9studysection可選string31:小學(xué)2:初中3:高中4:高職4.21classid可選string50用戶所在班級(jí)名稱；當(dāng)?shù)卿浻脩魹閷W(xué)生是會(huì)返回該

25、值4.22classname可選string50班級(jí)名稱；當(dāng)?shù)卿浻脩魹閷W(xué)生是會(huì)返回該值4.23classidentity可選JOSN數(shù)組2用戶所在班級(jí)身份: 1:班主任 2：班長 3：管理員4: 教師 5：成員 6：教研員，7：教務(wù)員，8：信息員4.24orgaid可選string32用戶所在機(jī)構(gòu)學(xué)校id4.25organame可選string200用戶所在機(jī)構(gòu)學(xué)校名稱4.26orgaidentity可選JOSN數(shù)組2用戶在機(jī)構(gòu)身份：0平臺(tái)管理員1超級(jí)管理員2央館資源提供者3評(píng)審專家4資源綜合部管理員5基礎(chǔ)教育資源部管理員6職業(yè)教育資源部管理員7專題教育資源部管理員8運(yùn)營管理員9運(yùn)維管理員10

26、央館內(nèi)容資源提供商11央館應(yīng)用資源提供商12機(jī)構(gòu)管理員13產(chǎn)品管理員14資源管理員15內(nèi)容提供商16應(yīng)用提供商17機(jī)構(gòu)資源提供者18普通成員4.27tags可選string1000個(gè)人標(biāo)簽4.28updateTime可選string更新時(shí)間（2014-06-23 15:38:06）5platformCode必選String平臺(tái)編碼，中央平臺(tái)000000請(qǐng)求消息示例：請(qǐng)求URL: :20001/aam/rest/user/getuserinfo/da9933b0-65a7-41ac-9858-1e01d23c7977?token=xxxxxxxxx消息響應(yīng)示例： result : 000000,

27、 usessionid : da9933b0-65a7-41ac-9858-1e01d23c7977,platformCode : 000000, userinfo : personid : CF4D06BE8BC74A59866FFBE2745EB519, birthday : 1990-10-23, gender : 1, name : 柯宏樹, usertype : 0, idcardno : fnascount : 0, userlogolist : , orgaid : C13B6DE0493848558F03F0B36B3F229B, org

28、aname : 華中師范大學(xué)第一附屬中學(xué), orgaidentity : 5 , classid : 335181135C6A41F595C84008F3957C58, classname : 高二(12)班, classidentity : 5 , account :根據(jù)賬號(hào)獲取用戶基本信息接口說明應(yīng)用根據(jù)賬號(hào)可以獲取經(jīng)過登錄認(rèn)證后用戶的基本信息。請(qǐng)求說明url HYPERLINK :22015/aam/rest/getUserInfoReq :20001/aam/rest/getUserInfoReq?token=xxxxxxxx格式j(luò)son協(xié)議post是否需要鑒

29、權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用-平臺(tái)account:用戶賬號(hào)參數(shù)說明序號(hào)字段名約束類型長度說明1account必選string-用戶賬號(hào)2platformcode可選string區(qū)域平臺(tái)編碼Json請(qǐng)求串 ： account:Testss10,platformcode: 000000返回說明序號(hào)字段名約束類型長度說明1result必選string6結(jié)果000000:成功301001:用戶不存在301999:usessionid驗(yàn)證失敗2ueserinfo可選2.1personid必選string60用戶的統(tǒng)一ID；2.2mobnum可選string16手機(jī)號(hào)碼2.3email可選st

30、ring16郵箱2.4name可選string32用戶姓名2.5nickname可選string100昵稱2.6areacode可選string64用戶歸屬地區(qū)域2.7gender可選string1性別0是女，1為男2.8birthday可選date16生日2.9usertype必選string1用戶類型學(xué)生:0老師:1家長:2機(jī)構(gòu):32.10address可選string256通訊地址2.11postcode可選string8郵編2.12userlogolist可選-頭像LOGO（URL地址）列表2.12.1logotype可選int1瀏覽渠道：1：??；2：中；3：大；2.11.2logou

31、rl可選string512頭像LOGO（URL地址）2.13interests可選string512興趣，多個(gè)興趣之間用分號(hào)分開2.14profession可選string64職業(yè)2.15singature可選string140簽名2.16tags可選string1000個(gè)人標(biāo)簽2.19account可選Stirng100賬號(hào)2.20orgaid可選String32用戶所在機(jī)構(gòu)學(xué)校id2.21orgname可選String200用戶所在機(jī)構(gòu)學(xué)校名稱2.22classlist可選String2.22.1classid必選String32用戶所在班級(jí)ID2.22.2classname必選Strin

32、g200用戶所在班級(jí)名稱2.23teachesubjectlist可選 Json數(shù)組50如登錄用戶為教師，則返回所教學(xué)科，JSON數(shù)組2.23.1subjectid可選String32學(xué)科id2.23.2subjectname可選String50學(xué)科名稱2.23.3teachmaterialid可選string32教材id2.23.4teachmaterialname可選String200教材名稱2.23.5classid可選string32用戶所在班級(jí)id2.23.6grade可選String31:一年級(jí) 2：二年級(jí) 3：三年級(jí) 4：四年級(jí) 5：五年級(jí) 6：六年級(jí) 7：初一 8：初二 9：初

33、三 10：高一 11：高二 12：高三13: 職一14:職二15:職三2.23.7studysection可選String31:小學(xué)2:初中3:高中4:高職2.23.6classname可選string50班級(jí)名稱2.23.7foundtime可選string4班級(jí)成立年份2.23.8updateTime可選string更新時(shí)間（2014-06-23 15:38:06）消息響應(yīng)示例 “result”: “000000”, “ueserinfo”: “personid”: “cbdf195ddd1c40efbd3c48ca97c0cbe2”, “mobnum”: , “

34、birthday”: “, “gender”: “1”, “name”: “Testss10”, “usertype”: “5”, “credtype”: “0 “, “idcardno”: , “fnascount”: 0, “userlogolist”: , “account”: “Testss10” 批量獲取用戶信息接口說明應(yīng)用獲取安裝此應(yīng)用的用戶信息。請(qǐng)求說明url:20001/aam/rest/getBatchUserInfoReq?token=xxxxxxxx格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用平臺(tái)參數(shù)說

35、明序號(hào)字段名約束類型長度說明1personids必選JOSN數(shù)組多個(gè)用戶ID2platformcode可選string平臺(tái)編碼返回說明序號(hào)字段名約束類型長度說明1result必選string6結(jié)果000000:成功301001:用戶不存在301999:usessionid驗(yàn)證失敗2ueserinfo可選2.1personid必選string60用戶的統(tǒng)一ID；2.2mobnum可選string16手機(jī)號(hào)碼2.3email可選string16郵箱2.4name可選string32用戶姓名2.5nickname可選string100昵稱2.6areacode可選string64用戶歸屬地區(qū)域2.8

36、gender可選string1性別0是女，1為男2.9birthday可選date16生日2.10usertype必選string1用戶類型學(xué)生:0老師:1家長:2機(jī)構(gòu):32.11address可選string256通訊地址2.12postcode可選string8郵編2.13userlogolist可選-頭像LOGO（URL地址）列表2.13.1logotype可選int1瀏覽渠道：1：??；2：中；3：大；2.13.2logourl可選string512頭像LOGO（URL地址）2.14interests可選string512興趣，多個(gè)興趣之間用分號(hào)分開2.15profession可選str

37、ing64職業(yè)2.18singature可選string140簽名2.19tags可選string1000個(gè)人標(biāo)簽2.20account可選Stirng100賬號(hào)2.21orgaid可選String32用戶所在機(jī)構(gòu)學(xué)校id2.22orgname可選String200用戶所在機(jī)構(gòu)學(xué)校名稱2.23classlist可選String2.23.1classid必選String32用戶所在班級(jí)ID2.23.2classname必選String200用戶所在班級(jí)名稱返回結(jié)果例子“result”: “000000”,“ueserinfo”: “personid”: “cbdf195ddd1c40efbd3c

38、48ca97c0cbe2”,“mobnum”: ,“birthday”: “,“gender”: “1”,“name”: “Testss10”,“usertype”: “5”,“credtype”: “0 “,“idcardno”: ,“fnascount”: 0,“userlogolist”: ,“account”: “Testss10” 獲取用戶好友接口說明應(yīng)用可以調(diào)用查詢用戶好友接口，在用戶授權(quán)的情況下，可以在福建省教育資源公共服務(wù)平臺(tái)上查詢用戶的好友信息。請(qǐng)求說明url:20001/aam/rest/queryFrien

39、dsReq?token=xxxxxxxx格式-協(xié)議Post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用平臺(tái)參數(shù)說明序號(hào)字段名約束類型長度說明1personid必選string64用戶ID2start可選String64查詢開始位置，不填默認(rèn)為03end可選String64查詢結(jié)束位置，不填默認(rèn)為104platformcode可選String64平臺(tái)區(qū)域碼 “personid”: “49659461d4094c7f830204175588e2ea”,“start”: “0”,“end”:“10”,“platformcode”:“100001”返回說明序號(hào)字段名約束類型長度說明1result

40、必選string6結(jié)果000000:成功301001:用戶不存在2start必選int查詢開始位置3end必選int查詢結(jié)束位置4count必選int總記錄條數(shù)5list可選成員信息列表5.1peronsid可選String32用戶id5.2account可選String20用戶名5.3name可選string32用戶姓名5.4connecthetime可選date32關(guān)注時(shí)間，我主動(dòng)關(guān)注他的時(shí)間5.5connectmetime可選string100關(guān)注時(shí)間，他關(guān)注我的時(shí)間5.6userlogolist可選-頭像LOGO（URL地址）列表5.6.1logotype可選int1頭像類型：1：??；

41、2：中；3：大；5.6.2logourl可選string512頭像LOGO（URL地址）返回結(jié)果例子“retcode”:“000000”, “count”:“2”,“start”:“0”,“end”:“10”,“l(fā)ist”: “personid”:“1289301erwopUJYHDW24”,“areacode”:“510000”“mobNum“: ,“email”: “123456”,“name”: “test”, “personid”:“1289301erwopUJYHDW23”,“areacode”:“510000”“mobNum“:

42、,“email”: “1234567”,“name”: “test2” ,驗(yàn)證用戶是否為好友接口說明應(yīng)用可以調(diào)用驗(yàn)證用戶是否為好友接口，驗(yàn)證是否為好友請(qǐng)求說明url :22015/aam/rest/validaFriendsReq?token=xxxxxxxx格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用平臺(tái)參數(shù)說明序號(hào)參數(shù)名稱是否必須類型描述1personid必須String用戶id2friendid必選String好友的用戶id3platformcode可選String平臺(tái)區(qū)域碼返回說明返回碼含義說明000000驗(yàn)證成功，為好友關(guān)系301001用戶不存在3011

43、22好友不存在字段說明字段名約束類型說明result必選string返回碼desc可選String返回消息說明返回結(jié)果例子“result”:“000000”, “desc”:“驗(yàn)證成功” 查詢班級(jí)信息接口描述根據(jù)班級(jí)ID查詢班級(jí)信息請(qǐng)求說明url:20001/aam/rest/queryClassInfoReq?token=xxxxxxxx支持驗(yàn)證方式格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向展現(xiàn)平臺(tái)參數(shù)說明序號(hào)字段名約束類型長度說明1classids必選Json數(shù)組-班級(jí)id的JSON數(shù)組，一個(gè)或多個(gè)2platformcode可選String6平臺(tái)編碼classi

44、ds:00d81f28cdbf412c8757a3b92ffeed48,19e0f91aaf224fb28a712537418a379c,5e5ed67bc84b4b10ba5bce8d4bd12385,platformcode:000000返回說明序號(hào)字段名約束類型長度說明1result必選string6結(jié)果000000:查詢成功2desc可選 string50返回描述3classinfolist可選班級(jí)信息JSON數(shù)組3.1classid可選string32班級(jí)ID3.2orgaid可選string32所屬機(jī)構(gòu)/學(xué)校編號(hào)3.3classname可選string50班級(jí)名稱3.4gradec

45、lass可選int2班別相應(yīng)的數(shù)字，代表相應(yīng)班別，如：1代表1班3.5grade可選int2年級(jí)1:一年級(jí)2：二年級(jí)3：三年級(jí)4：四年級(jí)5：五年級(jí)6：六年級(jí)7：初一8：初二9：初三10：高一11：高二12：高三3.6foundtime可選string32成立年份3.7created可選string32創(chuàng)建時(shí)3.8membercount可選int6成員數(shù)3.9classmanager可選string32班級(jí)管理員信息3.9.1personid可選string32管理員用戶ID3.9.2name可選string50管理員姓名3.10headteacher可選string32班主任信息3.10.1p

46、ersonid可選string32班主任用戶ID3.10.2name可選string50班主任姓名3.11classmonitor可選string50班長信息3.11.1personid可選string32班長用戶ID3.11.2name可選string50班長姓名3.12teacherlist可選String50班級(jí)教師信息3.12.1personid可選string32教師用戶ID3.12.2name可選string50教師姓名3.13classalises可選string50班級(jí)別名3.14flagpic可選string256班級(jí)標(biāo)識(shí)圖片(URL)3.15classcate可選strin

47、g1班級(jí)類型0：普通班1：實(shí)驗(yàn)班查詢班級(jí)成員信息接口描述查詢成員信息。請(qǐng)求說明urlHYPERLINK 1:16001/aam/rest/queryClassMemberReq?:20001/aam/rest/queryClassMemberReq?token=xxxxxxxx支持驗(yàn)證方式格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向展現(xiàn)平臺(tái)參數(shù)說明序號(hào)字段名約束類型長度說明1classid必選string-班級(jí)id 2start必選int記錄開始數(shù)3end必選int記錄結(jié)束數(shù)4platformcode可選string平臺(tái)編碼 中央平臺(tái)：000000示例：classid

48、:00d81f28cdbf412c8757a3b92ffeed48,“start”:”0”,end:10,platformcode:000000,返回說明序號(hào)字段名約束類型長度說明1result必選string6結(jié)果000000:成功2start必選int查詢開始位置3end必選int查詢結(jié)束位置4count必選int總記錄條數(shù)5userinfo可選5.1personid必選string60用戶的統(tǒng)一ID；5.2mobnum可選string16手機(jī)號(hào)碼5.3email可選string16郵箱5.4name可選string32用戶姓名5.5usertype必選string1用戶類型學(xué)生:0老師:

49、15.6teachesubjectlist可選 Json數(shù)組50如用戶為教師，則返回所教學(xué)科，JSON數(shù)組5.6.1subjectid可選String32學(xué)科id5.6.2subjectname可選String50學(xué)科名稱5.6.3teachmaterialid可選string32教材id5.6.4teachmaterialname可選String200教材名稱用戶登錄（C/S模式應(yīng)用）接口描述C/S系統(tǒng)調(diào)用該接口實(shí)現(xiàn)用戶帳號(hào)登錄，密碼可以是靜態(tài)密碼也可以是動(dòng)態(tài)密碼。請(qǐng)求說明url HYPERLINK /aam/rest/account/login :20001/aam/rest/accoun

50、t/login?token=xxxxxxxx支持驗(yàn)證方式格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用AAM參數(shù)說明序號(hào)字段名約束類型長度說明1account必選string128注冊(cè)賬號(hào)。2password必選string32靜態(tài)密碼或動(dòng)態(tài)密碼；靜態(tài)密碼加密方式：MD5加密后字母字符為大寫的字符串，再經(jīng)過RC4加密(加密的密鑰user_sercretkey)；密碼經(jīng)過加密后再傳輸；動(dòng)態(tài)密碼登錄時(shí)，為明文。當(dāng)采用靜態(tài)密碼或動(dòng)態(tài)密碼方式認(rèn)證時(shí)，必選。3passwdtype可選string4密碼類型：默認(rèn)是00：靜態(tài)密碼1：動(dòng)態(tài)密碼4portaltype必選string

51、1登陸來源99：其他例如：HYPERLINK /aam/rest/account/login:20001/aam/rest/account/login?token=xxxxxxxx account:aa12321,password:aKvpxU1LekEffCbAE5rntY11I3Mlgj2n0QK8OiyRrRDeL6hB8G8ivc5AM+TABiGvH9nRqN/GWJ26JbA,portaltype:0返回說明序號(hào)字段名約束類型長度說明1result必選string6訂購結(jié)果000000:成功301001:用戶不存在2desc可選string250結(jié)果描述3tgcticke可選Str

52、ing64永久Ticket，唯一標(biāo)識(shí)一個(gè)登錄用戶4usessionid可選String64唯一標(biāo)識(shí)一個(gè)登錄用戶sessionid5ueserinfo可選5.1personid必選string60用戶的統(tǒng)一ID；5.2mobnum可選string16手機(jī)號(hào)碼5.3email可選string16郵箱5.4name可選string32用戶姓名5.5nickname可選string100昵稱5.6areacode可選string64用戶歸屬地區(qū)域5.7name可選string16姓名5.8gender可選string1性別0是女，1為男5.9birthday可選date16生日5.10usertype

53、必選string1用戶類型:學(xué)生:0老師:1家長:2機(jī)構(gòu):3學(xué)校：4學(xué)校工作人員：5機(jī)構(gòu)工作人員：65.11address可選string256通訊地址5.12postcode可選string8郵編5.13userlogolist可選-頭像LOGO（URL地址）列表5.13.1logotype可選int1瀏覽渠道：1：?。?：中；3：大；5.13.2logourl可選string512頭像LOGO（URL地址）5.14interests可選string512興趣，多個(gè)興趣之間用分號(hào)分開5.15profession可選string64職業(yè)5.16credtype可選string10：身份證1:護(hù)

54、照2:軍人證3:其他5.17idcardno可選string32證件號(hào)碼5.18singature可選string140簽名5.19fnascount可選int 粉絲數(shù)5.20teachesubjectlist可選 Json數(shù)組50如登錄用戶為教師，則返回所教學(xué)科，JSON數(shù)組5.20.1subjectid可選String32學(xué)科id5.20.2subjectname可選String50學(xué)科名稱5.20.3teachmaterialid可選string32教材id5.20.4teachmaterialname可選String200教材名稱5.20.5classid可選string32用戶所在班

55、級(jí)id5.20.6classname可選string50班級(jí)名稱5.20.7foundtime可選string4班級(jí)成立年份5.21classid可選string50用戶所在班級(jí)名稱5.22classname可選string50班級(jí)名稱5.23classidentity可選JOSN數(shù)組2用戶所在班級(jí)身份: 1:班主任 2：班長 3：管理員4: 教師 5：成員 6：教研員，7：教務(wù)員，8：信息員5.24orgaid可選string32用戶所在機(jī)構(gòu)學(xué)校id5.25organame可選string200用戶所在機(jī)構(gòu)學(xué)校名稱5.26orgaidentity可選string2用戶在機(jī)構(gòu)身份：1:管理員2

56、：成員3：教研員；4：教務(wù)員；5：信息員，5.27tags可選string1000個(gè)人標(biāo)簽5.28areacode可選string8所在地區(qū)編碼查詢班級(jí)列表接口描述根據(jù)機(jī)構(gòu)ID或班級(jí)ID查詢班級(jí)列表請(qǐng)求說明url:20001/aam/rest/queryClassInfoListReq?token=xxxxxxxx支持驗(yàn)證方式格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用平臺(tái)參數(shù)說明序號(hào)字段名約束類型長度說明1orgaid可選string64可為機(jī)構(gòu)ID、學(xué)校ID2start可選string20查詢開始記錄下標(biāo)3end可選string30查詢結(jié)束記錄下標(biāo)4class

57、ids可選String20班級(jí)id的JSON數(shù)組，一個(gè)或多個(gè)5platformcode可選String平臺(tái)編碼返回說明序號(hào)字段名約束類型長度說明1result必選string6結(jié)果000000:成功2start必選String8查詢開始位置3end必選String8查詢結(jié)束位置4count必選String8總記錄條數(shù)5classinfolist可選班級(jí)信息列表5.1classid可選string32班級(jí)ID5.2orgaid可選string32所屬機(jī)構(gòu)/學(xué)校編號(hào)5.3classname可選string20班級(jí)名稱5.4gradeclass可選int班別相應(yīng)的數(shù)字，代表相應(yīng)班別，如：1代表1班5

58、.5grade可選int年級(jí)1:一年級(jí)2：二年級(jí)3：三年級(jí)4：四年級(jí)5：五年級(jí)6：六年級(jí)7：初一8：初二9：初三10：高一11：高二12：高三5.6foundtime可選string32成立年份5.7jointype可選string1加入方式;1：申請(qǐng)加入；2：邀請(qǐng)加入; 3:輸入驗(yàn)證碼加入5.8joinvalinum可選string20加入驗(yàn)證碼5.9invitepermi可選string1邀請(qǐng)權(quán)限；1：成員可邀請(qǐng)其他人加入2：只有班主任或班長邀請(qǐng)加入5.10created可選string32創(chuàng)建時(shí)間5.11membercount可選int成員數(shù)5.12classmanager可選strin

59、g32管理員，用戶ID5.12.1personid可選string32用戶ID5.12.2name可選string10姓名5.13headteacher可選string32班主任，用戶ID5.13.1personid可選string32用戶ID5.13.2name可選string10姓名5.14classmonitor可選string32班長，用戶id5.14.1personid可選string32用戶ID5.14.2name可選string10姓名5.15teacherlist可選String32班級(jí)教師，用戶ID數(shù)組5.15.1personid可選string32用戶ID5.15.2nam

60、e可選string10姓名5.16classalises可選string50班級(jí)別名5.17flagpic可選string256班級(jí)標(biāo)識(shí)圖片(URL)5.18classcate可選string1班級(jí)類型0：普通班1：實(shí)驗(yàn)班查詢班級(jí)學(xué)生接口描述查詢學(xué)校班級(jí)學(xué)生請(qǐng)求說明urlHYPERLINK 1:16001/aam/rest/queryClassStudentReq:20001/aam/rest/queryClassStudentReq?token=xxxxxxxx支持驗(yàn)證方式-格式j(luò)son協(xié)議post是否需要鑒權(quán)true請(qǐng)求數(shù)限制true接口方向應(yīng)用平臺(tái)參數(shù)說明序號(hào)字段名約束類型長度說明1sc