PDF《ICS 35.240》

b) 库表方式:以数据库表结构形式的交换方式,适用于体量大、数据增量更新频繁的数据交换;

c) 文件方式: 通过文件发送的方式将规范化的数据文件传送到指定的交换节点, 适用于非结构化 数据或更新较缓慢的结构化数据的交换. 5.2 服务接口 5.2.1 设计原则 服务接口设计的基本原则包括但不限于: a) 安全性原则:应提供多种安全可靠的技术手段,保证接口数据的安全;

b) 开放性原则:应采用通用的接口设计标准,保证与其他系统的互联互通;

c) 灵活性原则:应能根据业务变化,灵活调整接口容量与性能;

d) 松耦合原则:应避免提供方的业务系统对接口服务实现的依赖性. 5.2.2 基本要求 5.2.2.1 接口名称 接口名称应采用中文名称,由提供方名称、信息资源名称和接口分类三部分组成.提供方名称宜使 用国家规定的部门简称,如山东省公安厅简称为省公安厅. 5.2.2.2 接口分类 接口分为查询类、验证类、数据传输类、下载类及其他类,接口分类代码见表1. 表1接口分类代码 代码 分类名称

1 查询类

2 验证类

3 数据传输类

4 下载类

9 其他类 DB37/T 3522―2019

3 5.2.2.3 接口代码 服务接口代码由接口提供方代码、政务信息资源代码、接口分类代码和接口顺序码四部分组成,代 码结构见图1. 图1服务接口代码结构 服务接口代码编码规则如下: a) 第1位为接口提供方代码,使用

1 位大写英文字母表示, T 标识资源提供方开发接口, P 标识共享交换平台统一开发接口;

b) 第2~13 位为政务信息资源代码,使用

12 位阿拉伯数字表示,采用 DB37/T 3521.1―2019 信 息资源代码的后

12 位,编码范围从 000001000001~999999999999;

c) 第14 位为接口分类代码,使用

1 位阿拉伯数字表示,编码范围为 1~9,分类代码见 5.2.2.2 节;

d) 第15~16 位为接口顺序码, 使用

2 位阿拉伯数字表示, 用于标识同一接口分类下的接口顺序, 编码范围为 01~99. 5.2.3 技术要求 服务接口技术要求包括但不限于: a) 服务传输协议:应符合 HTTP/HTTPS 1.0/1.1 标准;

b) 服务消息协议:WebService 服务消息封装应符合 SOAP 1.1/1.2 标准;

REST 服务消息封装应符 合HTTP 1.0/1.1 标准;

c) 服务描述要求:服务描述的内容格式应符合 WSDL 1.

1、SOAP 1.1/1.2 标准. 5.2.4 开发要求 服务接口包括共享交换平台和提供方开发的接口.共享交换平台开发的接口应由需求方提出申请, 提供方提供系统IP地址、用户名、密码、接口功能名称等信息,并由共享交换平台接口开发人员编写需 求文档.服务接口开发要求包括但不限于: a) 接口名称:接口的中文名称应符合 5.2.2.1 的规定. b) 接口方式:一般包括 WebService 和REST 两种方式,若为 REST 方式,应标明 REST 操作. c) 接口方法:命名应采用大小写混合的形式,以小写字母开头,名称中其他单词的首字母以大写 字母开头,不宜使用下划线分割单词. d) 接口测试:接口应对共享交换平台开放测试权限,并提供测试用例. e) 接口授权:提供方授权的接口应明确管控参数 ApiKey. DB37/T 3522―2019

4 f) 接口参数: 1) REST 类型的服务接口,仅允许在 Header 里传入授权验证相关的参数,不允许使用共享交 换平台保留的参数名 AppKey、AppSecret、ApiKey、ApiSecret,POST 方式的接口支持在 Body 中传递 Application/JSON 格式的参数;