DB14_T 2540—2022财政业务系统数据交换中心接口规范-（高清正版）.pdf

ICS35.080CCS L 7714山西省地方标准DB 14/T 25402022财政业务系统数据交换中心接口规范2022-09-02 发布2022-12-01 实施山西省市场监督管理局发 布DB 14/T 25402022I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15基本要求.26接口组成.3参考文献.6DB 14/T 25402022II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会(SXS/TC48)归口。本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院。本文件主要起草人：李林骏、韩慧彦、张宝林、张素娥、王伟、赵姝、邢振军。DB 14/T 254020221财政业务系统数据交换中心接口规范1范围本文件规定了财政业务系统数据交换中心接口的术语和定义、缩略语、基本要求和接口组成。本文件适用于财政业务系统数据交换中心接口的设计、开发和应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。IETF RFC 3629UTF-8,ISO 10646 转换格式（UTF-8,a transformation format of ISO 10646）3术语和定义下列术语和定义适用于本文件。3.1数据交换中心将财政内生、外部数据统一规划并进行规范存储，为数据的分发和分析提供数据基础的管理系统。3.2Base64一种基于 64 个可打印 ASCII 字符对任意字节数据进行编码的算法。3.3第三方系统与财政业务系统数据交换中心交互的其他系统。3.4注册中心存储第三方系统 IP 地址和系统认证信息的服务。4缩略语下列缩略语适用于本文件。HTTP:超文本传输协议（Hyper Text Transfer Protocol）DB 14/T 254020222JSON:JS 对象简谱/对象标记（JavaScript Object Notation）URL:统一资源定位符（Uniform Resource Locator）5基本要求5.1接口协议接口协议统一采用 HTTP 协议。5.2数据结构5.2.1基本数据类型接口基本数据类型见表 1。表 1基本数据类型类型名类型名类型描述类型描述类型约束类型约束String文本字符串内容为所有的有效字符List列表类型每一项均为一个子数据项，子数据项编码方式与父数据项编码方式相同Date日期类型日期表示为：yyyymmddFloat浮点数类型内容为浮点数类型字符Int整数类型内容为整型字符File文件流类型内容为对文件的操作定义Boolean布尔类型内容为 True 或 False5.2.2数据编码方式应符合 IETF RFC 3629 的规定。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验证和授权通过以下两种方式进行：DB 14/T 254020223确保相互访问的地址是可信任的，相关证书通过数字签名进行验证；IP 验证仅为初步验证请求来源的合法性方法。应将第三方系统的 IP 及相关认证信息存储至注册中心，财政业务系统数据交换中心在收到请求时，将请求的 IP 和系统认证信息及注册中心进行对比，确认请求源的合法性。5.4.5财政业务系统数据交换中心应通过请求频率和请求配额对单一请求方进行限制。5.4.6应通过数字签名校验保证数据不被篡改。6接口组成6.1接口列表财政业务系统数据交换中心应支持的接口见表 2。表 2接口列表接口名称接口名称接口描述接口描述数据新增接口本接口用于第三方系统向财政业务系统数据交换中心发送数据新增请求数据更新接口本接口用于第三方系统向财政业务系统数据交换中心发送数据更新请求数据删除接口本接口用于第三方系统向财政业务系统数据交换中心发送数据删除请求数据查询接口本接口用于第三方系统向财政业务系统数据交换中心发送数据查询请求6.2数据新增接口数据新增接口见表 3。表 3数据新增接口接口名称接口名称数据新增接口接口接口URLURLhttp:/ip:port/dmp/v2/agency?token=接口请求方式接口请求方式POST请求参数请求参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明appidString是用户 appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户 token，每次调用服务前获取一次，有效期默认 7200 秒bodyString是post 请求 body 参数消息体,JSON 格式响应参数响应参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明DB 14/T 254020224接口名称接口名称数据新增接口codeString是code 等于 200 表示成功，其他表示失败6.3数据更新接口数据更新接口见表 4。表 4数据更新接口接口名称接口名称数据更新接口接口接口URLURLhttp:/ip:port/dmp/v2/agency?token=接口请求方式接口请求方式POST请求参数请求参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明appidString是用户 appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户 token，每次调用服务前获取一次，有效期默认 7200 秒bodyString是post 请求 body 参数消息体,JSON 格式响应参数响应参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明codeString是code 等于 200 表示成功，其他表示失败6.4数据删除接口数据删除接口见表 5。表 5数据删除接口接口名称接口名称数据删除接口接口接口URLURLhttp:/ip:port/dmp/v2/agency?&token=&where=接口请求方式接口请求方式POST请求参数请求参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明appidString是用户 appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户 token，每次调用服务前获取一次，有效期默认 7200 秒whereString是JSON 格式的删除条件响应参数响应参数DB 14/T 254020225接口名称接口名称数据删除接口参数名称参数名称数据类型数据类型是否必填是否必填说明说明codeString是code 等于 200 表示成功，其他表示失败6.5数据查询接口数据查询接口见表 6。表 6数据查询接口接口名称接口名称数据查询接口接口接口URLURLhttp:/ip:port/dmp/v2/agency?&token=&pagesize=&pagenum=&where=接口请求方式接口请求方式POST请求参数请求参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明appidString是用户 appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户 token，每次调用服务前获取一次，有效期默认 7200 秒pagesizeInt否每页行数，最多 500 行pagenumInt否读取页码，默认第 1 页，循环读取所有页updatetimeString否时间戳字段，仅提取时间戳以后的时间，空返回全部数据whereString否JSON 格式的取数条件，空返回全部数据响应参数响应参数参数名称参数名称数据类型数据类型是否必填是否必填说明说明codeString是code 等于 200 表示成功，其他表示失败DB 14/T 254020226参考文献1 GB/T 2260中华人民共和国行政区划代码2 GB/T 22239信息安全技术 网络安全等级保护基本要求3 GB/T 35273信息安全技术 个人信息安全规范