DB37∕T 4225—2020 政务信息资源 数据服务接口规范(山东省).pdf
《DB37∕T 4225—2020 政务信息资源 数据服务接口规范(山东省).pdf》由会员分享,可在线阅读,更多相关《DB37∕T 4225—2020 政务信息资源 数据服务接口规范(山东省).pdf(13页珍藏版)》请在文库网上搜索。
1、ICS35.240CCS L 67山东省地方标准DB37/T 4225202037政务信息资源数据服务接口规范Government information resourcesData service interface specification2020 - 11 - 26 发布2020 - 12 - 26 实施山东省市场监督管理局发 布FORMTEXT DB37/T FORMTEXT 4225 FORMTEXT 2020I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15服务接口要求.26服务提供要求.47服务使用要求.48服务安全要求.5附录 A(资料性)服务接口注
2、册信息表模板. 6附录 B(资料性)服务接口描述信息填写示例. 7附录 C(资料性)服务使用申请信息表模板. 9参考文献.10FORMTEXT DB37/T FORMTEXT 4225 FORMTEXT 2020II前言本文件按照GB/T 1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省大数据局提出、归口并组织实施。本文件起草单位:山东省大数据局、山东省大数据中心、山东新一代标准化研究院有限公司、山东省计算中心(国家超级计算济南中心)。本文件主要起草人:石伟、王伟、李德金、张媛、
3、王旭东、张昭、傅川、王建坤、张荣光、王茜、柯林森、马金钊、金龙、史丛丛、王溪、李杨、逄锦山。FORMTEXT DB37/T FORMTEXT 4225 FORMTEXT 20201政务信息资源数据服务接口规范1范围本文件规定了政务信息资源的数据服务接口要求、提供要求、使用要求和安全要求。本文件适用于政务信息资源数据服务接口的设计、开发和实施。注:本文件规定的政务信息资源数据为政务业务办理中产生的结构化数据。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中, 注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)
4、适用于本文件。GB/T 222392019信息安全技术网络安全等级保护基本要求GB/T 352732020信息安全技术个人信息安全规范DB37/T 3521.12019政务信息资源目录第1部分:编码规则DB37/T 3523.22019公共数据开放第2部分:数据脱敏指南3术语和定义下列术语和定义适用于本文件。3.1数据服务data service通过一定的技术手段,对外提供政务信息资源。4缩略语下列缩略语适用于本文件。API:应用程序接口(Application Programming Interface)APP:移动应用(Application)HTML5:超文本标记语言5.0(Hyper
5、Text Markup Language 5.0)IP:网络互连协议(Internet Protocol)JSON:JavaScript对象简谱(JavaScript Object Notation)REST:表述性状态传递(Representational State Transfer)RPC:远程过程调用(Remote Procedure Call)SDK:软件开发工具包(Software Development Kit)SOAP:简单对象访问协议(Simple Object Access Protocol)UTF-8:Unicode的可变长度字符编码(8-bit Unicode Tran
6、sformation Format)WSDL:Web服务描述语言(Web Services Description Language)XML:可扩展标记语言(Extensible Markup Language)FORMTEXT DB37/T FORMTEXT 4225 FORMTEXT 202025服务接口要求5.1服务接口设计原则服务接口设计原则主要包括:a)安全性原则:应提供多种安全可靠的技术手段,保证服务接口的安全;b)开放性原则:应采用通用的接口设计标准,保证与其他系统的互联互通;c)灵活性原则:应能根据业务变化,灵活调整接口性能;d)松耦合原则:应避免服务提供方的业务系统对服务接口
7、实现的依赖。5.2服务接口名称服务接口名称应采用中文名称,由服务提供方名称、信息资源名称和接口分类三部分组成。服务提供方名称宜使用国家规定的部门简称,如山东省公安厅简称为省公安厅。注1:部门简称可参照山东省人民政府办公厅关于印发省政府机构简称的通知(鲁政办字2018203号)。注2:服务提供方:政务信息资源数据服务接口的提供部门。注3:服务接口的英文表示名称为中文名称的汉语拼音简写,且首字母大写。5.3服务接口编码服务接口编码由接口提供类型编码、政务信息资源编码、接口分类编码和接口顺序码四部分组成,编码结构见图1。图 1服务接口编码结构服务接口编码规则如下:a)第 1 位为接口提供类型编码,使
8、用 1 位阿拉伯数字表示, “0”标识服务提供方开发接口, “1”标识省一体化大数据平台统一开发接口;b)第 213 位为政务信息资源编码,使用 12 位阿拉伯数字表示,由政务部门系列顺序码和信息资源顺序码组成,编码规则应符合 DB37/T 3521.12019 中 4.2 的规定;c)第 14 位为接口分类编码,使用 1 位阿拉伯数字表示,编码范围为 19,分类编码见 5.4;d)第 1517 位为接口顺序码, 使用 3 位阿拉伯数字表示, 用于标识同一接口分类下的接口顺序,编码范围为 001999。5.4服务接口分类服务接口分类见表1。FORMTEXT DB37/T FORMTEXT 42
9、25 FORMTEXT 20203表 1接口分类代码代码分类名称1查询类2验证类3数据传输类4下载类9其他类5.5服务接口技术要求服务接口技术要求包括但不限于:a)接口方式:一般包括 WebService 和 REST 两种方式,WebService 服务描述的内容格式应符合WSDL 1.1,服务消息封装应符合 SOAP 1.1/1.2 标准,REST 服务消息封装应符合 HTTP 1.0/1.1标准,若为 REST 方式,应标明 REST 操作;b)接口授权:服务提供方应对每条申请授权唯一的接口授权码,通过分配的接口密钥调用身份认证接口获取访问令牌,接口授权的安全要求包括但不限于 IP 地址
10、白名单、动态访问令牌;c)接口输入参数:1)REST 类型的服务接口,应允许在 header 里输入授权验证相关参数;2)WebService 类型的服务接口,不应在 header 中传递参数,应在 Body 中传递参数;3)传递参数为中文字符时,应采用 UTF-8 编码。d)接口返回数据:1)返回数据应采用固定格式封装,如 XML、JSON 等;2)服务接口调用失败,应通过返回码响应。5.6服务接口管理要求5.6.1概述通过服务接口访问时,应提供自动监管和异常处理能力,并统一管理管控参数。5.6.2接口注册服务接口注册要求包括但不限于:a)应提供测试样例,确保服务使用方能对服务接口进行测试;
11、b)应填写准确的技术联系人信息;c)应填写服务接口注册信息表,经服务管理方审核通过后正式发布,服务接口注册信息表模板见附录 A。注1:服务使用方:政务信息资源数据服务接口的使用部门。注2:服务管理方:政务信息资源数据服务接口的管理部门。5.6.3接口发布服务接口发布要求包括但不限于:a)服务管理方和服务提供方应负责服务接口统一发布;b)服务接口发布信息包括但不限于接口概述、接口名称、接口分类、接口方式、接口地址、接口授权、接口方法、输入输出参数和接口示例,接口描述信息表填写示例见附录 B。FORMTEXT DB37/T FORMTEXT 4225 FORMTEXT 202045.6.4接口变更
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB37T 42252020 政务信息资源 数据服务接口规范山东省 DB37 4225 2020 政务信息 资源 数据 服务 接口 规范 山东省