ICS 35.240.99 L 67 中华人民共和国国家标准 GB/T388632020 干部网络培训 平台数据接口技术要求 Online training for leadershipTechnical requirements for platform data interface 2020-07-21发布 2021-02-01实施 国家市场监督管理总局 发布 国家标准化管理委员会 GB/T38863—2020 目 次 前言 1 范围 2 规范性引用文件 3 术语和定义 缩略语 数据类型 5.1 基本数据类型 5.2 数据格式 5.3 值域 5.4 自定义数据类型 6 概述 数据参数 7.1 请求报文 7.2 响应报文 7.3 平台基本数据 7.4 系统事件类别 7.5 数据类别 8接口服务 8.1 接口管理服务 8.2 数据推送同步接口服务 8.3 数据查询接口服务 27 附录A（资料性附录） 接口样例 33 附录B（规范性附录） 平台数据接口清单 38 附录C（规范性附录) 异常状态码 GB/T38863—2020 前言 本标准按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任 本标准由中共中央组织部提出并归口。 本标准起草单位：华中师范大学、华东师范大学、北京邮电大学、中国电信集团有限公司、中国电子 技术标准化研究院， 本标准主要起草人：吴砥、吴晨、钱冬明、饶景阳、李青、李东、李欢冬、马兆钦、余云涛、史戈 GB/T38863—2020 干部网络培训平台数据接口技术要求 1范围 本标准适用于干部网络培训机构平台之间的数据传输和交换。 2 2规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件 GB/T3304—1991 中国各民族名称的罗马字母拼写法和代码 GB/T47621984政治面貌代码 数据元和交换格式信息交换 GB/T74082005 日期和时间表示法 GB/T124072008 职务级别代码 GB/T13000—2010 信息技术通用多八位编码字符集（UCS） GB32100—2015 法人和其他组织统一社会信用代码编码规则 GB/T38856—2020 干部网络培训业务管理通用要求 GB/T38858—2020 干部网络培训 平台数据要求 3 3术语和定义 GB/T38856—2020、GB/T38858—2020界定的术语和定义适用于本文件。 4 缩略语 下列缩略语适用于本文件。 AR：增强现实（AugmentedReality） ID：标识符（Identifier） MR：混合现实（MixedReality） PV：页面浏览量（PageView） TBTP:专题班（Theme-basedTrainingProject) URL：统一资源定位符（UniformResourceLocator） USCID：统一社会信用代码（UnifiedSocialCreditIdentifier) VR：虚拟现实（VirtualReality） 5 数据类型 5.1 基本数据类型 本标准中使用的数据类型和可取值见表1。 1 GB/T38863—2020 表1数据类型的取值 类型 表示 说明 字符型（string） c 以字符表达的数据元值的类型，可用于表达字母、数字、汉字和其他字符形式 数值型（numeric） N 以任意实数表达的数据元值的类型 以日期和时间表达的数据元值的类型，符合GB/T7408—2005，以YYYYMM 日期型（date） D DDhhmm的形式表达 集合（set) S 用于存放其他数据的容器，集合中可包含属性和其他集合 5.2 数据格式 指从业务的角度规定的数据元值的格式需求，包括所允许的最大或/和最小字符长度、数据元值的 表示格式等。数据格式中使用的字符含义如下： a）字母“a"表示字符； b）字母“n”表示数值； 字母“a"或“n”之后的自然数表示定长个字符（字符集默认为GB/T13000一2010），或数值的十 进制最大位数； （P 字符串“..ul表示长度不确定； 逗号“，”隔开的两个自然数“p，q”表示数值最大p个十进制位数，小数点后q位： (J 双点号“..”表示从最小长度到最大长度，前面附加最小长度，后面附加最大长度； g） 字符串“YYYYMMDDhhmm”中的“YYYY”表示年份，“MM”表示月份，“DD”表示日期，“hh” 表示小时，“mm”表示分钟，可以视实际情况组合使用。 5.3值域 值域是根据相应属性中规定的数据类型，长度而决定的数据元的充许值的集合。该集合可通过以 下方式给出： 通过参考和引用相关标准； 通过文字描述给出值域的限制； 通过一一列举的方式给出所有可能的取值以及每一个值对应的实例或含义； 一通过规则间接给出。 5.4自定义数据类型 用户可根据需要自行扩展和定义数据类型。 6概述 干部网络培训机构平台之间通过接口服务进行数据传输。接口服务分为三大类：接口管理服务、数 据推送同步接口服务和数据查询接口服务，如图1所示。 2 GB/T38863—2020 接口管理服务 数据推送同步接口服务 平台运行统计数据接 干部 学员信息数据同步接口 干部 红织机构数据同少接口 课程数据同步接 培训 专题班数据同少接口 培训 机构 ..... 机构 平台 台 数据查询接口服务 学员信息否询接口 课汛学习结果记录查询接口 专题班信息制接 专题班学习结染记录套询接口 图1干部网络培训机构平台数据接口 干部网络培训机构平台是数据服务交互过程的参与实体，所提供的服务包括管理服务和学习服务， 服务请求的发起者为“服务发起方”，服务请求的提供者为“服务提供方”。干部网络培训机构平台之间 的数据服务主要包括： 接口管理服务：处理服务发起方和服务提供方之间的应用请求； 数据推送同步接口服务：处理参与实体间的数据同步请求； 数据查询接口服务：处理服务发起方的查询请求，并由服务提供方返回结果。 报文样例参见附录A。 平台数据接口服务清单见附录B。 系统异常状态码见附录C。 数据参数 7.1 请求报文 请求报文的数据参数见表2，请求报文样例参见A.1。 表 2 请求报文的数据参数 数据块 中文名称 英文名称 定义 说明 平台编号 platformID 干部网络培训平台的唯一标识 head 平台私钥 platformKey 干部网络培训平台所拥有的私钥 （数据头） 自定义扩展信息 extension 数据头的可扩展的自定义信息 接口推送的数据内容分类类别 推送数据类别 type 参见7.5 hashcode 数据体哈希值 数据流的哈希值 用于请求报文数据一致性校验 body offset 数据偏移值 读取数据时的偏移值 （数据体） 数据长度 length 读取数据体内容的长度 报文中所包含的业务数据 数据体内容 content 数据体全部采用数组形式 3 GB/T38863—2020 7.2 响应报文 响应报文以加密数据的形式传输，数据参数见表3，响应报文样例参见A.2。 表3响应报文的数据参数 中文名称 英文名称 定义 说明 响应结果 response 请求是否成功响应的状态标识 出错信息 errorMessage 响应不成功时反馈的消息字符串 哈希值 hashcode 加密数据的校验码 数组数量 count 加密数据如果是数组时的数组数量 返回值 hasData 加密数据是否有返回值 返回值是否是数组 isArray 加密数据的数据结构是否是数组 加密数据 encryptData 数据加密后的内容 扩展数据 extension 可扩展的自定义信息 7.3 平台基本数据 接口传输所涉及的平台基本数据内容见表4。 表4平台基本数据表 编号 中文名称 英文名称 定义 约束 数据类型 值域 说明 干部网络培训平台的唯 c 1.1 平台标识符 platformID M 标识符 a..18 用于在数据传输时标识计 c 1,2 域名 domainName M 算机的电子方位 a..100 C 1.3 平台名称 干部网络培训平台的名称 platformName M a..200 c 机构具有的唯一标识符 1.4 组织机构标识符 organizationID M a..18 C 平台地址 1.5 服务平台接口地址 platformURL M a..2048 c 管理员编码（平台生 1.6 管理员编号 平台管理员的唯一标识符 managerID M a..32 成的唯一用户编码） 状态 1.7 平台状态 M status 状态标识 a32 注：“约束”栏内M表示必备”数据元素。 7.4 系统事件类别 系统事件类别见表5。 4