(高清版)GB∕T 38863-2020 干部網(wǎng)絡培訓 平臺數(shù)據(jù)接口技術要求

L67中華人民共和國國家標準干部網(wǎng)絡培訓平臺數(shù)據(jù)接口技術要求oT國家市場監(jiān)督管理總局國家標準化管理委員會ⅠGB／T38863—2020前言 2規(guī)范性引用文件 3術語和定義 4縮略語 5數(shù)據(jù)類型 5.1基本數(shù)據(jù)類型 7數(shù)據(jù)參數(shù) 7.3平臺基本數(shù)據(jù) 7.4系統(tǒng)事件類別 8接口服務 8.1接口管理服務 8.2數(shù)據(jù)推送同步接口服務 8.3數(shù)據(jù)查詢接口服務 附錄A（資料性附錄）接口樣例 附錄B（規(guī)范性附錄）平臺數(shù)據(jù)接口清單 附錄C（規(guī)范性附錄）異常狀態(tài)碼 ⅢGB／T38863—2020本標準按照GB/T1.1—2009給出的規(guī)則起草。請注意本文件的某些內容可能涉及專利。本文件的發(fā)布機構不承擔識別這些專利的責任。本標準由中共中央組織部提出并歸口。本標準起草單位：華中師范大學、華東師范大學、北京郵電大學、中國電信集團有限公司、中國電子技術標準化研究院。1GB／T38863—2020干部網(wǎng)絡培訓平臺數(shù)據(jù)接口技術要求本標準規(guī)定了干部網(wǎng)絡培訓機構平臺之間的接口服務及接口數(shù)據(jù)參數(shù)。本標準適用于干部網(wǎng)絡培訓機構平臺之間的數(shù)據(jù)傳輸和交換。2規(guī)范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T中國各民族名稱的羅馬字母拼寫法和代碼GB/T政治面貌代碼GB/T數(shù)據(jù)元和交換格式信息交換日期和時間表示法GB/T職務級別代碼GB/T信息技術通用多八位編碼字符集(UCS)GB32100—2015法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則GB/T38856—2020干部網(wǎng)絡培訓業(yè)務管理通用要求GB/T38858—2020干部網(wǎng)絡培訓平臺數(shù)據(jù)要求3術語和定義GB/T38856—2020、GB/T38858—2020界定的術語和定義適用于本文件。4縮略語下列縮略語適用于本文件。增強現(xiàn)實(混合現(xiàn)實(頁面瀏覽量(專題班(統(tǒng)一資源定位符(統(tǒng)一社會信用代碼(虛擬現(xiàn)實(5數(shù)據(jù)類型5.1基本數(shù)據(jù)類型本標準中使用的數(shù)據(jù)類型和可取值見表1。２GB／T38863—2020表1數(shù)據(jù)類型的取值類型表示說明字符型Ｃ以字符表達的數(shù)據(jù)元值的類型，可用于表達字母、數(shù)字、漢字和其他字符形式數(shù)值型Ｎ以任意實數(shù)表達的數(shù)據(jù)元值的類型日期型Ｄ以日期和時間表達的數(shù)據(jù)元值的類型，符合—以-的形式表達集合Ｓ用于存放其他數(shù)據(jù)的容器，集合中可包含屬性和其他集合指從業(yè)務的角度規(guī)定的數(shù)據(jù)元值的格式需求，包括所允許的最大或／和最小字符長度、數(shù)據(jù)元值的表示格式等。數(shù)據(jù)格式中使用的字符含義如下：進制最大位數(shù)；字符串“”表示長度不確定；逗號“，”隔開的兩個自然數(shù)“”表示數(shù)值最大ｐ個十進制位數(shù)，小數(shù)點后ｑ位；雙點號“”表示從最小長度到最大長度，前面附加最小長度，后面附加最大長度；字符串表示小時，“”表示分鐘，可以視實際情況組合使用。值域是根據(jù)相應屬性中規(guī)定的數(shù)據(jù)類型、長度而決定的數(shù)據(jù)元的允許值的集合。該集合可通過以下方式給出：—通過參考和引用相關標準；—通過文字描述給出值域的限制；—通過一一列舉的方式給出所有可能的取值以及每一個值對應的實例或含義；—通過規(guī)則間接給出。用戶可根據(jù)需要自行擴展和定義數(shù)據(jù)類型。干部網(wǎng)絡培訓機構平臺之間通過接口服務進行數(shù)據(jù)傳輸。接口服務分為三大類：接口管理服務、數(shù)據(jù)推送同步接口服務和數(shù)據(jù)查詢接口服務，如圖１所示。3GB／T38863—2020圖1干部網(wǎng)絡培訓機構平臺數(shù)據(jù)接口干部網(wǎng)絡培訓機構平臺是數(shù)據(jù)服務交互過程的參與實體，所提供的服務包括管理服務和學習服務，服務請求的發(fā)起者為“服務發(fā)起方”，服務請求的提供者為“服務提供方”。干部網(wǎng)絡培訓機構平臺之間的數(shù)據(jù)服務主要包括：—接口管理服務：處理服務發(fā)起方和服務提供方之間的應用請求；—數(shù)據(jù)推送同步接口服務：處理參與實體間的數(shù)據(jù)同步請求；—數(shù)據(jù)查詢接口服務：處理服務發(fā)起方的查詢請求，并由服務提供方返回結果。報文樣例參見附錄A。平臺數(shù)據(jù)接口服務清單見附錄B。系統(tǒng)異常狀態(tài)碼見附錄C。7數(shù)據(jù)參數(shù)請求報文的數(shù)據(jù)參數(shù)見表2,請求報文樣例參見A.1。表2請求報文的數(shù)據(jù)參數(shù)數(shù)據(jù)塊中文名稱英文名稱定義說明（數(shù)據(jù)頭）平臺編號platformID干部網(wǎng)絡培訓平臺的唯一標識平臺私鑰platformKey干部網(wǎng)絡培訓平臺所擁有的私鑰自定義擴展信息extension數(shù)據(jù)頭的可擴展的自定義信息（數(shù)據(jù)體）推送數(shù)據(jù)類別接口推送的數(shù)據(jù)內容分類類別數(shù)據(jù)體哈希值數(shù)據(jù)流的哈希值用于請求報文數(shù)據(jù)一致性校驗數(shù)據(jù)偏移值offset讀取數(shù)據(jù)時的偏移值數(shù)據(jù)長度讀取數(shù)據(jù)體內容的長度數(shù)據(jù)體內容報文中所包含的業(yè)務數(shù)據(jù)數(shù)據(jù)體全部采用數(shù)組形式4GB／T38863—2020響應報文以加密數(shù)據(jù)的形式傳輸，數(shù)據(jù)參數(shù)見表3,響應報文樣例參見A.2。表3響應報文的數(shù)據(jù)參數(shù)中文名稱英文名稱定義說明響應結果請求是否成功響應的狀態(tài)標識出錯信息errorMessage響應不成功時反饋的消息字符串哈希值加密數(shù)據(jù)的校驗碼數(shù)組數(shù)量加密數(shù)據(jù)如果是數(shù)組時的數(shù)組數(shù)量返回值hasData加密數(shù)據(jù)是否有返回值返回值是否是數(shù)組加密數(shù)據(jù)的數(shù)據(jù)結構是否是數(shù)組加密數(shù)據(jù)encryptData數(shù)據(jù)加密后的內容擴展數(shù)據(jù)extension可擴展的自定義信息7.3平臺基本數(shù)據(jù)接口傳輸所涉及的平臺基本數(shù)據(jù)內容見表4。表4平臺基本數(shù)據(jù)表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1平臺標識符platformID干部網(wǎng)絡培訓平臺的唯一標識符MC2域名用于在數(shù)據(jù)傳輸時標識計算機的電子方位MC3平臺名稱platformName干部網(wǎng)絡培訓平臺的名稱MC4組織機構標識符organizationID機構具有的唯一標識符MC5平臺地址platformURL服務平臺接口地址MC6管理員編號managerID平臺管理員的唯一標識符MC成的唯一用戶編碼）7狀態(tài)status平臺狀態(tài)MC狀態(tài)標識7.4系統(tǒng)事件類別系統(tǒng)事件類別見表5。5GB／T38863—2020表5系統(tǒng)事件類別枚舉值說明dataOfUserCreated學員信息新建dataOfUserModified學員信息變更培訓信息新建trainingInfoUpdated培訓信息變更可根據(jù)需要自行擴展和定義事件類別。7.5數(shù)據(jù)類別數(shù)據(jù)類別是接口報文數(shù)據(jù)體中推送數(shù)據(jù)內容的類別，見表6。表6數(shù)據(jù)類別枚舉值說明loginStat登錄人次統(tǒng)計數(shù)據(jù)visitStat頁面瀏覽量統(tǒng)計數(shù)據(jù)PVstat首頁訪問量統(tǒng)計數(shù)據(jù)registerStat激活學員統(tǒng)計數(shù)據(jù)courseStat課程統(tǒng)計數(shù)據(jù)creditHourStat學時統(tǒng)計數(shù)據(jù)TBTPstat專題班統(tǒng)計數(shù)據(jù)TBTPcreditHourStat專題班學時統(tǒng)計數(shù)據(jù)TBTPregisterStat專題班報名人數(shù)統(tǒng)計數(shù)據(jù)TBTPgraduateStat專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)userInfo學員基本信息數(shù)據(jù)userAccountInfo學員賬號信息數(shù)據(jù)organizationInfo組織機構數(shù)據(jù)courseInfo課程信息數(shù)據(jù)courseLearningRecord課程學習結果記錄TBTPinfo專題班信息數(shù)據(jù)TBTPcourseInfo專題班課程數(shù)據(jù)TBTPcourseLearningRecord專題班課程學員學習記錄TBTPcertificateInfo專題班學習結果記錄6GB／T38863—20208接口服務8.1接口管理服務注冊服務請求接口的基本信息包括：—接口說明：服務發(fā)起方向服務提供方請求事件通知的回調地址，用于動態(tài)注冊，支持批量操作；—實時性要求：即時同步；—接口參數(shù)：注冊服務請求接口參數(shù)見表7;—接口請求：注冊服務請求的接口請求見表8,請求樣例參見A.3;—接口響應：注冊服務請求的接口響應見表9,響應樣例參見A.4。表7注冊服務請求接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeN/A表8注冊服務請求接口請求表中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明事件系統(tǒng)事件類別MC事件類別，何種事件觸發(fā)時回調枚舉值，參見表5地址URL回調服務器的地址MC表9注冊服務請求接口響應表中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明響應結果響應是否成功的結果代碼MC響應是否成功消息MC響應如果不成功，返回失敗信息，異常狀態(tài)碼見表C.1擴展服務extensionService可擴展的自定義服務信息OC取消注冊請求接口的基本信息包括：7GB／T38863—2020—接口說明：服務發(fā)起方向服務提供方請求取消事件通知服務的回調地址，用于取消注冊，支持批量操作；—實時性要求：即時同步；—接口參數(shù)：取消注冊請求接口參數(shù)見表10;—接口請求：取消注冊請求的接口請求見表11,請求樣例參見A.5;—接口響應：取消注冊請求的接口響應見表3。表10取消注冊請求接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeN/A表11取消注冊請求接口請求表中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明事件系統(tǒng)事件類別OC需要取消的事件類別，參見表58.2數(shù)據(jù)推送同步接口服務8.2.1平臺運行統(tǒng)計數(shù)據(jù)接口登錄人次統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺學員登錄統(tǒng)計數(shù)據(jù)；—實時性要求：無；—接口參數(shù)：登錄人次統(tǒng)計數(shù)據(jù)接口參數(shù)見表12;—接口請求：登錄人次統(tǒng)計數(shù)據(jù)的接口請求見表13,請求樣例參見A.6;—接口響應：登錄人次統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表12登錄人次統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeloginStat8GB／T38863—2020表13登錄人次統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符ID培訓機構使用的組織機構標識符MC22currentDate統(tǒng)計數(shù)據(jù)的日期MGB/TD數(shù)據(jù)格式為YYYYMMDD23當日前累計登錄人次yesterdayLogin-CountSum平臺當日的前一天累計的登錄人次MN含移動端24當日登錄總人次PVcurrentLogin-CountSum人次MN含移動端25登錄總人次平臺登錄的總人次MN含移動端26當日前累計移動終端登錄人次yesterdayMobile-平臺當日的前一天累計的登錄人次MN27當日移動終人次mobilePVcurrent-人次MN28移動終端登錄總人次Sum移動終端登錄平臺的總人次ON8.2.1.2頁面瀏覽量統(tǒng)計數(shù)據(jù)接口頁面瀏覽量統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方上傳本平臺頁面瀏覽量統(tǒng)計數(shù)據(jù)；—實時性要求：無；—接口參數(shù)：頁面瀏覽量統(tǒng)計數(shù)據(jù)接口參數(shù)見表14;—接口請求：頁面瀏覽量統(tǒng)計數(shù)據(jù)的接口請求見表15,請求樣例參見A.6;—接口響應：頁面瀏覽量統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表14頁面瀏覽量統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typevisitStat9GB／T38863—2020表15頁面瀏覽量統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM31當日前累計平臺訪問總人次干部網(wǎng)絡培訓平臺當日的前一天累計的總頁面瀏覽量MN32總人次PVcurrentCountSum平臺當日的總頁面瀏覽數(shù)MN33人次PVcountSum平臺的總頁面瀏覽數(shù)MN課程瀏覽數(shù)不計算在內8.2.1.3首頁訪問量統(tǒng)計數(shù)據(jù)接口首頁訪問量統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方上傳本平臺首頁訪問量統(tǒng)計數(shù)據(jù)；—實時性要求：無；—接口參數(shù)：首頁訪問量統(tǒng)計數(shù)據(jù)接口參數(shù)見表16;—接口請求：首頁訪問量統(tǒng)計數(shù)據(jù)的接口請求見表17,請求樣例參見A.6;—接口響應：首頁訪問量統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表16首頁訪問量統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typePVstat表17首頁訪問量統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM41當日前累計平臺首頁訪問總人次yesterdayPV本平臺當日的前一天累計的首頁訪問量MN42當日首頁訪問總人次PVcurrent平臺當日首頁面的瀏覽數(shù)ON43平臺首頁訪問總人次PV平臺首頁面的瀏覽數(shù)ONGB／T38863—20208.2.1.4激活學員統(tǒng)計數(shù)據(jù)接口激活學員統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺學員已激活賬戶的統(tǒng)計數(shù)據(jù)；—實時性要求：無；—接口參數(shù)：激活學員統(tǒng)計數(shù)據(jù)接口參數(shù)見表18;—接口請求：激活學員統(tǒng)計數(shù)據(jù)的接口請求見表19,請求樣例參見A.6;—接口響應：激活學員統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表18激活學員統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeregisterStat表19激活學員統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM51當日前累計激活人數(shù)yesterdayRegisterSum該培訓機構當日的前一天累計的激活的人數(shù)MN52當日激活學員數(shù)currentRegisterSum平臺當日新激活學員總數(shù)MN53激活學員數(shù)registerSum在平臺上激活后處于正常狀態(tài)的學員總數(shù)MN課程統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺擁有的課程統(tǒng)計數(shù)據(jù)；—實時性要求：無；—接口參數(shù)：課程統(tǒng)計數(shù)據(jù)接口參數(shù)見表20;—接口請求：課程統(tǒng)計數(shù)據(jù)的接口請求見表21,請求樣例參見A.6;—接口響應：課程統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。GB／T38863—2020表20課程統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typecourseStat表21課程統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM61當日前累計課程總數(shù)平臺當日的前一天累計的可以供學員學習的課程總數(shù)MN62當日課程總數(shù)currentCourseSum平臺當日新發(fā)布課程總數(shù)MN63課程總數(shù)courseSum在平臺上可以供學員學習的課程總數(shù)MN學時統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺學員獲取的學時總數(shù)統(tǒng)計數(shù)據(jù)；—實時性要求：無；—接口參數(shù)：學時統(tǒng)計數(shù)據(jù)接口參數(shù)見表22;—接口請求：學時統(tǒng)計數(shù)據(jù)的接口請求見表23,請求樣例參見A.6;—接口響應：學時統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表22學時統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typecreditHourStat表23學時統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符MGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明22currentDateM71當日前累計課程學習總學時本平臺當日的前一天累計的所有學員獲取的學時總數(shù)MN72當日課程學習總學時currentCreditHourSum平臺當日課程學習的總學時MN73學時總數(shù)creditHourSum平臺所有學員獲取的學時總數(shù)MN專題班統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺專題班統(tǒng)計數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：專題班統(tǒng)計數(shù)據(jù)接口參數(shù)見表24;—接口請求：專題班統(tǒng)計數(shù)據(jù)的接口請求見表25,請求樣例參見A.6;—接口響應：專題班統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表24專題班統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPStat表25專題班統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM81當日前累計專題班總數(shù)yesterdayTBTPsum在平臺上當日的前一天累積的可以供學員學習的專題班總數(shù)MN82當日專題班總數(shù)TBTPcurrentSum平臺當日新開班的專題班總數(shù)MN83專題班總數(shù)TBTPsum在平臺上可以供學員學習的專題班總數(shù)MN僅涉及已發(fā)布的專題班GB／T38863—20208.2.1.8專題班學時統(tǒng)計數(shù)據(jù)接口專題班學時統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺專題班所有學員學時統(tǒng)計數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：專題班學時統(tǒng)計數(shù)據(jù)接口參數(shù)見表26;—接口請求：專題班學時統(tǒng)計數(shù)據(jù)的接口請求見表27,請求樣例參見A.6;—接口響應：專題班學時統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表26專題班學時統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPcreditHourStat表27專題班學時統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM91專題班學時總數(shù)TBTPcreditHourSum平臺所有已發(fā)布的專題班的學時累加總數(shù)MN8.2.1.9專題班報名人數(shù)統(tǒng)計數(shù)據(jù)接口專題班報名人數(shù)統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺專題班報名人數(shù)統(tǒng)計數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：專題班報名人數(shù)統(tǒng)計數(shù)據(jù)接口參數(shù)見表28;—接口請求：專題班報名人數(shù)統(tǒng)計數(shù)據(jù)的接口請求見表29,請求樣例參見A.6;—接口響應：專題班報名人數(shù)統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表28專題班報名人數(shù)統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPregisterStatGB／T38863—2020表29專題班報名人數(shù)統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM1當日前累計專題班報名總人數(shù)yesterdayEnrollmentSum當日的前一天平臺累計報名參加專題班的所有學員總人數(shù)MN2當日專題班報名總人數(shù)TBTPcurrentEnrollmentSum平臺當日參加專題班的學員總人數(shù)MN3專題班報名總人數(shù)enrollmentSum專題班報名學員總數(shù)MN8.2.1.10專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)接口專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)接口參數(shù)見表30;—接口請求：專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)的接口請求見表31,請求樣例參見A.6;—接口響應：專題班結業(yè)人次統(tǒng)計數(shù)據(jù)的接口響應見表3,響應樣例參見A.7。表30專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPgraduateStat表31專題班結業(yè)人數(shù)統(tǒng)計數(shù)據(jù)接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明21培訓機構標識符M22currentDateM1當日前累計專題班結業(yè)人數(shù)yesterdayTBTPgraduateSum本平臺當日的前一天專題班結業(yè)累計人數(shù)MN2當日專題班結業(yè)總人數(shù)TBTPcurrentGraduateSum平臺當日專題班結業(yè)學員總人數(shù)MN3專題班結業(yè)總人數(shù)TBTPGraduateSum專題班結業(yè)學員總數(shù)MNGB／T38863—20208.2.2學員信息數(shù)據(jù)同步接口8.2.2.1學員基本信息數(shù)據(jù)同步接口學員基本信息數(shù)據(jù)同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送學員基本信息數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：學員基本信息數(shù)據(jù)同步接口參數(shù)見表32;—接口請求：學員基本信息數(shù)據(jù)同步的接口請求見表33,請求樣例參見A.6;—接口響應：學員基本信息數(shù)據(jù)同步的接口響應見表3,響應樣例參見A.7。表32學員基本信息數(shù)據(jù)同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeuserInfo表33學員基本信息數(shù)據(jù)同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationType本次數(shù)據(jù)同步操作的類型M操作類型可選：UPDATE：變更；DELETE：刪除C2學員標識符traineeID每個學員具有唯一的標識符，該標識符也是各平臺中識別學員的依據(jù)MC3學員姓名traineeName學員的真實姓名MC人事檔案中記用的學員姓名全稱4出生年月birthDate學員的出生年月OGB/TD數(shù)據(jù)格式為YYYYMM5性別學員的性別O包含以下幾種：C6民族nationality學員所屬的民族OGB/TC7政治面貌學員的政治面貌MGB/TCGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明8職務學員在所屬機構中擔任的職務OC9所屬單位標識符學員所屬單位的組織機構標識符MC組織機構標識符的編碼應遵守本標準中的規(guī)則職級學員的職級O職務級別代碼應遵循GB/T12407—2008,若不在規(guī)定的范圍內，則：C人員狀態(tài)userStatus學員目前在單位中所處的狀態(tài)O包含以下幾種：處于工作狀態(tài)處于離退休狀態(tài)已從本單位調出C干部類別干部培訓對象的類別M包含以下幾種：級以上）以下）3：企業(yè)領導人員人員干部6：專業(yè)技術人員C8.2.2.2學員賬號信息數(shù)據(jù)同步接口學員賬號信息數(shù)據(jù)同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送學員賬號信息數(shù)據(jù)；—實時性要求：即時同步；GB／T38863—2020—接口參數(shù)：學員賬號信息數(shù)據(jù)同步接口參數(shù)見表34;—接口請求：學員賬號信息數(shù)據(jù)同步的接口請求見表35,請求樣例參見A.6;—接口響應：學員賬號信息數(shù)據(jù)同步的接口響應見表3,響應樣例參見A.7。表34學員賬號信息數(shù)據(jù)同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeuserAccountInfo表35學員賬號信息數(shù)據(jù)同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationTypeM2學員標識符traineeIDM1賬號學員的登錄賬號MC賬號具有唯一性。賬號的命名可以包含大小寫字母、數(shù)字，不可使用特殊字符2密碼password學員的登錄密碼OC根據(jù)實際情況慎重確定3手機號學員登記在系統(tǒng)中的手機號OC手機號碼錄入系統(tǒng)時需要校驗，應真實有效4賬號狀態(tài)accountStatus學員賬號的當前狀態(tài)M包含以下幾種：C5激活時間registerTime學員賬號的首次激活時間OGB/TD數(shù)據(jù)格式為YYYY-MMDDhhmm8.2.3組織機構數(shù)據(jù)同步接口組織機構數(shù)據(jù)同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送已有組織機構數(shù)據(jù)，接收方比對雙方數(shù)據(jù)，并發(fā)回增量數(shù)據(jù)以實現(xiàn)同步；—實時性要求：即時同步；—接口參數(shù)：組織機構數(shù)據(jù)同步接口參數(shù)見表36;—接口請求：組織機構數(shù)據(jù)同步的接口請求見表37,請求樣例參見A.6;—接口響應：組織機構數(shù)據(jù)同步的接口響應見表3,響應樣例參見A.7。GB／T38863—2020表36組織機構數(shù)據(jù)同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeorganizationInfo表37組織機構數(shù)據(jù)同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationTypeM4組織機構標識符organizationIDM1組織機構名稱organizationName該機構的正式全稱MC2組織機構簡稱該機構的正式簡稱MC3上級組織機構標識符該機構上級單位的組織機構標識符OC上級組織機構標識構則為“NULL”4統(tǒng)一社會信用代碼USCID機構法人的統(tǒng)一社會信用代碼OC統(tǒng)一社會信用代碼遵循GB32100—2015,若本機構非上級機構法人的統(tǒng)一社會信用代碼8.2.4課程數(shù)據(jù)同步接口8.2.4.1課程信息數(shù)據(jù)同步接口課程信息數(shù)據(jù)同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺課程信息數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：課程信息數(shù)據(jù)同步接口參數(shù)見表38;—接口請求：課程信息數(shù)據(jù)同步的接口請求見表39,請求樣例參見A.6;—接口響應：課程信息數(shù)據(jù)同步的接口響應見表3,響應樣例參見A.7。GB／T38863—2020表38課程信息數(shù)據(jù)同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typecourseInfo表39課程信息數(shù)據(jù)同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationTypeM1課程編號courseID課程的唯一標識符MC2課程名稱courseName課程的全稱MC3課程類別按照某種分類方法確定的課程所屬類別MC4課程關鍵字courseKeyword課程關鍵字字符串MC關鍵字間以半角逗號分隔5課程簡介courseIntroduction課程的簡單介紹MC6課程提供機構courseProvider提供課程的單位名稱MC21培訓機構標識符M7培訓機構名稱培訓機構的全稱MC8授課教師lecturers包括課程的主講教等主要信息列表MC9教師簡介lecturerIntroduction關于授課教師的簡單介紹OC發(fā)布日期publishDate課程上傳到網(wǎng)絡并激活的日期MGB/TD數(shù)據(jù)格式為YYYYMMDD停用日期offlineDate課程從網(wǎng)絡上刪除或者課程被停用的日期OGB/TD數(shù)據(jù)格式為YYYYMMDDGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明預計停用expireDate對于某些時效性強的課程，所預先設定的課程失效日期OGB/TD數(shù)據(jù)格式為YYYYMMDD課程形式courseForm課程的基本呈現(xiàn)形式O包含但不限于以下幾種：04:VR/AR/MRC學時creditHour課程經(jīng)認定的學時MN課程時長courseDuration預計學員完成課程學習所需要投入的時間ON程資源學習閱讀的時間課程考核方式課程的考核類型O包含以下幾種：C8.2.4.2課程學習結果記錄同步接口課程學習結果記錄同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送本平臺在線選學課程學習結果記錄信息；—實時性要求：即時同步；—接口參數(shù)：課程學習結果記錄同步接口參數(shù)見表40;—接口請求：課程學習結果記錄同步的接口請求見表41,請求樣例參見A.6;—接口響應：課程學習結果記錄同步的接口響應見表3,響應樣例參見A.7。表40課程學習結果記錄同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typecourseLearningRecordGB／T38863—2020表41課程學習結果記錄同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationTypeM21培訓機構標識符M7培訓機構名稱M1課程編號courseIDM2課程名稱courseNameM1專題班編號TBTPID專題班的唯一標識符MC若課程歸屬于某一專題時記錄專題班編號學時creditHourM2培訓方式trainingMode培訓開展的方式M包含但不限于以下幾種：C專題班開展的方式3課程類別O3學習類型learningType課程是否是選修課O類型如下：C4課程學習時長累積MN5課程通過總人數(shù)習的學員總數(shù)MN8.2.5專題班數(shù)據(jù)同步接口8.2.5.1專題班信息數(shù)據(jù)同步接口專題班信息數(shù)據(jù)同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送專題班信息數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：專題班信息數(shù)據(jù)同步接口參數(shù)見表42;—接口請求：專題班信息數(shù)據(jù)同步的接口請求見表43,請求樣例參見A.6;—接口響應：專題班信息數(shù)據(jù)同步的接口響應見表3,響應樣例參見A.7。GB／T38863—2020表42專題班信息數(shù)據(jù)同步接口參數(shù)表參數(shù)值接口地址方法表43專題班信息數(shù)據(jù)同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明１操作類型見表的Ｍ１專題班計劃編號專題班計劃的唯一標識符ＭＣ１專題班編號見表的Ｍ２專題班名稱專題班的全稱ＭＣ３內容簡介專題班的介紹ＭＣ４培訓對象允許參加專題班培訓的學員范圍ＭＣ５學習開始時間專題班的開始時間點Ｍ—Ｄ數(shù)據(jù)格式為６學習截止時間專題班的結束時間點Ｍ—Ｄ數(shù)據(jù)格式為７專題班狀態(tài)專題班的狀態(tài)Ｍ包含但不限種：未開始進行中已結束８專題班課程列表學員在專題班要求完成的課程列表ＯＣ列表格式為課程編號課程名稱…課程編號課程名稱９必修課考核要求專題班關于必修課完成數(shù)量和學時的要求ＭＣ選修課考核要求專題班關于選修課完成數(shù)量和學時的要求ＭＣGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明計劃學員人數(shù)專題班計劃培訓的人人員的總數(shù)ＭＮ學時要求專題班對于學員完成學時數(shù)量的要求ＭＮ主辦單位列表專題班主辦單位的組織機構列表ＭＣ列表格式為主辦單位標識符主辦單位名稱…，［主辦單位標識符主辦單位名稱承辦單位列表專題班承辦單位的組織機構列表ＭＣ列表格式為承辦單位標識符承辦單位名稱…，［承辦單位標識符承辦單位名稱協(xié)辦單位列表專題班協(xié)辦單位的組織機構列表ＯＣ列表格式為協(xié)辦單位標識符協(xié)辦單位名稱…，［協(xié)辦單位標識符協(xié)辦單位名稱指定學員名單列表指定學員名單列表ＯＣ報名人數(shù)專題班已報名人數(shù)ＯＮ報名人員列表列表ＯＣ結業(yè)人數(shù)專題班已結業(yè)人數(shù)ＭＮ專題班統(tǒng)計屬性ＭＳGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明結業(yè)學員列表所有結業(yè)人員的列表ＯＣ包括學員標識符、學員姓名、證書編號發(fā)證單位列表頒發(fā)專題班證書的單位列表ＭＣ列表格式為發(fā)證單位標識符發(fā)證單位名稱…，［發(fā)證單位標識符發(fā)證單位名稱專題班課程數(shù)據(jù)同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送專題班課程數(shù)據(jù)；—實時性要求：即時同步；—接口參數(shù)：專題班課程數(shù)據(jù)同步接口參數(shù)見表—接口請求：專題班課程數(shù)據(jù)同步的接口請求見表請求樣例參見—接口響應：專題班課程數(shù)據(jù)同步的接口響應見表響應樣例參見。表44專題班課程數(shù)據(jù)同步接口參數(shù)表參數(shù)值接口地址方法表45專題班課程數(shù)據(jù)同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明１操作類型見表的Ｍ１專題班編號見表的Ｍ７專題班狀態(tài)見表的Ｍ１課程編號見表的Ｍ２課程名稱見表的Ｍ３課程類別見表的ＯGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1課程類型courseType專題班課程是選修課或必選課O類型如下：C4課程關鍵字courseKeywordM5課程簡介courseIntroductionM6課程提供機構courseProviderM學時creditHourM課程時長courseDurationO課程考核方式O發(fā)布日期publishDateM停用日期offlineDateO預計停用日期expireDateO課程形式courseFormO8授課教師lecturersM9教師簡介lecturerIntroductionO8.2.5.3專題班課程學員學習記錄同步接口專題班課程學員學習記錄同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送專題班課程學員學習進度的記錄；—實時性要求：即時同步；—接口參數(shù)：專題班課程學員學習記錄同步接口參數(shù)見表46;—接口請求：專題班課程學員學習記錄同步的接口請求見表47,請求樣例參見A.6;—接口響應：專題班課程學員學習記錄同步的接口響應見表3,響應樣例參見A.7。表46專題班課程學員學習記錄同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPcourseLearningRecordGB／T38863—2020表47專題班課程學員學習記錄同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationTypeM21培訓機構標識符M1專題班編號TBTPIDM1課程編號和名稱列表courseIDandNameList課程唯一標識符及對應名稱的信息列表MC2學員標識符traineeIDM2專題班學習開始日期TBTPstartDate學員首次進入專題班學習的時間MGB/TD數(shù)據(jù)格式為YYYYMMDD3專題班學習完成日期TBTPfinishDate學員學完專題班獲得學時的時間MGB/TD數(shù)據(jù)格式為YYYYMMDD8.2.5.4專題班學習結果記錄同步接口專題班學習結果記錄同步接口的基本信息包括：—接口說明：服務提供方向服務發(fā)起方推送學員專題班學習結果記錄的信息；—實時性要求：即時同步；—接口參數(shù)：專題班學習結果記錄同步接口參數(shù)見表48;—接口請求：專題班學習結果記錄同步的接口請求見表49,請求樣例參見A.6;—接口響應：專題班學習結果記錄同步的接口響應見表3,響應樣例參見A.7。表48專題班學習結果記錄同步接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPcertificateInfo表49專題班學習結果記錄同步接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1操作類型operationTypeM1專題班編號TBTPIDM2學員標識符traineeIDM3學員姓名traineeNameM1學員所屬單位名稱學員報名時所屬單位的組織機構名稱MCGB／T38863—2020編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明２學員所屬單位標識符學員報名時所屬單位的組織機構標識符ＭＣ２專題班學習開始日期見表的Ｍ３專題班學習完成日期見表的Ｍ３專題班學時完成專題班學習后所獲得的學時ＭＮ４學員完成的專題班課程列表學員在專題班學習中所完成的課程的列表ＯＣ課程標識符課程名稱…課程標識符課程名稱５證書編號編號ＭＣ６證書電子版專題班結業(yè)證書文件所在的ＯＣ７發(fā)證日期Ｍ—Ｄ數(shù)據(jù)格式為8．3數(shù)據(jù)查詢接口服務支持查詢的數(shù)據(jù)類別見表。表50查詢接口服務支持查詢的數(shù)據(jù)類別表枚舉值說明學員信息課程信息課程學習結果記錄專題班信息專題班學習結果記錄GB／T38863—20208.3.2學員信息查詢接口學員信息查詢接口的基本信息包括：—接口說明：服務發(fā)起方向服務提供方查詢學員信息數(shù)據(jù)，供學員在平臺首次激活使用；—實時性要求：即時響應；—接口參數(shù)：學員信息查詢接口參數(shù)見表51;—接口請求：學員信息查詢的接口請求參數(shù)見表52,請求樣例參見A.8;—接口響應：學員信息查詢的接口響應參數(shù)見表53,響應樣例參見A.9。表51學員信息查詢接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeuserInfo表52學員信息查詢接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明3學員姓名traineeNameM1賬號userNameO3手機號mobileNumberO表53學員信息查詢接口響應表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明2學員標識符traineeIDM1賬號userNameM3學員姓名traineeNameM3手機號mobileNumberO9所屬單位標識符M4賬號狀態(tài)accountStatusM5激活時間registerTimeO8.3.3課程信息查詢接口課程信息查詢接口的基本信息包括：—接口說明：服務發(fā)起方向服務提供方查詢課程信息數(shù)據(jù)；—實時性要求：即時響應；GB／T38863—2020—接口參數(shù)：課程信息查詢接口參數(shù)見表54;—接口請求：課程信息查詢的接口請求參數(shù)見表55,請求樣例參見A.8;—接口響應：課程信息查詢的接口響應參數(shù)見表56,響應樣例參見A.9。表54課程信息查詢接口參數(shù)表參數(shù)值接口地址方法POSTbody.typecourseSharedInfo表55課程信息查詢接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1課程編號courseIDM2課程名稱courseNameM表56課程信息查詢接口響應表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1課程編號courseIDM2課程名稱courseNameM8授課教師lecturersM9教師簡介lecturerIntroductionO6課程提供機構courseProviderM21培訓機構標識符M5課程簡介courseIntroductionM課程時長courseDurationO學時creditHourM8.3.4課程學習結果記錄查詢接口課程學習結果記錄查詢接口的基本信息包括：—接口說明：服務發(fā)起方向服務提供方查詢在線選學課程學習結果記錄數(shù)據(jù)；—實時性要求：即時響應；—接口參數(shù)：課程學習結果記錄查詢接口參數(shù)見表57;—接口請求：課程學習結果記錄查詢的接口請求參數(shù)見表58,請求樣例參見A.8;—接口響應：課程學習結果記錄查詢的接口響應參數(shù)見表59,響應樣例參見A.9。GB／T38863—2020表57課程學習結果記錄查詢接口參數(shù)表參數(shù)值接口地址方法POSTbody.typecourseLearningRecord表58課程學習結果記錄查詢接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明2學員標識符traineeIDM1年度學員參加干部網(wǎng)絡培訓學習的年度MGB/TD數(shù)據(jù)格式為YYYY21培訓機構標識符M表59課程學習結果記錄查詢接口響應表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明2學員標識符traineeIDM3學員姓名traineeNameM9所屬單位標識符M21培訓機構標識符M1課程編號和名稱列表courseIDandNameListM學時creditHourM1課程學習完courseFinishDate學員學完課程，獲得學時的時間MGB/TD數(shù)據(jù)格式為YYYYMMDD2學習時長learningDuration學員學習課程實際投入的學習時長，以分為單位ON8.3.5專題班信息查詢接口專題班信息查詢接口的基本信息包括：—接口說明：服務發(fā)起方向服務提供方查詢專題班信息數(shù)據(jù)；—實時性要求：即時響應；GB／T38863—2020—接口參數(shù)：專題班信息查詢接口參數(shù)見表60;—接口請求：專題班信息查詢的接口請求參數(shù)見表61,請求樣例參見A.8;—接口響應：專題班信息查詢的接口響應參數(shù)見表62,響應樣例參見A.9。表60專題班信息查詢接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPsharedInfo表61專題班信息查詢接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1專題班編號TBTPIDM表62專題班信息查詢接口響應表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1專題班計劃編號TBTPplanIDM1專題班編號TBTPIDM2專題班名稱TBTPnameM3內容簡介briefIntroductionM4培訓對象TBTPobjectM5學習開始時間startDateM6學習截止時間dueTimeM7專題班狀態(tài)TBTPstatusM8專題班課程列表TBTPcourseListO9必修課考核要求M選修課考核要求electiveConditionM計劃學員人數(shù)M學時要求creditHourRequirementM主辦單位列表hostListM承辦單位列表organizerListM協(xié)辦單位列表O8.3.6專題班學習結果記錄查詢接口專題班學習結果記錄查詢接口的基本信息包括：—接口說明：服務發(fā)起方向服務提供方查詢學員的專題班學習結果記錄；GB／T38863—2020—實時性要求：即時響應；—接口參數(shù)：專題班學習結果記錄查詢接口參數(shù)見表63;—接口請求：專題班學習結果記錄查詢的接口請求參數(shù)見表64,請求樣例參見A.8;—接口響應：專題班學習結果記錄查詢的接口響應參數(shù)見表65,響應樣例參見A.9。表63專題班學習結果記錄查詢接口參數(shù)表參數(shù)值接口地址方法POSTbody.typeTBTPlearningRecord表64專題班學習結果記錄查詢接口請求表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1專題班編號TBTPIDO1年度M表65專題班學習結果記錄查詢接口響應表編號中文名稱英文名稱定義約束值域數(shù)據(jù)類型說明1專題班編號TBTPIDM1學員標識符和姓名列表traineeIDandNameListMC3專題班學時TBTPcreditHourM2證書編號列表certificateNOlist專題班結業(yè)證書的編號MCGB／T38863—2020附錄A（資料性附錄）接口樣例A.1請求報文樣例{數(shù)據(jù)類別",數(shù)據(jù)體哈希值","offset":"讀取數(shù)據(jù)時的偏移值","length":"讀取數(shù)據(jù)內容的長度","content":"數(shù)據(jù)內容加密后的字符串"}A.2響應報文樣例{加密后的數(shù)據(jù)內容","extension":{}}A.3推送服務器注冊接口請求樣例{平臺平臺私鑰",客戶端的自定義信息"GB／T38863—2020"type":"數(shù)據(jù)包的數(shù)據(jù)類別",{#數(shù)據(jù)的json字符串{"event":"dataOfUserModified",}#數(shù)據(jù)的json字符串｝}}A.4推送服務器注冊接口響應樣例{{#數(shù)據(jù)的json字符串{"event":"dataOfUserModified",}#數(shù)據(jù)的json字符串｝}A.5