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

ICS35.08014CCSL7714山 西 省 地 方 标 准DB14/T2540—2022财政业务系统数据交换中心接口规范20222022090220221201山西省市场监督管理局  发布DB14/T2540DB14/T2540—2022DB14/T2540DB14/T2540—2022目 次前言 II范围 1规范性引用文件 1术语和定义 1缩略语 1基本要求 2接口组成 3参考文献 6II前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会(SXS/TC48)归口。本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院。本文件主要起草人：李林骏、韩慧彦、张宝林、张素娥、王伟、赵姝、邢振军。IIII财政业务系统数据交换中心接口规范范围本文件规定了财政业务系统数据交换中心接口的术语和定义、缩略语、基本要求和接口组成。本文件适用于财政业务系统数据交换中心接口的设计、开发和应用。规范性引用文件（包括所有的修改单适用于本文件。IETFRFC3629UTF-8,ISO10646（UTF-8,atransformationformatofISO10646）术语和定义下列术语和定义适用于本文件。3.13.1数据交换中心将财政内生、外部数据统一规划并进行规范存储，为数据的分发和分析提供数据基础的管理系统。3.2Base6464ASCII3.3第三方系统与财政业务系统数据交换中心交互的其他系统。3.4注册中心IP4缩略语下列缩略语适用于本文件。HTTP:超文本传输协议（HyperTextTransferProtocol）1数据编码方式应符合IETFRFC3629的规定。数据编码方式应符合IETFRFC3629的规定。数据交换格式应采用JSON传输数据。接口调用地址应向财政业务系统数据交换中心获取接口调用地址及端口号。安全策略在财政业务系统数据交换中心与第三方系统互联过程中，应采取必要的通信安全措施，采用TLS.IPBase643DES、MD5验证和授权通过以下两种方式进行：2JSON:JS对象简谱/对象标记（JavaScriptObjectNotation）URL:统一资源定位符（UniformResourceLocator）基本要求接口协议接口协议统一采用HTTP协议。数据结构基本数据类型接口基本数据类型见表1。表1基本数据类型类型名类型描述类型约束String文本字符串内容为所有的有效字符List<>列表类型每一项均为一个子数据项，子数据项编码方式与父数据项编码方式相同Date日期类型日期表示为：yyyymmddFloat浮点数类型内容为浮点数类型字符Int整数类型内容为整型字符File文件流类型内容为对文件的操作定义Boolean布尔类型内容为True或False6.2数据新增接口6.2数据新增接口3。表3数据新增接口3——确保相互访问的地址是可信任的，相关证书通过数字签名进行验证；——IPIPIP财政业务系统数据交换中心应通过请求频率和请求配额对单一请求方进行限制。应通过数字签名校验保证数据不被篡改。接口组成接口列表财政业务系统数据交换中心应支持的接口见表2。表2接口列表接口名称接口描述数据新增接口本接口用于第三方系统向财政业务系统数据交换中心发送数据新增请求数据更新接口本接口用于第三方系统向财政业务系统数据交换中心发送数据更新请求数据删除接口本接口用于第三方系统向财政业务系统数据交换中心发送数据删除请求数据查询接口本接口用于第三方系统向财政业务系统数据交换中心发送数据查询请求接口名称数据新增接口接口URLhttp://ip:port/dmp/v2/agency?token=接口请求方式POST请求参数参数名称数据类型是否必填说明appidString是用户appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户token，每次调用服务前获取一次，有效期默认7200秒bodyString是post请求body参数消息体,JSON格式响应参数参数名称数据类型是否必填说明6.4数据删除接口6.4数据删除接口5。表5数据删除接口4接口名称数据新增接口codeString是code等于200表示成功，其他表示失败6.3数据更新接口数据更新接口见表4。表4数据更新接口接口名称数据更新接口接口URLhttp://ip:port/dmp/v2/agency?token=接口请求方式POST请求参数参数名称数据类型是否必填说明appidString是用户appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户token，每次调用服务前获取一次，有效期默认7200秒bodyString是post请求body参数消息体,JSON格式响应参数参数名称数据类型是否必填说明codeString是code等于200表示成功，其他表示失败接口名称数据删除接口接口URLhttp://ip:port/dmp/v2/agency?&token=&where=接口请求方式POST请求参数参数名称数据类型是否必填说明appidString是用户appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户token，每次调用服务前获取一次，有效期默认7200秒whereString是JSON格式的删除条件响应参数接口名称数据删除接口参数名称数据类型是否必填说明codeString是code等于200表示成功，其他表示失败6.5数据查询接口数据查询接口见表6。表6数据查询接口接口名称数据查询接口接口URLhttp://ip:port/dmp/v2/agency?&token=&pagesize=&pagenum=&where=接口请求方式POST请求参数参数名称数据类型是否必填说明appidString是用户appid，服务注册时填写，交互时无需传输tablenameString是数据表名，服务注册时填写，交互时无需传输tokenString是用户token，每次调用服务前获取一次，有效期默认7200秒pagesizeInt否每页行数，最多500行pagenumInt否读取页码，默认第1页，循环读取所有页updatetimeString否时间戳字段，仅提取时间戳以后的时间，空返回全部数据whereString否JSON格式的取数条