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