干部网络培训平台数据接口技术要求

国家标准 GB/T38863一2020 干部网络培训平台数据接口技术要求 Oninetrainingtorledership一Iechmiellruirememtstorplatfmdatainterfhee 2020-07-21发布 2021-02-01实施 家市场监督管理总局 国 发布 国家标准花管委员会国家标准
GB/38863一2020 目 次 前言 范围 2 规范性引用文件 3 术语和定义 缩略语 数据类型 5.1基本数据类型 5.2数据格式 5.3值域 5,4 自定义数据类型 概述 数据参数 7.1请求报文 7.2响应报文 7.3平台基本数据 系统事件类别 7.4 7.5 数据类别 接口服务 8.1接口管理服务 8.2数据推送同步接口服务 8.3数据查询接口服务 27 附录A(资料性附录)接口样例 33 附录B(规范性附录)平台数据接口清单 38 附录c(规范性附录)异常状态码 40
GB/T38863一2020 前 言 本标准按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利 本文件的发布机构不承担识别这些专利的责任 本标准由中共中央组织部提出并归口 本标准起草单位:华中师范大学、华东师范大学、北京邮电大学、电信集团有限公司、电子 技术标准化研究院 本标准主要起草人:吴骶、吴晨、钱冬明、饶景阳、李青、李进东、李欢冬、马兆钦、余云涛,史戈
GB/T38863一2020 干部网络培训平台数据接口技术要求 范围 本标准规定了干部网络培训机构平台之间的接口服务及接口数据参数 本标准适用于干部网络培训机构平台之间的数据传输和交换 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件,仅注日期的版本适用于本文 件 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T3304一1991各民族名称的罗马字母拼写法和代码 GB/T4762一1984政治面貌代码 GB/T7408一2005数据元和交换格式信息交换日期和时间表示法 职务级别代码 GB/T124072008 GB/T13000-2010信息技术通用多八位编码字符集(UcS) 一社会信用代附编码规则 GB321002015法人和其他组织统 干部网络培训业务管理通用要求 GB/T388562020 干部网络培训平台数据要求 GB/T388582020 术语和定义 GB/T38856一2020,GB/T388582020界定的术语和定义适用于本文件 缩略语 下列缩略语适用于本文件 AR;增强现实(AugmentedReality) D;标识符(Identifier) MR;混合现实(MixedReality) v,页面浏览量(PageView) TBTP;专题班(Theme-basedTrainingProjeet) URL;统一资源定位符(UniformResourceL.ocator) UsCD统一社会信用代码(Umifiedsocialcreditldenifiem) VR;虚拟现实(VirtualReality) 5 数据类型 5.1基本数据类型 本标准中使用的数据类型和可取值见表1
GB/T38863一2020 表1数据类型的取值 类型 表示 说 明 字符型(string) 以字符表达的数据元值的类型,可用于表达字母、数字,汉字和其他字符形式 N 数值型(numerie 以任意实数表达的数据元值的类型 以日期和时间表达的数据元值的类型,符合GB/T7408一2005,以YYYYMM D 日期型(date) DDhhmm的形式表达 集合(set) 用于存放其他数据的容器,集合中可包含属性和其他集合 5.2数据格式 指从业务的角度规定的数据元值的格式需求,包括所允许的最大或/和最小字符长度、数据元值的 表示格式等 数据格式中使用的字符含义如下 字母“a”表示字符 a 字母“n”表示数值; b 字母“a”或“n”之后的自然数表示定长个字符(字符集默认为GB/T13000-2010),或数值的十 c 进制最大位数 字符串“.”"表示长度不确定 d 逗号","隔开的两个自然数“p.q"表示数值最大p个十进制位数,小数点后q位 双点号“”表示从最小长度到最大长度,前面附加最小长度,后面附加最大长度; 字符串“YYYYMMDDhhmm”中的“YYYY”表示年份,“MM”表示月份,“DD”表示日期,“hh” 日 表示小时,“mm”表示分钟,可以视实际情况组合使用 5.3值域 值域是根据相应属性中规定的数据类型、长度而决定的数据元的允许值的集合 该集合可通过以 下方式给出: 通过参考和引用相关标准; 通过文字描述给出值域的限制 通过一一列举的方式给出所有可能的取值以及每一个值对应的实例或含义; -通过规则间接给出 5.4自定义数据类型 用户可根据需要自行扩展和定义数据类型 6 概述 干部网络培训机构平台之间通过接口服务进行数据传输 接口服务分为三大类;接口管理服务、数 据推送同步接口服务和数据查询接口服务,如图1所示
GB/T38863一2020 接口管理服务 数据推送同步接口服务 平台运行统计数据接口 干部 学员宿总数筒步接口 干部 组织机构数据同步接口 网络 网络 培训 培训 专题班数据同步接口 机构 机构 平台 平台 数据查询接口服务 学员信息查询接口 课租信良查询接口 课程学习结果记录查询接口 专题班信息查询接口 专顺班学习结果 吉果记录查询接 图1干部网络培训机构平台数据接口 干部网络培训机构平台是数据服务交互过程的参与实体,所提供的服务包括管理服务和学习服务， 服务请求的发起者为“服务发起方”,服务请求的提供者为“服务提供方” 干部网络培训机构平台之间 的数据服务主要包括: 接口管理服务;处理服务发起方和服务提供方之间的应用请求; 数据推送同步接口服务:处理参与实体间的数据同步请求; 数据查询接口服务;处理服务发起方的查询请求,并由服务提供方返回结果 报文样例参见附录A 平台数据接口服务清单见附录B 系统异常状态码见附录c 数据参数 7.1请求报文 请求报文的数据参数见表2,请求报文样例参见A.1 表2请求报文的数据参数 定 数据块 中文名称 英文名称 说明 干部网络培训平台的唯一标识 平台编号 platformlD headl 平台私钥 platformKey 干部网络培训平台所拥有的私钥 数据头) 数据头的可扩展的自定义信息 自定义扩展信息 extension 推送数据类别 接口推送的数据内容分类类别 参见7.5 type 数据体哈希值 数据流的哈希值 用于请求报文数据一致性校验 hashcode body offset 读取数据时的偏移值 数据偏移值 数据体 数据长度 length 读取数据体内容的长度 数据体内容 ontent 报文中所包含的业务数据 数据体全部采用数组形式
GB/T38863一2020 7.2响应报文 响应报文以加密数据的形式传输,数据参数见表3,响应报文样例参见A.2 表3响应报文的数据参数 说 中文名称 英文名称 定 明 响应结果 请求是否成功响应的状态标识 response 出错信息 errorMessage 响应不成功时反债的消息字符串 哈希值 hashcode 加密数据的校验码 数组数量 加密数据如果是数组时的数组数量 count 返回值 hasData 加密数据是否有返回值 返回值是否是数组 isArray 加密数据的数据结构是否是数组 加密数据 eneryptData 数据加密后的内容 可扩展的自定义信息 扩展数据 extension 7.3平台基本数据 接口传输所涉及的平台基本数据内容见表4 表4平台基本数据表 编号 中文名称 英文名称 定义 约束值域数据类型 说明 干部网络培训平台的唯 platformlD M 平台标识符 1.1 标识符 a..18 用于在数据传输时标识计 M 1.2 域名 domainName 算机的电子方位 a.100 M 1.3 平台名称 platformName干部网络培训平台的名称 a..200 1.4 组织机构标识符organizationD机构具有的唯一标识符 M a..18 M 1.5 平台地址 platformURL 服务平台接口地址 a..2048 管理员编码(平台生 l.6管理员编号 managerID 平台管理员的唯一标识符 M a.32 成的唯一用户编码 M 状态 status 平台状态 状态标识 a32 注;“约束”栏内M表示“必备”数据元素 系统事件类别 系统事件类别见表5
GB/T38863一2020 表5系统事件类别 枚举值 说 明 dataOfUserCreatedl 学员信息新建 dataOUserModified 学员信息变更 traininglnfoCreated 培训信息新建 traininglnfoUpdated 培训信息变更 可根据需要自行扩展和定义事件类别 7.5数据类别 数据类别是接口报文数据体中推送数据内容的类别,见表6 表6数据类别 枚举值 说 明 登录人次统计数据 loginStat 页面浏览量统计数掘 isitStat PVstat 首页访问量统计数据 registerStat 激活学员统计数据 课程统计数据 courseStat creditHourStat 学时统计数据 专题班统计数据 TBTPstat 专题班学时统计数据 TBTPereditHourStat TBTPY 专题班报名人数统计数据 PregisterStat TBTPgraduateStat 专题班结业人数统计数据 usernfo 学员基本信息数据 学员账号信息数据 userAccountlnfo 组织机构数据 organizationlnfo coursenfo 课程信息数据 课程学习结果记录 ourselearningReeord TBTPinfo 专题班信息数据 TBTPcourselnfo 专题班课程数据 TBTPeoursel.earningRecord 专题班课程学员学习记录 专题班学习结果记录 TBTPcertifieatelnfo
GB/T38863一2020 8 接口服务 8.1接口管理服务 8.1.1注册服务请求 注册服务请求接口的基本信息包括 一接口说明;服务发起方向服务提供方请求事件通知的回调地址,用于动态注册,支持批量操作 -实时性要求即时同步; -接口参数:注册服务请求接口参数见表7; -接口请求:注册服务请求的接口请求见表8,请求样例参见A.3; 接口响应:注册服务请求的接口响应见表9,响应样例参见A.4 表7注册服务请求接口参数表 参 数 值 https:/HOST/notify/register 接口地址 方法 POST body.type N/A 表8注册服务请求接口请求表 中文名称英文名称 定义 约束值城数据类型 说明 事件类别,何种事件触发时回调枚举值,参见 事件 系统事件类别 M event a.30 表5 M URL 回调服务器的地址 地址 a..2048 注:“约束”栏内M表示“必备”数据元素 表9注册服务请求接口响应表 英文名称 约束值域数据类型 说明 中文名称 定义 响应是否成功的结果 1:成功 M 响应结果 响应是否成功 response 代码 2;失败 al 0 响应如果不成功,返回失败信息 消息 M message 异常状态码见表C.1 a3 可扩展的自定义服务 扩展服务 extensionService a..100 信息 注“约束”栏内M表示“必备”数据元素,o表示“可选”数据元素 8.1.2取消注册请求 取消注册请求接口的基本信息包括
GB/T38863一2020 接口说明;服务发起方向服务提供方请求取消事件通知服务的回调地址,用于取消注册,支持 批量操作; 实时性要求:即时同步; -接口参数;取消注册请求接口参数见表10; -接口请求取消注册请求的接口请求见表11,请求样例参见A.5; -接口响应:取消注册请求的接口响应见表3 表10取消注册请求接口参数表 数 值 接口地址 https;//HOST}/notify/unregister P0sT 方法 N/A body.type 表11取消注册请求接口请求表 中文名称英文名称 约束值域数据类型 W 说 定义 事件 系统事件类别 需要取消的事件类别,参见表5 event a..30 注;“约束”栏内0表示“可选”数据元素 8.2数据推送同步接口服务 8.2.1平台运行统计数据接口 8.2.1.1登录人次统计数据接口 登录人次统计数据接口的基本信息包括: 接口说明;服务提供方向服务发起方推送本平台学员登录统计数据 实时性要求;无; -接口参数:登录人次统计数据接口参数见表12; 接口请求;登录人次统计数据的接口请求见表13,请求样例参见A.6 接口响应;登录人次统计数据的接口响应见表3,响应样例参见A.7 表12登录人次统计数据接口参数表 数 值 接口地址 lhttps;//HOST/data/push 方法 POST ody.type loginStat
GB/T38863一2020 表13登录人次统计数据接口请求表 数据类型 编号 中文名称 英文名称 定义 约束值域 说 明 培训机构标training(Organizationm 培训机构使用的组织 2.1 N 识符 机构标识符 a.,18 GB/T 数据格式为 2.2 M 统计数据的日期 日期 currentDate 74082005 YYYYMMDD 当日前累计yesterdayLogin 平台当日的前一天累 N 2.3 M 含移动端 登录人次 计的登录人次 CountSum 当日登录总Ve 平台当日登录的总 /currentl.ogin 2.4 M 含移动端 人次 CountSum 人次 2.5 登录总人次 M 含移动端 loginCountSum 平台登录的总人次 当日前累计 yesterdayMobile 平台当日的前一天累 2.6 移动终端登 M L.oginCountSum 计的登录人次 录人次 当日移动终 mobilePVcurrent 平台当日登录的总 端登录 总 M 人次 I.oginCountSum 人次 移动终端登tmobileloginCount 移动终端登录平台的 2.8 总 Sum 录总人次 人次 注;“约束”栏内M表示“必备”数据元素,O表示“可选”数据元素 8.2.1.2页面浏览量统计数据接口 页面训览量统计数据接口的基本信息包括 接口说明服务提供方向服务发起方上传本平台页面浏览量统计数据; 实时性要求;无 接口参数;页面浏览量统计数据接口参数见表14 接口请求;页面浏览量统计数据的接口请求见表15,请求样例参见A.6, 接口响应;页面浏览量统计数据的接口响应见表3,响应样例参见A.7 表14页面浏览量统计数据接口参数表 参 数 值 接口地址 https:;//HOST/data/push 方法 POST body.type visitStat
GB/T38863一2020 表15页面浏览量统计数据接口请求表 编号 中文名称 英文名称 定 义 约束值域数据类型 说明 培训机构标 M 2.1 trainingOrganizationlD 见表13的2.1 识符 2.2日期 见表13的2.2 M currentDate 当日前累计平 干部网络培训平台当日的前 M 3.1 vesterdavPVCountSum 台访问总人次 -天累计的总页面浏览量 当日平台访间 M PVeurrentCountSum 平台当日的总页面浏览数 3.2 总人次 平台访问总 课程浏览数 平台的总页面浏览数 M 3.3 PVeountSum 人次 不计算在内 注“约束”栏内M表示“必备"数据元素 8.2.1.3首页访问量统计数据接口 首页访问量统计数据接口的基本信息包括 接口说明:服务提供方向服务发起方上传本平台首页访问量统计数据 实时性要求;无; -接口参数:首页访问量统计数据接口参数见表16 -接口请求:首页访问量统计数据的接口请求见表17,请求样例参见A.6; 接口响应:首页访问量统计数据的接口响应见表3,响应样例参见A.7 表16首页访问量统计数据接口参数表 数 值 接口地址 https://HOST/data/push 方法 POST lody.type PVstat 表17首页访问量统计数据接口请求表 编号 约束值域数据类型说明 中文名称 英文名称 定义 M 培训机构标识符 见表13的2.1 2.l training(OrganizationlD M 2.2 日期 见表13的2.2 currentDate 当日前累计平台首页 本平台当日的前一天累计的 4.1 yesterdayPV M 访问总人次 首页访问量 当日首页访问总人次Pvcurrent 平台当目首页面的浏览数 4.2 平台首页访问总人次 平台首页面的浏览数 4.3 注;“约束”栏内M表示“必备”数据元素,0表示“可选”数据元素
GB/T38863一2020 8.2.1.4激活学员统计数据接口 激活学员统计数据接口的基本信息包括 -接口说明:服务提供方向服务发起方推送本平台学员已激活账户的统计数据 实时性要求;无; -接口参数:激活学员统计数据接口参数见表18; 接口请求:激活学员统计数据的接口请求见表19,请求样例参见A.6; 接口响应:激活学员统计数据的接口响应见表3,响应样例参见A.7 表18激活学员统计数据接口参数表 数 值 接口地址 https:/HOST/data/push POST 方法 body.type registerStat 表19激活学员统计数据接口请求表 编号 英文名称 约束值域数据类型说明 中文名称 定义 M 2.1 培训机构标识符 trainingOrganizationlD 见表13的2.1 2.2 日期 currentDate 见表13的2.2 M 当日前累计激活 该培训机构当日的前一天累 M 5.1 N yesterdayRegisterSum 人数 计的激活的人数 M 当日激活学员数curentRegistersumm 平台当日新激活学员总数 5.2 N 在平台上激活后处于正常状 M 5.3 激活学员数 registerSum 态的学员总数 注;“约束"栏内M表示“必备”数据元素 8.2.1.5课程统计数据接口 课程统计数据接口的基本信息包括 接口说明服务提供方向服务发起方推送本平台拥有的课程统计数据 实时性要求;无 接口参数;课程统计数据接口参数见表20:; 接口请求;课程统计数据的接口请求见表21,请求样例参见A.6; 接口响应;课程统计数据的接口响应见表3,响应样例参见A.7 10
GB/T38863一2020 表20课程统计数据接口参数表 数 值 接口地址 https://H0ST/data/push 方法 POST ody.type courseStat 表21课程统计数据接口请求表 编号 中文名称 英文名称 定义 约束值域数据类型 说明 培训机构标识符trniningOrganizationlD 2.1 见表13的2.l M 2.2日期 currentDate 见表13的2.2 M 当日前累计课程 平台当日的前一天累计的可 N M 6.l yesterdayCourseSum 总数 以供学员学习的课程总数 M N 当日课程总数 平台当日新发布课程总数 6.2 currentCourseSum 在平台上可以供学员学习的 M N 课程总数 6.3 courseSumm 课程总数 注:“约束”栏内M表示“必备”数据元素 8.2.1.6学时统计数据接口 学时统计数据接口的基本信息包括: 接口说明,服务提供方向服务发起方推送本平台学员获取的学时总数统计数据 实时性要求;无 接口参数;学时统计数据接口参数见表22:; -接口请求:学时统计数据的接口请求见表23,请求样例参见A.6; 接口响应;学时统计数据的接口响应见表3,响应样例参见A.7 表22学时统计数据接口参数表 数 值 接口地址 https://HOST'/data/push POST 方法 ody.type creditHourStat 表23学时统计数据接口请求表 编号 中文名称 英文名称 定义 约束值域数据类型说明 2.1 培训机构标识符trainingOrganizationlD 见表13的2.l 1
GB/T38863一2020 表23(续 编号 中文名称 英文名称 定义 约束值域数据类型说明 2.2 日期 currentDate 见表13的2.2 M 当日前累计课程 本平台当日的前一天累计的所 7.1 yesterdayCreditHourSum M 学习总学时 有学员获取的学时总数 当日课程学习总 7.2 currentCreditHourSum 平台当日课程学习的总学时 M 学时 M 7.3 学时总数 ereditlHourSunm 平台所有学员获取的学时总数 注:“约束”栏内M表示“必备”数据元素 8.2.1.7专题班统计数据接口 专题班统计数据接口的基本信息包括 -接口说明服务提供方向服务发起方推送本平台专题班统计数据; 实时性要求;即时同步; -接口参数:专题班统计数据接口参数见表24; 接口请求;专题班统计数据的接口请求见表25,请求样例参见A.6 接口响应;专题班统计数据的接口响应见表3,响应样例参见A.7 表24专题班统计数据接口参数表 数 值 HOsT7 接口地址 https:/7 7data/push POST 方法 TBTPStat body.type 表25专题班统计数据接口请求表 编号 中文名称 英文名称 定义 约束值域数据类型 说明 培训机构标 M 2.1 training(OrganizationlD 见表13的2.1 识符 2.2 日期 见表13的2.2 M currentDate 当日前累计 在平台上当日的前一天累积的 M N 8.1 yesterdayTBTPsum 专题班总数 可以供学员学习的专题班总数 当日专题班 M 8.2 TBTPcurrentSum 平台当日新开班的专题班总数 总数 在平台上可以供学员学习的专 仅涉及已发 专题班总数TBTPsum M 8.3 题班总数 布的专题班 注;“约束"栏内M表示“必备”数据元素 12
GB/T38863一2020 8.2.1.8专题班学时统计数据接口 专题班学时统计数据接口的基本信息包括: -接口说明;服务提供方向服务发起方推送本平台专题班所有学员学时统计数据 实时性要求:即时同步; -接口参数:专题班学时统计数据接口参数见表26 接口请求:专题班学时统计数据的接口请求见表27,请求样例参见A.6; 接口响应:专题班学时统计数据的接口响应见表3,响应样例参见A.7 表26专题班学时统计数据接口参数表 值 数 HoST/ 接口地址 https:/ 7data/push 方法 POST ody.type TBTPereditHHourStat 表27专题班学时统计数据接口请求表 编号 中文名称 英文名称 定义 约束值域数据类型 说明 M 培训机构标识符trniningOrganizationlD 见表13的2.1 2.1 M 2.2 日期 见表13的2.2 currentDate 平台所有已发布的专题班的 M TBTPcreditHourSumm 专题班学时总数 9.1 学时累加总数 "约束"栏内M表示"必备"数据无素 注: 8.2.1.9专题班报名人数统计数据接口 专题班报名人数统计数据接口的基本信息包括: 接口说明:服务提供方向服务发起方推送本平台专题班报名人数统计数据 实时性要求;即时同步; 接口参数:专题班报名人数统计数据接口参数见表28; 接口请求:专题班报名人数统计数据的接口请求见表29,请求样例参见A.6; 接口响应:专题班报名人数统计数据的接口响应见表3,响应样例参见A.7 表28专题班报名人数统计数据接口参数表 数 值 接口地址 /HosT)/daa/puslb https; 方法 POST TBTPregisterStat body.type 13
GB/T38863一2020 表29专题班报名人数统计数据接口请求表 编号 约束值域数据类型说明 中文名称 英文名称 定义 见表13的2. M 2.1 培训机构标识符 trainingOrganizationlD M 2.2 日期 见表13的2.2 currentDate 当日前累计专题班 当日的前一天平台累计报名参 yesterdayEnrollmentSum M 10.l 报名总人 数 加专题班的所有学员总人数 当日专题班报名总 平台当日参加专题班的学员 M TBTPcurrentEnrollnmentSum 10.2 人数 总人数 专题班报名学员总数 10.3 专题班报名总人数enrollmentSum 注;“约束”栏内M表示“必备”数据元素 8.2.1.10专题班结业人数统计数据接口 专题班结业人数统计数据接口的基本信息包括: -接口说明:服务提供方向服务发起方推送本平台专题班结业人数统计数据 实时性要求即时同步; -接口参数:专题班结业人数统计数据接口参数见表30 接口请求;专题班结业人数统计数据的接口请求见表31,请求样例参见A.6; 接口响应;专题班结业人次统计数据的接口响应见表3,响应样例参见A.7 表30专题班结业人数统计数据接口参数表 数 值 接口地址 https/HOsT/data/push 方法 POST body.type TBTPgraduateStat 表31专题班结业人数统计数据接口请求表 编号 中文名称 英文名称 定义 约束值域数据类型 说明 2.1 培训机构标识符 trainingOrganizationlD 见表13的2.1 M M 2,2 日期 currentDate 见表13的2.2 当日前累计专题班 本平台当日的前一天 M N 1l.1 yesterdayTBTPgraduateSum 专题班结业累计人数 结业人数 当日专题班结业总 平台当日专题班结业 1.2 TBTPeurrentGraduateSum M 人数 学员总人数 M 11.3专题班结业总人数TBTPGiraduateSum 专题班结业学员总数 注“约束”栏内M表示“必备”数据元素 14
GB/38863一2020 8.2.2学员信息数据同步接口 8.2.2.1学员基本信息数据同步接口 学员基本信息数据同步接口的基本信息包括: -接口说明:服务提供方向服务发起方推送学员基本信息数据 实时性要求;即时同步 -接口参数:学员基本信息数据同步接口参数见表32; -接口请求:学员基本信息数据同步的接口请求见表33,请求样例参见A.6 -接口响应:学员基本信息数据同步的接口响应见表3,响应样例参见A.7 表32学员基本信息数据同步接口参数表 数 值 //HOST/da1 接口地址 https:/ iata/push 方法 POST ody.type userlnfo 表33学员基本信息数据同步接口请求表 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 操作类型可选 本次数据同步操作的 ADD;新建; M 12.1操作类型 operationType 类型 UPDATE:变更; a6 DELETE;删除 每个学员具有唯一的 标识符,该标识符也 M 12.2学员标识符traineelD 是各平台中识别学员 a..32 的依据 人事档案中记 载的、正在使 M 12.3学员姓名 学员的真实姓名 traineeName a..50 用的学员姓名 全称 GB/T 数据格式为 12.4出生年月 birthDate 学员的出生年月 74082005 YYYYMM 包含以下几种 12.5性别 学员的性别 gender !;男 al 2;女 GB/T 12.6民族 学员所属的民族 nationality 3304一1991 a2 GB/T 政治面貌 poiticealAffiiation 学员的政治面貌 M 4762一1984 12 15
GB/T38863一2020 表33(续 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 学员在所属机构中担 12.8职务 position 任的职务 a..50 组织机构标识 学员所属单位的组织 符的编码应遵 所属单位标 M 12.9 traineeOrganizationl 机构标识符 识符 a..18 守本标准中的 规则 职务级别代码应遵 循 GB/T12407 2008,若不在规定 12.1o职级 学员的职级 的范围内,则 positionClass a3 610;高层 ,中层 620: 630;基层 包含以下几种: 1!现职人员,学员 处于工作状态 学员目前在单位中所 2;离退人员,学员 12.11人员状态 userStatus al 处的状态 处于离退休状态 调出人员,学员 已从本单位调出 9;其他人员 包含以下几种: 1:党政干部县处 级以上) 2;党政干部科级 以下 3;企业领导人员 2.12干部类别 干部培训对象的类别 M userCategory 4:事业单位领导al 人员 5;村社区基层 干部 6;专业技术人员 7,其他 注;“约束”栏内M表示“必备”数据元素,0表示“可选”数据元素 8.2.2.2学员账号信息数据同步接口 学员账号信息数据同步接口的基本信息包括 -接口说明:服务提供方向服务发起方推送学员账号信息数据 -实时性要求:即时同步; 16
GB/T38863一2020 -接口参数:学员账号信息数据同步接口参数见表34 接口请求;学员账号信息数据同步的接口请求见表35,请求样例参见A.6 接口响应:学员账号信息数据同步的接口响应见表3,响应样例参见A.7 表34学员账号信息数据同步接口参数表 参 粉 https:/HOST/dat Ao 接口地址 ata/pus 方法 POST ody.type userAccountInfo 表35学员账号信息数据同步接口请求表 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 2.1操作类型 perationType见表33的12. M M 学员标识符 见表33的 12.2 traineeID 12.2 账 账号具有唯一性 号的命名可以包含大 M 13.1账号 学员的登录账号 usernamme 小写字母、数字,不可 a..20 使用特殊字符 根据实际情况慎重 13.2密码 password 学员的登录密码 确定 a..20 手机号码录人系统时 学员登记在系统中的 13.3手机号 mobileNunmber 需要校验，应真实 手机号 all 有效 包含以下几种 1;未激活 13,4账号状态 学员账号的当前状态 M accountStatus al 2:正常 3;冻结 GB/T 学员账号的首次激活 数据格式为YYmy 13.5激活时间 registerTime 时间 7408一2005 MMDDhhmm 注;“约束”栏内M表示“必备”数据元素,0表示“可选”数据元素 8.2.3组织机构数据同步接口 组织机构数据同步接口的基本信息包括 接口说明;服务提供方向服务发起方推送已有组织机构数据,接收方比对双方数据,并发回增 量数据以实现同步; 实时性要求:即时同步; 接口参数;组织机构数据同步接口参数见表36. -接口请求:组织机构数据同步的接口请求见表37,请求样例参见A.6; -接口响应:组织机构数据同步的接口响应见表3,响应样例参见A.7 17
GB/T38863一2020 表36组织机构数据同步接口参数表 心 数 接口地址 https://HOST/data/syne 方法 POST organizationlnfo body,.type 表37组织机构数据同步接口请求表 编号 中文名称 英文名称 定义 约束值域数据类型 说明 M 12.1操作类型 operntionType 见表33的12. 组织机构标 organizationlD M 见表4的1.4 1.4 识符 14.1组织机构名称organizationName 该机构的正式全称 M a..100 14.2组织机构简称organizationshortNanme 该机构的正式简称 M a..50 上级组织机构标识 上级组织机构 该机构上级单位的组 14.3 super(OrgID 符,如果是一级机 标识符 织机构标识符 a..18 构则为“NUl.1”" 统一社会信用代码 遵循GB32100- 统一社会信用 015,若本机构非 机构法人的统一社会 UscID 14.4 代码 信用代码 a..18 法人机构,则填写 上级机构法人的统 -社会信用代码 注“约束”栏内M表示“必备”数据元素.0表示“可选”数据元素 8.2.4课程数据同步接口 8.2.4.1课程信息数据同步接口 课程信息数据同步接口的基本信息包括 -接口说明;服务提供方向服务发起方推送本平台课程信息数据 实时性要求即时同步; -接口参数:课程信息数据同步接口参数见表38; 接口请求;课程信息数据同步的接口请求见表39,请求样例参见A.6 -接口响应;课程信息数据同步的接口响应见表3,响应样例参见A.7 18
GB/T38863一2020 表38课程信息数据同步接口参数表 数 值 接口地址 https://HOST7/data/push POST 方法 coursenfo body.type 表39课程信息数据同步接口请求表 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 12.1操作类型 operationType 见表33的12.1 M 15.1课程编号 courseID 课程的唯一标识符 M a.32 15.2课程名称 courseName 课程的全称 M a..200 按照某种分类方法 M 15.3课程类别 courseCategory 确定的课程所属 aa..1000 类别 关键字间以半 15.4课程关键字courseKeyword 课程关键字字符串 M aa..1000 角逗号分隔 M 15.5课程简介 courselntroduction 课程的简单介绍 a..2000 课程提供 提供课程的单位 courseProvider M 15.6 a.200 名称 机构 培训机构标 M 见表13的2.l trainingOrganizationlD 识符 培训机 构 training(OrganizationName培训机构的全称 M 15." 名称 aa..1000 包括课程的主讲教 M 15.8授课教师 师、其他授课教师 lecturers aa..100 等主要信息列表 关于授课教师的简 15.9教师简介 lecturerlntroductio 单介绍 a..500 GB/I 课程上传到网络并 数据格式为 15.1o发布日期 publishDate M 激活的日期 74082005 YYYYMMDD 课程从网络上删除 数据格式为 GB/T 15.11停用日期 offlineDate 或者课程被停用的 7408一2005 YYYYMMDD 日期 19
GB/T38863一2020 表39(续 数据类型 编号 中文名称 英文名称 定义 约束 值域 说明 对于某些时效性强 预计停用 GB/T 数据格式为 15.12 的课程,所预先设 expireDate 日期 YYYYMMDD 7408一2005 定的课程失效日期 包含但不限 于以下几种 01:视频 课程的基本呈现 02;音频 15.13课程形式 courseFormm O 03;多媒体 形式 a2 04;VR/AR/ MR 99;其他 M 15.14学时 creditHour 课程经认定的学时 以分为单位， 预计学员完成课程 如;音视频的 15.15课程时长 courseDuration 学习所需要投人的 播放时间，课 时间 程资源学习阅 读的时间 包含以下 课程考核 儿种: 15.16 课程的考核类型 courseAssessementType 方式 0;无考核 al 1;有考核 注;“约束”栏内M表示“必备”数据元素,0表示“可选”数据元素 8.2.4.2课程学习结果记录同步接口 课程学习结果记录同步接口的基本信息包括 接口说明服务提供方向服务发起方推送本平台在线选学课程学习结果记录信息 实时性要求:即时同步; -接口参数:课程学习结果记录同步接口参数见表40: -接口请求;课程学习结果记录同步的接口请求见表41,请求样例参见A.6; -接口响应;课程学习结果记录同步的接口响应见表3,响应样例参见A.7 表40课程学习结果记录同步接口参数表 数 值 接口地址 https:/HOST/data/push POST 方法 body.type courselL.earningRecord 20
GB/T38863一2020 表41课程学习结果记录同步接口请求表 英文名称 数据类型 编号 中文名称 定义 约束 值域 说明 M 12.1操作类型 见表33的12.l operationType 培训机构标 2.1 trainingOrganizationlD 见表13的2. M 识符 15.7培训机构名称trainingOrganizationName 见表39的15.7 M 15.1课程编号 courselD 见表39的15.1 15,2课程名称 courseName 见表39的15.2 M 若课程归属 于某一专题 专题班的唯一标 TBTPID M 专题班编号 班，则需同 16.1 a.32 识符 时记录专题 班编号 M 5.14学时 见表39的15.14 creditHour 包含但不限 于以下几种: 专题班开展 16.2培训方式 trainingMode M 1;在线 培训开展的方式 al 的方式 2:线上线下 3:其他 15,3课程类别 coursCategory 见表39的15.3 类型如下 课程是否是选 16.3学习类型 learningType 1;选修课 修课 al 2;必修课 课程当日所有学 N 课程学习时长curenrcourseleamingDuration员学习的时长M 16.4 累积 课程通过总 课程当日完成学 16.5 currentCompleteTraineeSum 习的学员总数 人数 注;“约束”栏内M表示“必备”数据元素.O表示“可选”数据元素 专题班数据同步接口 8.2.5 专题班信息数据同步接口 8.2.5.1 专题班信息数据同步接口的基本信息包括 接口说明;服务提供方向服务发起方推送专题班信息数据 实时性要求:即时同步; 接口参数;专题班信息数据同步接口参数见表42 接口请求:专题班信息数据同步的接口请求见表43,请求样例参见A.6; 接口响应;专题班信息数据同步的接口响应见表3,响应样例参见A.7 21
GB/T38863一2020 表42专题班信息数据同步接口参数表 数 值 接口地址 https://HOST7data/push P(OST 方法 TBTPinfo body.type 表43专题班信息数据同步接口请求表 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 M 12.1操作类型 operationType 见表33的12.1 专题班计划 专题班计划的唯一标 M 17.1 TBTPplanlD 编号 识符 aa..32 TBTPID 6.1专题班编号 见表41的16. M M 17.2专题班名称 TBTPname 专题班的全称 a.200 M 17.3内容简介 专题班的介绍 briefIntroduction a..1000 允许参加专题班培训 17.4培训对象 TBTPobjeet M 的学员范围 a..500 GB/T 数据格式为 M 17.5学习开始时间startDate 专题班的开始时间点 7408一2005 YYYYMMDD GB/T 数据格式为 M 17.6学习截止时间dueDate 专题班的结束时间点 74082005 YYYYMMDD 包含但不限 F 以下儿 种: 7.7专题班状态 专题班的状态 M TBTPstatus 1;未开始 a 2;进行中 3;已结束 列表格式为 [课程编号 专题班课程 学员在专题班要求完 1，课程名称 17.8 TBTPeourseList ,[课程 成的课程列表 a..5000 列表 1]， 编号n，课程 名称]1 必修课考核 专题班关于必修课完 M 17.9 compulsoryCondition 要求 成数量和学时的要求 a..100 选修课考核 专题班关于选修课完 M 17.10 eleetiveCondition 要求 成数量和学时的要求 a..100 22
GB/T38863一2020 表43(续 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 专题班计划培训的人 M 17.l1计划学员人数 -般为培训对象 planTraineeCount 数， 人员的总数 专题班对于学员完成 7.12学时要求 creditHourRequirement M 学时数量的要求 列表格式为 [主办单位标 识符l,主办单 专题班主办单位的组 M 17.13主办单位列表 位名称1], hostList 织机构列表 a..500 [主办单位标 识符n，主办 单位名称] 列表格式为 [承办单位标 识符1,承办单 专题班承办单位的组 7.14承办单位列表organizerlist 位名称1], M 织机构列表 a.500 [承办单位标 识符n，承办 单位名称] 列表格式为 [协办单位标 识符1,协办单 专题班协办单位的组 17.15协办单位列表 位名称], lco0OrganizerlList 织机构列表 a..500 [协办单位标 识符n，协办 单位名称n] 指定学员名单 17.16 指定学员名单列表 designatedTraineelist 列表 a.5000 17.17报名人数 专题班已报名人数 enrollmentCount 专题班已报名人员 17.18报名人员列表enrollmentList 列表 a.5000 M 17.19结业人数 completionCount 专题班已结业人数 有关专题班统计的 TBTPstatisties M 17.20专题班统计 属性 23
GB/T38863一2020 表43(续 数据类型 编号 中文名称 英文名称 定义 约束 值域 说明 包括学员标识 7.21结业学员列表 所有结业人员的列表 符、学员姓名、 lcompletersIist a.10000 证书编号 列表格式为 [发证单位标 识符1,发证单 颁发专题班证书的单 17.22发证单位列表certifeateOrganizationlist M 位名称1], 位列表 a..500 [发证单位标 识符n，发证 单位名称] 注“约束”栏内M表示“必备”数据元素,0表示“可选”数据元素 8.2.5.2专题班课程数据同步接口 专题班课程数据同步接口的基本信息包括 -接口说明服务提供方向服务发起方推送专题班课程数据 实时性要求;即时同步; -接口参数:专题班课程数据同步接口参数见表44 接口请求;专题班课程数据同步的接口请求见表45,请求样例参见A.6 接口响应:专题班课程数据同步的接口响应见表3,响应样例参见A.7 表44专题班课程数据同步接口参数表 数 值 接口地址 https://HOST7/data/push PO)s1 方法 TBTPcourselnfo body.type 表45专题班课程数据同步接口请求表 编号 中文名称 英文名称 定义 约束 值域 数据类型说明 12.1操作类型 operationType 见表33的12.1 M M 16.l 专题班编号 TBTPID 见表41的16.1 17.7专题班状态 TBTPstatus 见表43的17.7 M 15.1课程编号 courselD 见表39的15.l M 5.2课程名称 见表39的15.2 courseName 15.3课程类别 见表39的15.3 course(Category 24
GB/T38863一2020 表45(续 编号 中文名称 英文名称 定义 约束 值域 数据类型说明 类型如下 专题班课程是选修课或 18.1课程类型 1;必修课 courseType 必选课 al 2;选修课 5.4课程关键字 见表39的15.4 courseKeywordl 15.5课程简介 见表39的15.5 courselntroduction 15.6课程提供机构 courseProvider M 见表39的15.6 5.14学时 M creditHour 见表39的15,14 5.15课程时长 见表39的15,.15 courseDuration 15.16课程考核方式 courseAssessementType 见表39的15,16 M 15.1o发布日期 publishDate 见表39的15.10 offtneDate 15.l11停用日期 见表39的 15.11 O 见表39的15.12 15.12预计停用日期 expireDate O O 15.13课程形式 courseForm 见表39的15.13 5.8授课教师 M lecturers 见表39的15.8 教师简介 见表39的15.9 15.9 lecturerlntroduction 注;“约束”栏内M表示“必备”数据元素,o表示““可选”数据元素 8.2.5.3专题班课程学员学习记录同步接口 专题班课程学员学习记录同步接口的基本信息包括 接口说明:服务提供方向服务发起方推送专题班课程学员学习进度的记录 实时性要求;即时同步 -接口参数:专题班课程学员学习记录同步接口参数见表46; -接口请求;专题班课程学员学习记录同步的接口请求见表47,请求样例参见A.6; 接口响应:专题班课程学员学习记录同步的接口响应见表3,响应样例参见A.7 表46专题班课程学员学习记录同步接口参数表 参 数 值 https;//H0ST}/data/push 接口地址 P(OST 方法 ody.type TBTPcourselearningRecord 25
GB/T38863一2020 表47专题班课程学员学习记录同步接口请求表 编号 数据类型 中文名称 英文名称 定义 约束 值域 说明 12.1操作类型 见表33的12.1 M operationType 培训机构标 2.1 training(OrganizationlD见表13的2.1 M 识符 6.1专题班编号TBTPID 见表41的16.1 M 课程编号和 课程唯一标识符及对 M 19.1 couurselIDandNamelist 名称列表 应名称的信息列表 a..5000 2.2学员标识符trainel M 见表33的12.2 专题班学习 GB/T 学员首次进人专题班 数据格式为 TBTPstartDate M 19.2 开始日期 学习的时间 74082005 YYYYMMDD 专题班学习 学员学完专题班获得 GB/T 数据格式为 19.3 TBTPfinishDate M 74082005 YYYYMMDD 完成日期 学时的时间 注;“约束”栏内M表示“必备”数据元素 专题班学习结果记录同步接口 8.2.5.4 专题班学习结果记录同步接口的基本信息包括 接口说明服务提供方向服务发起方推送学员专题班学习结果记录的信息 实时性要求即时同步; 接口参数;专题班学习结果记录同步接口参数见表48; 接口请求;专题班学习结果记录同步的接口请求见表49,请求样例参见A.6; 接口响应:专题班学习结果记录同步的接口响应见表3,响应样例参见A.7 表48专题班学习结果记录同步接口参数表 参 数 值 https:/HOST/data/push 接口地址 方法 POST body.type TBTPcertifiecatelnfo 表49专题班学习结果记录同步接口请求表 编号中文名称 英文名称 定义 约束 值域 数据类型 说明 2.1操作类型 见表33的12.l M operationType 16.1专题班编号TBTPID 见表41的16.1 M 12.2学员标识符traineeID 见表33的12.2 M 12.3学员姓名 traineeName 见表33的12.3 M 学员所属单 学员报名时所属单位 20.1 trainee(OrganizationName M 位名称 的组织机构名称 a100 26
GB/T38863一2020 表49(续 编号 中文名称 英文名称 定义 约束 值域 数据类型 说明 学员报名时所属单位 学员所属单 M trainee(OrganizationlD 20.2 位标识符 的组织机构标识符 al8 专题班学习 M 19.2 TBTPstartDate 见表47的19.2 开始日期 专题班学习 19.3 TBTPfinishDate 见表47的19.3 M 完成日期 完成专题班学习后所 M 专题班学时TBTPereditHour 20.3 获得的学时 列表格式为 [课程标识符 学员完成的 学员在专题班学习中 1，课程名称 20.4专题班课程TBTPtrainee(CourseList 所完成的课程的列表 a..5000 1],,[课程 列表 标识符 n， 课 程名称n] 专题班结业证书的 20.5证书编号 certificateNO M 编号 a.100 专题班结业证书文件 20,6证书电子版eCertifieate 所在的URL a..2048 签发专题班证书的 GB/T 数据格式为 发证日期 20.7 issuedDate M 日期 7408一2005 YYYYMMDD 注;“约束”栏内M表示“必备”数据元索,o表示“可选”数据元素 8.3数据查询接口服务 8.3.1支持查询的数据类别 支持查询的数据类别见表50. 表50查询接口服务支持查询的数据类别表 明 枚举值 说 userlnfo 学员信息 ourseSharedlnfo 课程信息 课程学习结果记录 courseLearningRecord TBTPsharedlnfo 专题班信息 TBTPlearningRecord 专题班学习结果记录 27

GB/T38863-2020干部网络培训平台数据接口技术要求

一、引言

随着互联网的快速发展，网络培训逐渐成为一种新型的培训方式。干部网络培训平台作为一种常见的网络培训平台，已经得到了广泛的应用。

干部网络培训平台通过开辟课程、组织学习、考核测评等多种方式，促进了干部的学习和成长。而数据接口技术则是支撑干部网络培训平台正常运行的关键技术之一。

二、数据接口技术的定义

数据接口技术是支撑干部网络培训平台中各个模块之间数据传递和交互的技术手段。它能够将各个模块的数据以标准的格式进行交换，从而实现了模块之间的无缝衔接。

在干部网络培训平台中，数据接口技术主要用于以下几个方面：

• 用户管理：实现用户信息的共享和同步；
• 课程管理：实现课程信息的发布、修改和删除；
• 学习管理：实现学习记录的保存和查询；
• 答题管理：实现试卷的生成和批改。

三、GB/T38863-2020标准的介绍

GB/T38863-2020是国家标准化管理委员会发布的干部网络培训平台数据接口技术规范。该标准规定了干部网络培训平台中各个模块之间数据传递和交互所需的技术要求和标准。

该标准主要包括以下内容：

1. 接口类型与命名规则；
2. 接口参数与返回值规范；
3. 接口数据格式规范；
4. 接口调用方式规范；
5. 接口安全性规范。

四、数据接口技术在干部网络培训平台中的应用

数据接口技术在干部网络培训平台中具有广泛的应用价值。它能够为干部网络培训平台带来以下几个方面的好处：

• 提高系统的稳定性和可靠性；
• 实现各个模块之间的数据共享和同步；
• 简化系统的开发和维护流程；
• 提高系统的安全性。

五、结论

数据接口技术是干部网络培训平台中不可或缺的重要技术手段。GB/T38863-2020标准的发布，将进一步规范干部网络培训平台中数据接口技术的应用和开发，提高其稳定性、可靠性和安全性，为干部网络培训平台的健康发展提供了坚实的技术保障。

我们相信，在数据接口技术的支持下，干部网络培训平台将能够更好地服务于干部队伍建设，为实现中国梦提供强有力的人才支撑。

干部网络培训平台数据接口技术要求的相关资料

和干部网络培训平台数据接口技术要求类似的标准

GB/T38863-2020

干部网络培训平台数据接口技术要求

2022/7/22 17:36:16 现行

GB/T38858-2020

干部网络培训平台数据要求

2022/7/22 16:09:02 现行