DB14-T 2540-2022 财政业务系统数据交换中心接口规范

ICS35.080CCSL7714IDB14/T2540—2022前言 2规范性引用文件 3术语和定义 4缩略语 5基本要求 26接口组成 3参考文献 6DB14/T2540—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会(SXS/TC48)归口。本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院。本文件主要起草人：李林骏、韩慧彦、张宝林、张素娥、王伟、赵姝、邢振军。1DB14/T2540—2022财政业务系统数据交换中心接口规范本文件规定了财政业务系统数据交换中心接口的术语和定义、缩略语、基本要求和接口组成。本文件适用于财政业务系统数据交换中心接口的设计、开发和应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。IETFRFC3629UTF-8,ISO10646转换格式（UTF-8,atransformationformatofISO10646）3术语和定义下列术语和定义适用于本文件。3.1数据交换中心将财政内生、外部数据统一规划并进行规范存储，为数据的分发和分析提供数据基础的管理系统。3.2Base64一种基于64个可打印ASCII字符对任意字节数据进行编码的算法。3.3第三方系统与财政业务系统数据交换中心交互的其他系统。3.4注册中心存储第三方系统IP地址和系统认证信息的服务。4缩略语下列缩略语适用于本文件。HTTP:超文本传输协议（HyperTextTransferProtocol）2DB14/T2540—2022JSON:JS对象简谱/对象标记（JavaScriptObjectNotation）URL:统一资源定位符（UniformResourceLocator）5基本要求5.1接口协议接口协议统一采用HTTP协议。5.2数据结构5.2.1基本数据类型接口基本数据类型见表1。表1基本数据类型每一项均为一个子数据项，子数据项编码方式与父5.2.2数据编码方式应符合IETFRFC3629的规定。5.2.3数据交换格式应采用JSON传输数据。5.3接口调用地址应向财政业务系统数据交换中心获取接口调用地址及端口号。5.4安全策略5.4.1在财政业务系统数据交换中心与第三方系统互联过程中，应采取必要的通信安全措施，采用TLS.IP验证、数字签名、用户身份验证等方法。5.4.2应采用Base64加密解密保证数据在传输过程中的机密性。5.4.3宜使用3DES、MD5及以上算法，保证数据在传输过程中的完整性。5.4.4验证和授权通过以下两种方式进行：3DB14/T2540—2022——确保相互访问的地址是可信任的，相关证书通过数字签名进行验证；——IP验证仅为初步验证请求来源的合法性方法。应将第三方系统的IP及相关认证信息存储至注册中心，财政业务系统数据交换中心在收到请求时，将请求的IP和系统认证信息及注册中心进行对比，确认请求源的合法性。5.4.5财政业务系统数据交换中心应通过请求频率和请求配额对单一请求方进行限制。5.4.6应通过数字签名校验保证数据不被篡改。6接口组成6.1接口列表财政业务系统数据交换中心应支持的接口见表2。表2接口列表本接口用于第三方系统向财政业务系统数据交换中本接口用于第三方系统向财政业务系统数据交换中本接口用于第三方系统向财政业务系统数据交换中本接口用于第三方系统向财政业务系统数据交换中6.2数据新增接口数据新增接口见表3。表3数据新增接口http://ip:port/dmp/v2/a是用户appid，服务注册时填写，交互时无需传输是是是4DB14/T2540—2022是6.3数据更新接口数据更新接口见表4。表4数据更新接口http://ip:port/dmp/v2/agency?t是用户appid，服务注册时填写，交互时无需传输是是是是6.4数据删除接口数据删除接口见表5。表5数据删除接口接口URL是用户appid，服务注册时填写，交互时无需传输是是where是5DB14/T2540—2022是6.5数据查询接口数据查询接口见表6。表6数据查询接口http://ip:port/dmp/v2/agency?&token=&pagesize=&pagenum=&是用户appid，服务注册时填写，交互时无需传输是是否否否where否是6DB14/