标准规范下载简介：

内容预览由机器从pdf转换为word，准确率92%以上，供参考

DBJ50／T-311-2019 城乡建设数据交换接口标准

3.1.1数据交换体系应以数据为主体构建，包括数据提供者，数 居使用者，数据管理者，信息库，数据交换平台和数据交换模式。 数据交换体系框架如图3.1.1所示。

3.1.1数据交换体系应以数据为主体构建，包括数据提供者，数

图3.1.1数据交换体系框架

3.1.2数据提供者应负责本单位资源目录编制.数据资源发布， 数据维护管理，数据更新等工作。 3.1.3数据使用者应根据应用需要负责查找数据资源目录，申 请数据等工作。 3.1.4数据管理者应负责对数据交换平台进行管理与运维，承 担数据交换流转过程的定义、用户身份识别与管理权限控制等 工作。 3.1.51 信息库宜包含共享信息库和前置交换信息库。 3.1.6数据交换平台应支撑数据提供者和数据使用者开展数据 交换活动。

ZBX73 001-1990 豉油海螺罐头数据维护管理.数据更新等工作。

3.1.4数据管理者应负责对数据交换平台进行管理与运维，承 担数据交换流转过程的定义、用户身份识别与管理权限控制等 工作。

息适配和信息安全的要求。

3.2.1数据交换应通过数据交换平台进行，平台宜包括数据标 准及目录，中心交换服务，传输交换服务前置交换服务交换接 口服务，安全与交换管理服务等功能。数据交换平台框架如图3. 2.1所示

3.2.2数据交换平台应符合以下规定：

图 3.2.1数据交换平台框架

1数据标准及目录服务应规定数据标准及目录规范，提供 资源目录上传/目录维护等服务； 2中心交换服务应集中存储共享信息库，数据提供者或使 用者通过访问共享信息库实现信息资源交换： 3交换传输服务应提供前置交换信息库之间的信息处理和 稳定可靠，不间断的信息传输： 4前置交换服务应提供数据提供者，数据使用者业务系统 与交换平台的隔离，保证数据提供者，数据使用者业务系统的独 立性： 5数据接口服务应提供数据库、数据文件的自动服务化，以

及数据接口的封装代理，为数据交换提供服务接口： 6安全与交换管理服务应提供对整个数据交换过程的流程 配置部署.执行和整个数据交换平台运行进行监控.安全管理。 3.2.3重庆市住房和城乡建设委员会应建设数据交换平台，为 城乡建设领域各单位提供数据交换服务：数据交换平台应具备与 部级，市级等上级数据共享交换平台进行对接功能。

3.2.4城乡建设领域各单位应通过重庆市住房和城乡建设委员

会数据交换平台开展数据交换活动：具备条件的单位可遵照本标 准建设自已的数据交换平台，但应与重庆市住房和城乡建设委员 会的数据交换平台实现对接。

3.3.1 数据交换模式宜提供集中式交换和分布式交换两种 模式。 3.3.2集中式交换模式应提供通过应用终端访问共享信息实现 数据交换。

3.3.3分布式交换模式应符合以下规定：

1应实现所有前置交换服务对外交换的信息均可由中心交 换服务进行数据传输： 2应实现数据提供者和数据使用者可通过前置交换服务之 间不通过中心交换服务点到点直接交换信息。

4.2.1数据资源应实行资源目录管理，并提供资源目录服务

1数据资源分类 必填项，参照相关国家标准规定的基本原则和方法，对政务 信息资源进行类项、目细目的四级分类。 2数据资源名称 必填项，描述数据资源内容的标题。 3数据资源代码 选填项，数据资源唯一不变的标识代码。 4数据资源提供方 必填项，提供该数据资源的单位。 5数据资源提供方代码 选填项，提供该数据资源的单位代码。 6数据资源摘要 必填项，对数据资源内容（或关键字段）的概要描述。 7数据资源格式 以填项，对数据荐在方式的描述，

5数据交换方式及技术要求

5.1.1数据提供者宜通过接口服务开发主动推送数据到数据交 换平台的数据推送交换方式，条件不具备的也可采用将业务系统 数据直接注册到数据交换平台由数据交换平台直接抓取业务系 统数据的数据抓取交换方式。

数据推送交换方式应符合以下规

1数据提供者应将业务系统数据资源推送到前置服务系 统，再通过前置服务系统将数据注册或上传到数据交换平台： 2数据使用者宜根据需要搭建前置服务系统，接收存储数 据交换平台推送的数据。 5.1.3数据抓敢交换方式应符合以下规定： 1数据提供者应将在线运行的业务系统数据资源直接注册 到数据交换平台： 2数据提供者应确保业务系统与数据交换平台间的网络

1数据提供者应将业务系统数据资源推送到前置服务系 统，再通过前置服务系统将数据注册或上传到数据交换平台 2数据使用者宜根据需要搭建前置服务系统，接收存储数 据交换平台推送的数据。

1数据提供者应将在线运行的业务系统数据资源直接注册 到数据交换平台； 2数据提供者应确保业务系统与数据交换平台间的网络 连通： 3 数据使用者宜利用数据交换平台提供的服务接口使用 数据。

