(高清版)GB∕T 38863-2020 干部网络培训 平台数据接口技术要求

L67中华人民共和国国家标准干部网络培训平台数据接口技术要求oT国家市场监督管理总局国家标准化管理委员会ⅠGB／T38863—2020前言 2规范性引用文件 3术语和定义 4缩略语 5数据类型 5.1基本数据类型 7数据参数 7.3平台基本数据 7.4系统事件类别 8接口服务 8.1接口管理服务 8.2数据推送同步接口服务 8.3数据查询接口服务 附录A（资料性附录）接口样例 附录B（规范性附录）平台数据接口清单 附录C（规范性附录）异常状态码 ⅢGB／T38863—2020本标准按照GB/T1.1—2009给出的规则起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本标准由中共中央组织部提出并归口。本标准起草单位：华中师范大学、华东师范大学、北京邮电大学、中国电信集团有限公司、中国电子技术标准化研究院。1GB／T38863—2020干部网络培训平台数据接口技术要求本标准规定了干部网络培训机构平台之间的接口服务及接口数据参数。本标准适用于干部网络培训机构平台之间的数据传输和交换。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T中国各民族名称的罗马字母拼写法和代码GB/T政治面貌代码GB/T数据元和交换格式信息交换日期和时间表示法GB/T职务级别代码GB/T信息技术通用多八位编码字符集(UCS)GB32100—2015法人和其他组织统一社会信用代码编码规则GB/T38856—2020干部网络培训业务管理通用要求GB/T38858—2020干部网络培训平台数据要求3术语和定义GB/T38856—2020、GB/T38858—2020界定的术语和定义适用于本文件。4缩略语下列缩略语适用于本文件。增强现实(混合现实(页面浏览量(专题班(统一资源定位符(统一社会信用代码(虚拟现实(5数据类型5.1基本数据类型本标准中使用的数据类型和可取值见表1。２GB／T38863—2020表1数据类型的取值类型表示说明字符型Ｃ以字符表达的数据元值的类型，可用于表达字母、数字、汉字和其他字符形式数值型Ｎ以任意实数表达的数据元值的类型日期型Ｄ以日期和时间表达的数据元值的类型，符合—以-的形式表达集合Ｓ用于存放其他数据的容器，集合中可包含属性和其他集合指从业务的角度规定的数据元值的格式需求，包括所允许的最大或／和最小字符长度、数据元值的表示格式等。数据格式中使用的字符含义如下：进制最大位数；字符串“”表示长度不确定；逗号“，”隔开的两个自然数“”表示数值最大ｐ个十进制位数，小数点后ｑ位；双点号“”表示从最小长度到最大长度，前面附加最小长度，后面附加最大长度；字符串表示小时，“”表示分钟，可以视实际情况组合使用。值域是根据相应属性中规定的数据类型、长度而决定的数据元的允许值的集合。该集合可通过以下方式给出：—通过参考和引用相关标准；—通过文字描述给出值域的限制；—通过一一列举的方式给出所有可能的取值以及每一个值对应的实例或含义；—通过规则间接给出。用户可根据需要自行扩展和定义数据类型。干部网络培训机构平台之间通过接口服务进行数据传输。接口服务分为三大类：接口管理服务、数据推送同步接口服务和数据查询接口服务，如图１所示。3GB／T38863—2020图1干部网络培训机构平台数据接口干部网络培训机构平台是数据服务交互过程的参与实体，所提供的服务包括管理服务和学习服务，服务请求的发起者为“服务发起方”，服务请求的提供者为“服务提供方”。干部网络培训机构平台之间的数据服务主要包括：—接口管理服务：处理服务发起方和服务提供方之间的应用请求；—数据推送同步接口服务：处理参与实体间的数据同步请求；—数据查询接口服务：处理服务发起方的查询请求，并由服务提供方返回结果。报文样例参见附录A。平台数据接口服务清单见附录B。系统异常状态码见附录C。7数据参数请求报文的数据参数见表2,请求报文样例参见A.1。表2请求报文的数据参数数据块中文名称英文名称定义说明（数据头）平台编号platformID干部网络培训平台的唯一标识平台私钥platformKey干部网络培训平台所拥有的私钥自定义扩展信息extension数据头的可扩展的自定义信息（数据体）推送数据类别接口推送的数据内容分类类别数据体哈希值数据流的哈希值用于请求报文数据一致性校验数据偏移值offset读取数据时的偏移值数据长度读取数据体内容的长度数据体内容报文中所包含的业务数据数据体全部采用数组形式4GB／T38863—2020响应报文以加密数据的形式传输，数据参数见表3,响应报文样例参见A.2。表3响应报文的数据参数中文名称英文名称定义说明响应结果请求是否成功响应的状态标识出错信息errorMessage响应不成功时反馈的消息字符串哈希值加密数据的校验码数组数量加密数据如果是数组时的数组数量返回值hasData加密数据是否有返回值返回值是否是数组加密数据的数据结构是否是数组加密数据encryptData数据加密后的内容扩展数据extension可扩展的自定义信息7.3平台基本数据接口传输所涉及的平台基本数据内容见表4。表4平台基本数据表编号中文名称英文名称定义约束值域数据类型说明1平台标识符platformID干部网络培训平台的唯一标识符MC2域名用于在数据传输时标识计算机的电子方位MC3平台名称platformName干部网络培训平台的名称MC4组织机构标识符organizationID机构具有的唯一标识符MC5平台地址platformURL服务平台接口地址MC6管理员编号managerID平台管理员的唯一标识符MC成的唯一用户编码）7状态status平台状态MC状态标识7.4系统事件类别系统事件类别见表5。5GB／T38863—2020表5系统事件类别枚举值说明dataOfUserCreated学员信息新建dataOfUserModified学员信息变更培训信息新建trainingInfoUpdated培训信息变更可根据需要自行扩展和定义事件类别。7.5数据类别数据类别是接口报文数据体中推送数据内容的类别，见表6。表6数据类别枚举值说明loginStat登录人次统计数据visitStat页面浏览量统计数据PVstat首页访问量统计数据registerStat激活学员统计数据courseStat课程统计数据creditHourStat学时统计数据TBTPstat专题班统计数据TBTPcreditHourStat专题班学时统计数据TBTPregisterStat专题班报名人数统计数据TBTPgraduateStat专题班结业人数统计数据userInfo学员基本信息数据userAccountInfo学员账号信息数据organizationInfo组织机构数据courseInfo课程信息数据courseLearningRecord课程学习结果记录TBTPinfo专题班信息数据TBTPcourseInfo专题班课程数据TBTPcourseLearningRecord专题班课程学员学习记录TBTPcertificateInfo专题班学习结果记录6GB／T38863—20208接口服务8.1接口管理服务注册服务请求接口的基本信息包括：—接口说明：服务发起方向服务提供方请求事件通知的回调地址，用于动态注册，支持批量操作；—实时性要求：即时同步；—接口参数：注册服务请求接口参数见表7;—接口请求：注册服务请求的接口请求见表8,请求样例参见A.3;—接口响应：注册服务请求的接口响应见表9,响应样例参见A.4。表7注册服务请求接口参数表参数值接口地址方法POSTbody.typeN/A表8注册服务请求接口请求表中文名称英文名称定义约束值域数据类型说明事件系统事件类别MC事件类别，何种事件触发时回调枚举值，参见表5地址URL回调服务器的地址MC表9注册服务请求接口响应表中文名称英文名称定义约束值域数据类型说明响应结果响应是否成功的结果代码MC响应是否成功消息MC响应如果不成功，返回失败信息，异常状态码见表C.1扩展服务extensionService可扩展的自定义服务信息OC取消注册请求接口的基本信息包括：7GB／T38863—2020—接口说明：服务发起方向服务提供方请求取消事件通知服务的回调地址，用于取消注册，支持批量操作；—实时性要求：即时同步；—接口参数：取消注册请求接口参数见表10;—接口请求：取消注册请求的接口请求见表11,请求样例参见A.5;—接口响应：取消注册请求的接口响应见表3。表10取消注册请求接口参数表参数值接口地址方法POSTbody.typeN/A表11取消注册请求接口请求表中文名称英文名称定义约束值域数据类型说明事件系统事件类别OC需要取消的事件类别，参见表58.2数据推送同步接口服务8.2.1平台运行统计数据接口登录人次统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台学员登录统计数据；—实时性要求：无；—接口参数：登录人次统计数据接口参数见表12;—接口请求：登录人次统计数据的接口请求见表13,请求样例参见A.6;—接口响应：登录人次统计数据的接口响应见表3,响应样例参见A.7。表12登录人次统计数据接口参数表参数值接口地址方法POSTbody.typeloginStat8GB／T38863—2020表13登录人次统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符ID培训机构使用的组织机构标识符MC22currentDate统计数据的日期MGB/TD数据格式为YYYYMMDD23当日前累计登录人次yesterdayLogin-CountSum平台当日的前一天累计的登录人次MN含移动端24当日登录总人次PVcurrentLogin-CountSum人次MN含移动端25登录总人次平台登录的总人次MN含移动端26当日前累计移动终端登录人次yesterdayMobile-平台当日的前一天累计的登录人次MN27当日移动终人次mobilePVcurrent-人次MN28移动终端登录总人次Sum移动终端登录平台的总人次ON8.2.1.2页面浏览量统计数据接口页面浏览量统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方上传本平台页面浏览量统计数据；—实时性要求：无；—接口参数：页面浏览量统计数据接口参数见表14;—接口请求：页面浏览量统计数据的接口请求见表15,请求样例参见A.6;—接口响应：页面浏览量统计数据的接口响应见表3,响应样例参见A.7。表14页面浏览量统计数据接口参数表参数值接口地址方法POSTbody.typevisitStat9GB／T38863—2020表15页面浏览量统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM31当日前累计平台访问总人次干部网络培训平台当日的前一天累计的总页面浏览量MN32总人次PVcurrentCountSum平台当日的总页面浏览数MN33人次PVcountSum平台的总页面浏览数MN课程浏览数不计算在内8.2.1.3首页访问量统计数据接口首页访问量统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方上传本平台首页访问量统计数据；—实时性要求：无；—接口参数：首页访问量统计数据接口参数见表16;—接口请求：首页访问量统计数据的接口请求见表17,请求样例参见A.6;—接口响应：首页访问量统计数据的接口响应见表3,响应样例参见A.7。表16首页访问量统计数据接口参数表参数值接口地址方法POSTbody.typePVstat表17首页访问量统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM41当日前累计平台首页访问总人次yesterdayPV本平台当日的前一天累计的首页访问量MN42当日首页访问总人次PVcurrent平台当日首页面的浏览数ON43平台首页访问总人次PV平台首页面的浏览数ONGB／T38863—20208.2.1.4激活学员统计数据接口激活学员统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台学员已激活账户的统计数据；—实时性要求：无；—接口参数：激活学员统计数据接口参数见表18;—接口请求：激活学员统计数据的接口请求见表19,请求样例参见A.6;—接口响应：激活学员统计数据的接口响应见表3,响应样例参见A.7。表18激活学员统计数据接口参数表参数值接口地址方法POSTbody.typeregisterStat表19激活学员统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM51当日前累计激活人数yesterdayRegisterSum该培训机构当日的前一天累计的激活的人数MN52当日激活学员数currentRegisterSum平台当日新激活学员总数MN53激活学员数registerSum在平台上激活后处于正常状态的学员总数MN课程统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台拥有的课程统计数据；—实时性要求：无；—接口参数：课程统计数据接口参数见表20;—接口请求：课程统计数据的接口请求见表21,请求样例参见A.6;—接口响应：课程统计数据的接口响应见表3,响应样例参见A.7。GB／T38863—2020表20课程统计数据接口参数表参数值接口地址方法POSTbody.typecourseStat表21课程统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM61当日前累计课程总数平台当日的前一天累计的可以供学员学习的课程总数MN62当日课程总数currentCourseSum平台当日新发布课程总数MN63课程总数courseSum在平台上可以供学员学习的课程总数MN学时统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台学员获取的学时总数统计数据；—实时性要求：无；—接口参数：学时统计数据接口参数见表22;—接口请求：学时统计数据的接口请求见表23,请求样例参见A.6;—接口响应：学时统计数据的接口响应见表3,响应样例参见A.7。表22学时统计数据接口参数表参数值接口地址方法POSTbody.typecreditHourStat表23学时统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符MGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明22currentDateM71当日前累计课程学习总学时本平台当日的前一天累计的所有学员获取的学时总数MN72当日课程学习总学时currentCreditHourSum平台当日课程学习的总学时MN73学时总数creditHourSum平台所有学员获取的学时总数MN专题班统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台专题班统计数据；—实时性要求：即时同步；—接口参数：专题班统计数据接口参数见表24;—接口请求：专题班统计数据的接口请求见表25,请求样例参见A.6;—接口响应：专题班统计数据的接口响应见表3,响应样例参见A.7。表24专题班统计数据接口参数表参数值接口地址方法POSTbody.typeTBTPStat表25专题班统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM81当日前累计专题班总数yesterdayTBTPsum在平台上当日的前一天累积的可以供学员学习的专题班总数MN82当日专题班总数TBTPcurrentSum平台当日新开班的专题班总数MN83专题班总数TBTPsum在平台上可以供学员学习的专题班总数MN仅涉及已发布的专题班GB／T38863—20208.2.1.8专题班学时统计数据接口专题班学时统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台专题班所有学员学时统计数据；—实时性要求：即时同步；—接口参数：专题班学时统计数据接口参数见表26;—接口请求：专题班学时统计数据的接口请求见表27,请求样例参见A.6;—接口响应：专题班学时统计数据的接口响应见表3,响应样例参见A.7。表26专题班学时统计数据接口参数表参数值接口地址方法POSTbody.typeTBTPcreditHourStat表27专题班学时统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM91专题班学时总数TBTPcreditHourSum平台所有已发布的专题班的学时累加总数MN8.2.1.9专题班报名人数统计数据接口专题班报名人数统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台专题班报名人数统计数据；—实时性要求：即时同步；—接口参数：专题班报名人数统计数据接口参数见表28;—接口请求：专题班报名人数统计数据的接口请求见表29,请求样例参见A.6;—接口响应：专题班报名人数统计数据的接口响应见表3,响应样例参见A.7。表28专题班报名人数统计数据接口参数表参数值接口地址方法POSTbody.typeTBTPregisterStatGB／T38863—2020表29专题班报名人数统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM1当日前累计专题班报名总人数yesterdayEnrollmentSum当日的前一天平台累计报名参加专题班的所有学员总人数MN2当日专题班报名总人数TBTPcurrentEnrollmentSum平台当日参加专题班的学员总人数MN3专题班报名总人数enrollmentSum专题班报名学员总数MN8.2.1.10专题班结业人数统计数据接口专题班结业人数统计数据接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台专题班结业人数统计数据；—实时性要求：即时同步；—接口参数：专题班结业人数统计数据接口参数见表30;—接口请求：专题班结业人数统计数据的接口请求见表31,请求样例参见A.6;—接口响应：专题班结业人次统计数据的接口响应见表3,响应样例参见A.7。表30专题班结业人数统计数据接口参数表参数值接口地址方法POSTbody.typeTBTPgraduateStat表31专题班结业人数统计数据接口请求表编号中文名称英文名称定义约束值域数据类型说明21培训机构标识符M22currentDateM1当日前累计专题班结业人数yesterdayTBTPgraduateSum本平台当日的前一天专题班结业累计人数MN2当日专题班结业总人数TBTPcurrentGraduateSum平台当日专题班结业学员总人数MN3专题班结业总人数TBTPGraduateSum专题班结业学员总数MNGB／T38863—20208.2.2学员信息数据同步接口8.2.2.1学员基本信息数据同步接口学员基本信息数据同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送学员基本信息数据；—实时性要求：即时同步；—接口参数：学员基本信息数据同步接口参数见表32;—接口请求：学员基本信息数据同步的接口请求见表33,请求样例参见A.6;—接口响应：学员基本信息数据同步的接口响应见表3,响应样例参见A.7。表32学员基本信息数据同步接口参数表参数值接口地址方法POSTbody.typeuserInfo表33学员基本信息数据同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationType本次数据同步操作的类型M操作类型可选：UPDATE：变更；DELETE：删除C2学员标识符traineeID每个学员具有唯一的标识符，该标识符也是各平台中识别学员的依据MC3学员姓名traineeName学员的真实姓名MC人事档案中记用的学员姓名全称4出生年月birthDate学员的出生年月OGB/TD数据格式为YYYYMM5性别学员的性别O包含以下几种：C6民族nationality学员所属的民族OGB/TC7政治面貌学员的政治面貌MGB/TCGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明8职务学员在所属机构中担任的职务OC9所属单位标识符学员所属单位的组织机构标识符MC组织机构标识符的编码应遵守本标准中的规则职级学员的职级O职务级别代码应遵循GB/T12407—2008,若不在规定的范围内，则：C人员状态userStatus学员目前在单位中所处的状态O包含以下几种：处于工作状态处于离退休状态已从本单位调出C干部类别干部培训对象的类别M包含以下几种：级以上）以下）3：企业领导人员人员干部6：专业技术人员C8.2.2.2学员账号信息数据同步接口学员账号信息数据同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送学员账号信息数据；—实时性要求：即时同步；GB／T38863—2020—接口参数：学员账号信息数据同步接口参数见表34;—接口请求：学员账号信息数据同步的接口请求见表35,请求样例参见A.6;—接口响应：学员账号信息数据同步的接口响应见表3,响应样例参见A.7。表34学员账号信息数据同步接口参数表参数值接口地址方法POSTbody.typeuserAccountInfo表35学员账号信息数据同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationTypeM2学员标识符traineeIDM1账号学员的登录账号MC账号具有唯一性。账号的命名可以包含大小写字母、数字，不可使用特殊字符2密码password学员的登录密码OC根据实际情况慎重确定3手机号学员登记在系统中的手机号OC手机号码录入系统时需要校验，应真实有效4账号状态accountStatus学员账号的当前状态M包含以下几种：C5激活时间registerTime学员账号的首次激活时间OGB/TD数据格式为YYYY-MMDDhhmm8.2.3组织机构数据同步接口组织机构数据同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送已有组织机构数据，接收方比对双方数据，并发回增量数据以实现同步；—实时性要求：即时同步；—接口参数：组织机构数据同步接口参数见表36;—接口请求：组织机构数据同步的接口请求见表37,请求样例参见A.6;—接口响应：组织机构数据同步的接口响应见表3,响应样例参见A.7。GB／T38863—2020表36组织机构数据同步接口参数表参数值接口地址方法POSTbody.typeorganizationInfo表37组织机构数据同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationTypeM4组织机构标识符organizationIDM1组织机构名称organizationName该机构的正式全称MC2组织机构简称该机构的正式简称MC3上级组织机构标识符该机构上级单位的组织机构标识符OC上级组织机构标识构则为“NULL”4统一社会信用代码USCID机构法人的统一社会信用代码OC统一社会信用代码遵循GB32100—2015,若本机构非上级机构法人的统一社会信用代码8.2.4课程数据同步接口8.2.4.1课程信息数据同步接口课程信息数据同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台课程信息数据；—实时性要求：即时同步；—接口参数：课程信息数据同步接口参数见表38;—接口请求：课程信息数据同步的接口请求见表39,请求样例参见A.6;—接口响应：课程信息数据同步的接口响应见表3,响应样例参见A.7。GB／T38863—2020表38课程信息数据同步接口参数表参数值接口地址方法POSTbody.typecourseInfo表39课程信息数据同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationTypeM1课程编号courseID课程的唯一标识符MC2课程名称courseName课程的全称MC3课程类别按照某种分类方法确定的课程所属类别MC4课程关键字courseKeyword课程关键字字符串MC关键字间以半角逗号分隔5课程简介courseIntroduction课程的简单介绍MC6课程提供机构courseProvider提供课程的单位名称MC21培训机构标识符M7培训机构名称培训机构的全称MC8授课教师lecturers包括课程的主讲教等主要信息列表MC9教师简介lecturerIntroduction关于授课教师的简单介绍OC发布日期publishDate课程上传到网络并激活的日期MGB/TD数据格式为YYYYMMDD停用日期offlineDate课程从网络上删除或者课程被停用的日期OGB/TD数据格式为YYYYMMDDGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明预计停用expireDate对于某些时效性强的课程，所预先设定的课程失效日期OGB/TD数据格式为YYYYMMDD课程形式courseForm课程的基本呈现形式O包含但不限于以下几种：04:VR/AR/MRC学时creditHour课程经认定的学时MN课程时长courseDuration预计学员完成课程学习所需要投入的时间ON程资源学习阅读的时间课程考核方式课程的考核类型O包含以下几种：C8.2.4.2课程学习结果记录同步接口课程学习结果记录同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送本平台在线选学课程学习结果记录信息；—实时性要求：即时同步；—接口参数：课程学习结果记录同步接口参数见表40;—接口请求：课程学习结果记录同步的接口请求见表41,请求样例参见A.6;—接口响应：课程学习结果记录同步的接口响应见表3,响应样例参见A.7。表40课程学习结果记录同步接口参数表参数值接口地址方法POSTbody.typecourseLearningRecordGB／T38863—2020表41课程学习结果记录同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationTypeM21培训机构标识符M7培训机构名称M1课程编号courseIDM2课程名称courseNameM1专题班编号TBTPID专题班的唯一标识符MC若课程归属于某一专题时记录专题班编号学时creditHourM2培训方式trainingMode培训开展的方式M包含但不限于以下几种：C专题班开展的方式3课程类别O3学习类型learningType课程是否是选修课O类型如下：C4课程学习时长累积MN5课程通过总人数习的学员总数MN8.2.5专题班数据同步接口8.2.5.1专题班信息数据同步接口专题班信息数据同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送专题班信息数据；—实时性要求：即时同步；—接口参数：专题班信息数据同步接口参数见表42;—接口请求：专题班信息数据同步的接口请求见表43,请求样例参见A.6;—接口响应：专题班信息数据同步的接口响应见表3,响应样例参见A.7。GB／T38863—2020表42专题班信息数据同步接口参数表参数值接口地址方法表43专题班信息数据同步接口请求表编号中文名称英文名称定义约束值域数据类型说明１操作类型见表的Ｍ１专题班计划编号专题班计划的唯一标识符ＭＣ１专题班编号见表的Ｍ２专题班名称专题班的全称ＭＣ３内容简介专题班的介绍ＭＣ４培训对象允许参加专题班培训的学员范围ＭＣ５学习开始时间专题班的开始时间点Ｍ—Ｄ数据格式为６学习截止时间专题班的结束时间点Ｍ—Ｄ数据格式为７专题班状态专题班的状态Ｍ包含但不限种：未开始进行中已结束８专题班课程列表学员在专题班要求完成的课程列表ＯＣ列表格式为课程编号课程名称…课程编号课程名称９必修课考核要求专题班关于必修课完成数量和学时的要求ＭＣ选修课考核要求专题班关于选修课完成数量和学时的要求ＭＣGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明计划学员人数专题班计划培训的人人员的总数ＭＮ学时要求专题班对于学员完成学时数量的要求ＭＮ主办单位列表专题班主办单位的组织机构列表ＭＣ列表格式为主办单位标识符主办单位名称…，［主办单位标识符主办单位名称承办单位列表专题班承办单位的组织机构列表ＭＣ列表格式为承办单位标识符承办单位名称…，［承办单位标识符承办单位名称协办单位列表专题班协办单位的组织机构列表ＯＣ列表格式为协办单位标识符协办单位名称…，［协办单位标识符协办单位名称指定学员名单列表指定学员名单列表ＯＣ报名人数专题班已报名人数ＯＮ报名人员列表列表ＯＣ结业人数专题班已结业人数ＭＮ专题班统计属性ＭＳGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明结业学员列表所有结业人员的列表ＯＣ包括学员标识符、学员姓名、证书编号发证单位列表颁发专题班证书的单位列表ＭＣ列表格式为发证单位标识符发证单位名称…，［发证单位标识符发证单位名称专题班课程数据同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送专题班课程数据；—实时性要求：即时同步；—接口参数：专题班课程数据同步接口参数见表—接口请求：专题班课程数据同步的接口请求见表请求样例参见—接口响应：专题班课程数据同步的接口响应见表响应样例参见。表44专题班课程数据同步接口参数表参数值接口地址方法表45专题班课程数据同步接口请求表编号中文名称英文名称定义约束值域数据类型说明１操作类型见表的Ｍ１专题班编号见表的Ｍ７专题班状态见表的Ｍ１课程编号见表的Ｍ２课程名称见表的Ｍ３课程类别见表的ＯGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明1课程类型courseType专题班课程是选修课或必选课O类型如下：C4课程关键字courseKeywordM5课程简介courseIntroductionM6课程提供机构courseProviderM学时creditHourM课程时长courseDurationO课程考核方式O发布日期publishDateM停用日期offlineDateO预计停用日期expireDateO课程形式courseFormO8授课教师lecturersM9教师简介lecturerIntroductionO8.2.5.3专题班课程学员学习记录同步接口专题班课程学员学习记录同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送专题班课程学员学习进度的记录；—实时性要求：即时同步；—接口参数：专题班课程学员学习记录同步接口参数见表46;—接口请求：专题班课程学员学习记录同步的接口请求见表47,请求样例参见A.6;—接口响应：专题班课程学员学习记录同步的接口响应见表3,响应样例参见A.7。表46专题班课程学员学习记录同步接口参数表参数值接口地址方法POSTbody.typeTBTPcourseLearningRecordGB／T38863—2020表47专题班课程学员学习记录同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationTypeM21培训机构标识符M1专题班编号TBTPIDM1课程编号和名称列表courseIDandNameList课程唯一标识符及对应名称的信息列表MC2学员标识符traineeIDM2专题班学习开始日期TBTPstartDate学员首次进入专题班学习的时间MGB/TD数据格式为YYYYMMDD3专题班学习完成日期TBTPfinishDate学员学完专题班获得学时的时间MGB/TD数据格式为YYYYMMDD8.2.5.4专题班学习结果记录同步接口专题班学习结果记录同步接口的基本信息包括：—接口说明：服务提供方向服务发起方推送学员专题班学习结果记录的信息；—实时性要求：即时同步；—接口参数：专题班学习结果记录同步接口参数见表48;—接口请求：专题班学习结果记录同步的接口请求见表49,请求样例参见A.6;—接口响应：专题班学习结果记录同步的接口响应见表3,响应样例参见A.7。表48专题班学习结果记录同步接口参数表参数值接口地址方法POSTbody.typeTBTPcertificateInfo表49专题班学习结果记录同步接口请求表编号中文名称英文名称定义约束值域数据类型说明1操作类型operationTypeM1专题班编号TBTPIDM2学员标识符traineeIDM3学员姓名traineeNameM1学员所属单位名称学员报名时所属单位的组织机构名称MCGB／T38863—2020编号中文名称英文名称定义约束值域数据类型说明２学员所属单位标识符学员报名时所属单位的组织机构标识符ＭＣ２专题班学习开始日期见表的Ｍ３专题班学习完成日期见表的Ｍ３专题班学时完成专题班学习后所获得的学时ＭＮ４学员完成的专题班课程列表学员在专题班学习中所完成的课程的列表ＯＣ课程标识符课程名称…课程标识符课程名称５证书编号编号ＭＣ６证书电子版专题班结业证书文件所在的ＯＣ７发证日期Ｍ—Ｄ数据格式为8．3数据查询接口服务支持查询的数据类别见表。表50查询接口服务支持查询的数据类别表枚举值说明学员信息课程信息课程学习结果记录专题班信息专题班学习结果记录GB／T38863—20208.3.2学员信息查询接口学员信息查询接口的基本信息包括：—接口说明：服务发起方向服务提供方查询学员信息数据，供学员在平台首次激活使用；—实时性要求：即时响应；—接口参数：学员信息查询接口参数见表51;—接口请求：学员信息查询的接口请求参数见表52,请求样例参见A.8;—接口响应：学员信息查询的接口响应参数见表53,响应样例参见A.9。表51学员信息查询接口参数表参数值接口地址方法POSTbody.typeuserInfo表52学员信息查询接口请求表编号中文名称英文名称定义约束值域数据类型说明3学员姓名traineeNameM1账号userNameO3手机号mobileNumberO表53学员信息查询接口响应表编号中文名称英文名称定义约束值域数据类型说明2学员标识符traineeIDM1账号userNameM3学员姓名traineeNameM3手机号mobileNumberO9所属单位标识符M4账号状态accountStatusM5激活时间registerTimeO8.3.3课程信息查询接口课程信息查询接口的基本信息包括：—接口说明：服务发起方向服务提供方查询课程信息数据；—实时性要求：即时响应；GB／T38863—2020—接口参数：课程信息查询接口参数见表54;—接口请求：课程信息查询的接口请求参数见表55,请求样例参见A.8;—接口响应：课程信息查询的接口响应参数见表56,响应样例参见A.9。表54课程信息查询接口参数表参数值接口地址方法POSTbody.typecourseSharedInfo表55课程信息查询接口请求表编号中文名称英文名称定义约束值域数据类型说明1课程编号courseIDM2课程名称courseNameM表56课程信息查询接口响应表编号中文名称英文名称定义约束值域数据类型说明1课程编号courseIDM2课程名称courseNameM8授课教师lecturersM9教师简介lecturerIntroductionO6课程提供机构courseProviderM21培训机构标识符M5课程简介courseIntroductionM课程时长courseDurationO学时creditHourM8.3.4课程学习结果记录查询接口课程学习结果记录查询接口的基本信息包括：—接口说明：服务发起方向服务提供方查询在线选学课程学习结果记录数据；—实时性要求：即时响应；—接口参数：课程学习结果记录查询接口参数见表57;—接口请求：课程学习结果记录查询的接口请求参数见表58,请求样例参见A.8;—接口响应：课程学习结果记录查询的接口响应参数见表59,响应样例参见A.9。GB／T38863—2020表57课程学习结果记录查询接口参数表参数值接口地址方法POSTbody.typecourseLearningRecord表58课程学习结果记录查询接口请求表编号中文名称英文名称定义约束值域数据类型说明2学员标识符traineeIDM1年度学员参加干部网络培训学习的年度MGB/TD数据格式为YYYY21培训机构标识符M表59课程学习结果记录查询接口响应表编号中文名称英文名称定义约束值域数据类型说明2学员标识符traineeIDM3学员姓名traineeNameM9所属单位标识符M21培训机构标识符M1课程编号和名称列表courseIDandNameListM学时creditHourM1课程学习完courseFinishDate学员学完课程，获得学时的时间MGB/TD数据格式为YYYYMMDD2学习时长learningDuration学员学习课程实际投入的学习时长，以分为单位ON8.3.5专题班信息查询接口专题班信息查询接口的基本信息包括：—接口说明：服务发起方向服务提供方查询专题班信息数据；—实时性要求：即时响应；GB／T38863—2020—接口参数：专题班信息查询接口参数见表60;—接口请求：专题班信息查询的接口请求参数见表61,请求样例参见A.8;—接口响应：专题班信息查询的接口响应参数见表62,响应样例参见A.9。表60专题班信息查询接口参数表参数值接口地址方法POSTbody.typeTBTPsharedInfo表61专题班信息查询接口请求表编号中文名称英文名称定义约束值域数据类型说明1专题班编号TBTPIDM表62专题班信息查询接口响应表编号中文名称英文名称定义约束值域数据类型说明1专题班计划编号TBTPplanIDM1专题班编号TBTPIDM2专题班名称TBTPnameM3内容简介briefIntroductionM4培训对象TBTPobjectM5学习开始时间startDateM6学习截止时间dueTimeM7专题班状态TBTPstatusM8专题班课程列表TBTPcourseListO9必修课考核要求M选修课考核要求electiveConditionM计划学员人数M学时要求creditHourRequirementM主办单位列表hostListM承办单位列表organizerListM协办单位列表O8.3.6专题班学习结果记录查询接口专题班学习结果记录查询接口的基本信息包括：—接口说明：服务发起方向服务提供方查询学员的专题班学习结果记录；GB／T38863—2020—实时性要求：即时响应；—接口参数：专题班学习结果记录查询接口参数见表63;—接口请求：专题班学习结果记录查询的接口请求参数见表64,请求样例参见A.8;—接口响应：专题班学习结果记录查询的接口响应参数见表65,响应样例参见A.9。表63专题班学习结果记录查询接口参数表参数值接口地址方法POSTbody.typeTBTPlearningRecord表64专题班学习结果记录查询接口请求表编号中文名称英文名称定义约束值域数据类型说明1专题班编号TBTPIDO1年度M表65专题班学习结果记录查询接口响应表编号中文名称英文名称定义约束值域数据类型说明1专题班编号TBTPIDM1学员标识符和姓名列表traineeIDandNameListMC3专题班学时TBTPcreditHourM2证书编号列表certificateNOlist专题班结业证书的编号MCGB／T38863—2020附录A（资料性附录）接口样例A.1请求报文样例{数据类别",数据体哈希值","offset":"读取数据时的偏移值","length":"读取数据内容的长度","content":"数据内容加密后的字符串"}A.2响应报文样例{加密后的数据内容","extension":{}}A.3推送服务器注册接口请求样例{平台平台私钥",客户端的自定义信息"GB／T38863—2020"type":"数据包的数据类别",{#数据的json字符串{"event":"dataOfUserModified",}#数据的json字符串｝}}A.4推送服务器注册接口响应样例{{#数据的json字符串{"event":"dataOfUserModified",}#数据的json字符串｝}A.5