数据接口规范.docVIP

DB5110/T1—2023

DB5110/T1—2023

PAGEII

PAGEIII

?

DB5110

四川省（内江市）地方标准

DB5110/T6—2023

数据接口规范

DataInterfaceStandardSpecification

目??次

TOC\h\z\t前言、引言标题,1,参考文献、索引标题,1,章标题,1,参考文献,1,附录标识,1,一级条标题,3,二级条标题,4,三级条标题,5前??言 II

1范围 9

2引用文件 9

3术语和定义 9

3.1政务信息资源 9

3.2元数据 9

3.3数据服务化 9

3.4数据服务接口 9

4概述 9

5系统架构 10

6数据接口共享流程 11

6.1数据源 11

6.2接口接入 11

6.2.1数据表转RESTful服务接入 11

6.2.2RESTful接口接入 11

6.2.3WebService接口接入 11

6.2.4HTTP自定义服务接口接入 11

6.3目录发布 12

6.4使用审批 12

7接口开发要求 12

7.1接口方法 12

7.2接口要求 12

7.3返回参数 13

7.4状态码 13

8数据共享接口接入样例 13

附录A（资料性附录）JSON接口返回模板 14

附录B（资料性附录）数据表转RESTful服务接入样例 16

附录C（资料性附录）RESTful接口接入样例 18

附录D（资料性附录）WebService接口接入样例 19

附录E（资料性附录）HTTP自定义服务接口接入样例 21

参?考?文?献 23

前??言

标准号：DB5110/T6-2023。

标准名称：数据接口规范。

本标准部分按照GB/T1.1—2020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。

请注意：本标准的某些内容可能涉及专利，本标准的发布机构不承担识别这些专利的责任。

标准归口单位：由内江市大数据中心提出并归口。

标准起草单位：内江市大数据中心、四川云领智城信息科技有限公司、杭州数梦工场科技有限公司。

标准主要起草人：

DB5110/T6—2023

DB5110/T6—2023

PAGE22

PAGE23

PAGEI

数据接口规范

范围

本规范规定了内江市全市范围内数据资源共享的系统架构，定义了数据接口共享流程，为内江市数据资源共享接口的规划、实施和管理提供指导。

本规范适用于内江市数据资源共享接口的建设与设计工作，主要用于数据资源共享接口的提供方。

规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其必威体育精装版版本（包括所有的修改单）适用于本文件。

GB/T18391.1-2009信息技术元数据注册系统(MDR)第1部分：框架。

GB/T21062.3-2007政务信息资源交换体系第3部分：数据接口规范。

术语和定义

下列术语和定义适用于本接口规范。

政务信息资源

政务信息资源是指政务部门在履行职责过程中制作或获取的，以一定形式记录、保存的文件、资料、图表和数据等各类信息资源，包括政务部门直接或通过第三方依法采集的、依法授权管理的和因履行职责需要依托政务信息系统形成的信息资源等。

元数据

政务信息资源元数据是对政务数据资源特征的描述，包括：标识符、中文名称、提供部门、共享类型、开放类型、数据类型、字段名称、定义、值域、表示格式、备注等。

数据服务化

数据服务化是将政务数据资源转化为标准的数据服务接口的过程。

数据服务接口

数据服务接口是指信息建设过程中已开发完成，并在政务外网各信息系统间使用的服务接口。常见的数据服务接口协议包括WebService、RESTful、HTTP等。

概述

本规范中的信息资源是指符合国家政务信息资源共享要求的相关数据。

政务数据共享应遵循统筹规划、全面推进、统一标准、便捷高效、主动提供、依法管理、安全可控的原则。

可通过数据共享接口共享的政务数据资源不包括：

涉及国家秘密的；

涉及商业秘密的；

涉及个人隐私的；

法律法规规定不得开放的其他政府数据。

系统架构

依托于内江市政务信息资源数据中台提供的数据服务接口开发、接入、发布、共享能力，为全省政务部门及地市的业务系统提供高性能、高可靠的数据共享服务，整体系统架构参考图1。

内江市政务数据接口服务架构图

内江市政务信息资源共享