5. 2数据交换技术要求

5.2数据交换技术要求

5.2.1数据交换技术宜支持数据库交换.数据接口交换.数据文 件交换。

.2数据库交换技术应符合以下

2 数据库宜支持主流关系型数据库： 3宜支持非关系型主流商业.开源大数据平台： 4数据提供者应提供数据库类型.数据库连接信息，用户 信息： 5数据提供者应确保共享的数据表数据字段并与数据资 源目录中数据资源，数据项一致： 6数据提供者提供的数据类型应支持在主流数据库之间进 行数据类型的转换，

信息： 5数据提供者应确保共享的数据表，数据享段并与数据资 源目录中数据资源，数据项一致： 6数据提供者提供的数据类型应支持在主流数据库之间进 行数据类型的转换。 5.2.3数据接口交换技术应符合以下规定： 1数据提供者应将数据接口注册到数据交换平台实现数据 2 应支持WebService.Http.Rest等多种类型服务接口； 3 宜支持OGC.ArcGIS等主流地理信息数据接口： 数据提供者应注册数据接口地址： 5 数据提供者应发布接口使用说明： 6数据提供者应建立接口返回值与数据资源目录中数据项 的对应关系。 5.2.4数据文交换技术应符合以下规定： 1数据提供者应将数据文件上传至数据交换平台或提供方 式供数据交换平台抓敢实现数据共享： 2应支持建筑图纸及BIM类格式的文件类型：dwgdws. dwt.dxf.cgr.pln.rvt.3ds.max.stp.vwx.nwd 等; 3应支持电子公文类格式的文件类型：ofd.wps.xml.txt. doc.docx.html.pdf.ppt.pptx等; 4应支持电子表格类格式的文件类型：et.xls.xlsx等： 5应支持数据库类格式的文件类型：符合常用数据库格式 Access.Sybase.Oracle.SQL Server.DB2.DM.KingbaseES 等 数据库系统。同时应明确具体的数据库表结构定义（可细化至

5.2.3数据接口交换技术应符合以下规定： 1数据提供者应将数据接口注册到数据交换平台实现数据 共享，数据交换平台应兼容主流接口类型， 应支持WebService，Http.Rest等多种类型服务接口 3 宜支持OGC.ArcGIS等主流地理信息数据接口： 4 数据提供者应注册数据接口地址： 5 数据提供者应发布接口使用说明： 6数据提供者应建立接口返回值与数据资源目录中数据项 的对应关系。 5.2.4数据文件交换技术应符合以下规定： 1数据提供者应将数据文件上传至数据交换平台或提供方 式供数据交换平台抓取实现数据共享；

5.2.3数据接口交换技术应符合以下规定

5.2.4数据文件交换技术应符合以下规定：

5.3.1数据传输协议应支持HTTP/HTTPS传输，支持消息传 输与文件传输。 5.3.2数据传输消息基础协议应支持国家政务信息资源交换体 系标准规定的消息格式。 5.3.3数据传输消息路由应包括基于消息内容的路由和基于消 息头的路由。 5.3.4数据传输消息交换模式应支持消息主动推送，请求/应 答，订阅/发布三种消息交换模式。 5.3.5数据传输应有可靠传输保障机制，宜通过断点续传.消 息确认和消息重发机制实现传输异常情况下数据交换“不丢，不 错不重”。

5.3.6数据传输应支持大文件传输。

6.1.1数据交换平台应提供对数据交换过程中数据安全保护 措施。 6.1.2数据提供者应提供数据在进入交换流程前的数据安全保 护措施。 6.1.3数据使用者应提供数据交换后应用过程中的数据安全保 护措施，在获得数据后，不得对外传播拷贝数据造成数据泄露。 外传。 6.1.4数据在网络传输过程中宜采用国产密码算法或措施防 改陆洲温

6.2.4用户申请有条件共享数据时,应提出明确的应用需求,

6.3数据接口使用权限认证

6.3.1数据交换平台应能对接口使用鉴权确认使用者身份，确 保接口服务的合法调用。 6.3.2数据交换平台应记录数据使用者信息，使用时间.使用痕 迹等信息。

6.4.1数据提供者和数据使用者应采取安全措施确保前置 系统安全。

6.4.2前置机服务系统应记录每次交换的数据资源时间，数量

7.1.1数据接口服务应包括权限管理.资源目录.数据内容等接 口服务。 7.1.2数据提供者和数据使用者应遵循本接口服务规范提供或 者使用数据

7.2.1权限管理接口应根据用户名和密码生成tokn验证数据 使用者和提供者权限。token生成算法中应增加 token有效时 间.接口使用频次.访问地址等信息。 7.2.2 权限管理接口定义应符合以下规定： 1 接口描述：通过用户名密码获敢用户认证令牌（token）： 2 接口定义：/interface/getToken; 3 调用方式:POST。 7.2.3 权限管理接口消息定义应符合以下规定：

3getToken调用代码可按照"附录A示例代码”

3findCatalogList调用代码可按照附录A示例代码” 7.3.5自录分类对应信息资源列表接口应通过自录分类id获取 当前目录分类下所有信息资源列表

3findCatalogList调用代码可按照附录A示例代码”

7.3.8信息资源下数据项列表接口应根据信息资源id查询 资源详情及数据项列表，

资源详情及数据项列表。 7.3.9信息资源下数据项列表接口定义应符合以下规定： 1 接口描述：根据信息资源d查询信息资源详情及数据项 列表； 2 接定义：/interface/getDataitemInfo; 3 调用方式：POST.GET： 支持协议：SOAP.REST： 5 数据格式：JSON.XML

7.3.10信息资源下数据项列表接口消息定义应符合以

7.4.1 数据内容查询接口应实现通过调用接口方式查询数据 内容。 7.4.2 数据内容查询接口定义应符合以下规定

4getData返回参数根据请求的数据资源类不同有所不同， 其数据结构与资源目录中数据类结构一致： 5getData调用代码可按照"附录 A 示例代码”

获取用户认证令牌接口请求参

'userName","jsxxzx", 'password","cxjwjsxxzx123456"

A.0.2获取用户认证令牌接口返回参数示例。

A..4查询目录分类列表接口返回参数示例。

: "c0de"："20000", "message"："处理成功"， "data","[ 1 "isParent"; false, "children": null.

用户认证令牌接口请求参数示夜

"code"，"20000" "message"："处理成功"， "data","[ 1 "isParent": false. "children". null.

"catalogId"："1185", "code":"1l", "description";"", "itemOrder"; O, name"："市内勘察设计企业" "superld", "" 1 ; 1 "isParent": true. "children"[ < "isParent"; false, "children": null, "catalogld";"1222" "code";"cstjmly, "description"8888" "itemOrder"? ol, "name"；"安管人员" > J, "catalogd:1162", "code"，"li" "description";"" "itemOrder":O, "name"："本地工程招标代理机构" "superld"; "" 1,J"

A.0.5查询目录分类对应信息资源列表接口请求参数示例。

A.0.5查询目录分类对应信息资源列表接口请求参数示例

QX/T 617-2021 气象数字对象标识符 总则token":"mFUXd7slhQx47QyhfQ", catalogld""11244326"

A.0.6查询目录分类对应信息资源列表接口返回参数

查询目录分类对应信息资源列表接口返回参数示例。

事 "c0de";"20000", "message"："处理成功"， "data":[ "catalogld"："11244326" "categoryName": null, "code";"ztimlxdxzycs "dataitemCode":"RES WZT" "dataitemld","32887271" "dataitemSource" "dataKind"; 3, "dataKindDes": null, "dataSourcel: null. "dataSourceCode": : null, "dataType":307, "description"%"市内勘察设计企业清单"， "hitFrequeney": 8, "innerCode": null, "innerOrg"; null, "name"："市内勘察设计企业"， "stanCompDate" : null , "shareWay"; 1,

1为便于在执行本标准条文时区别对待，对要求严格程度 不同的用词说明如下： 1）表示很严格，非这样做不可的用词： 正面用词采用“必须”，反面用词采用“严禁” 2）表示严格，在正常情况下均应这样做的用词 正面用词采用“应”，反面用词采用“不应”或“不得”； 3）表示允许稍有选择，在条件许可时首先应这样做的 用词： 正面用词采用“宜”，反面用词采用“不宜” 4）表示有选择，在一定条件下可以这样做的用词，采用 “可”。 2条文中指明应按其它有关标准执行的写法为“应按·· 执行”或“应符合的规定”。

总则 33 2 术语 34 3 数据交换体系 35 3.1 体系构成 35 3.2 数据交换平台 35 3.3数据交换模式 35 数据标准及资源目录 37 4.1 数据标准及编码规范 37 4.2数据资源目录 37 数据交换方式及技术要求 39 5.1　一般规定 39 5.2数据交换技术要求 39 5.3数据传输技术要求 40 数据交换安全规范 41 6 6.2 共享数据权限管理 41 6.3 数据接口使用权限认证 41 6.4 前置机安全管理 41 数据接口服务规范 42 7. 1 一般规定 42 7.2 权限管理接口 42 7.3 资源目录接口 42 7. 4 数据内容接口 43

1..1本标准旨在针对城乡建设领域数据来源多.规模庞大.覆 盖面广，空间分辨率和时间分辨率细致等行业特点，通过规范城 乡建设领域进行数据共享和交换时需遵循的数据编码规范.交换 方式，交换安全和接口服务规范等，切实解决重庆市城乡建设领 域客单位数据格式不统一.数据交换接口不规范导致信息难以共 享的矛盾，避免数据孤岛的形成DB21T 2086-2013 生鲜乳收购站建设规范，以指导和促进重庆市城乡建设 领域信息系统的建设

1..3本标准撰写要求遵循系统性,实用性,可扩展性和科学性

本标准定义的术语，是为了闻明标准中涉及的一些重要概 念，为详细叙述重庆市城乡建设领域数据交换接口标准的内涵和 外延，在术语中对“数据资源”、“数据交换”“数据交换体系”和 “资源目录等概念作了重点描述，目的在于明确对重庆市城乡领 域的数据进行交换共享的依据。