标准规范下载简介

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

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示例代码”

T／CCIAT 0004-2019 钢筋套筒灌浆连接施工技术规程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查询目录分类对应信息资源列表接口请求参数示例

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

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

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

3.1.1数据交换是一个系统性工程，在数据交换的活动中，涉及 到数据提供，数据使用，数据管理者三种角色，信息库作为数据的 载体，数据交换平台是数据交换的工具，数据交换模式是交换的 过程。数据提供方为数据提供者角色，数据需求方为数据使用 者，两种交换角色可以接照约定的交换模式通过数据交换平台完 成数据交换，在实际数据交换应用的不同场景中可能数据提供者 和数据使用者角色会交替转换。/人

微数据文换，任实际数据 和数据使用者角色会交替转换。人 3.1.5信息库作为数据的载体组织形式，包括数据提供者和数 据使用者为实现信息交换而建立的共享信息库和前置交换信息 库，数据宜包括提供和接收的信息。

据使用者为实现信息交换而建立的共享信息库和前置交换信息 库，数据宜包括提供和接收的信息。

3.3.1由于客单位信息发展水平的差异和信息交换支持的应用

3.3.1由于各单位信息发展水平的差异和信息交换支

3.3.1由于各单位信息发展水平的差异和信息交换支持的应用 需求的差异，在同一个交换区域内，可能不会是单一的交换模式 而是多种模式的组合。在建设规划时，要根据应用需求特点进行

合理布局，充分发挥两种交换模式的特点解决特定问题。 3.3.2集中式交换模式，信息资源集中存储于共享数据库，数据 提供者或使用者通过共享信息库实现信息资源交换，主要适用于 信息共享程度高信息一致性要求高的基础共享信息交换。 3.3.3分布式交换模式，信息资源分布存储在各应用业务信息 库中，信息资源提供者和使用者通过交换节点提供的交换服务实 现两者之间信息资源定向传送的交换模式，多用于异构系统互 联，系统构建灵活，可扩展性好，可以将数据提供者和使用者通过 不同的通信方式连接，充分保障已有系统的投资，还可以隔离上 下层交换服务与上层应用，可以很好的解决信息实时交换，信息 适配和信息安全等问题，提高数据交换的有效性和可用性。

4.2.1数据资源目录是数据提供者共享数据的依据，也是数据 使用者查找，定位和获取数据资源的入口，主要解决有什么资源， 资源的内容是什么、由谁提供，什么时间提供数据从哪单来，谁 可以使用，怎么使用等问题，使得数据资源有序开放，从而更好地 产生价值。人 4.2.2为确保数据资源目录的一致性和可用性，数据资源自录 按照《重庆市政务信息资源共享开放管理办法》和国家政务信息 资源自录编制指南的要求，包括数据资源分类，数据资源名称，数 据资源代码，数据资源提供方数据资源提供方代码.数据资源摘 要，数据资源格式，数据资源项信息，共享条件，开放属性，更新周 期、发布日期，关联资源代码等。对于数据共享，无条件共享应为

：：人数据资源日求是数据提探者益享数据的据，也是数据 使用者查找.定位和获取数据资源的入口，主要解决有什么资源 资源的内容是什么由谁提供什么时间提供，数据从哪单来，谁 可以使用.怎么使用等问题，使得数据资源有序开放，从而更好地 产生价值。

按照《重庆市政务信息资源共享开放管理办法》和国家政务信息 资源目录编制指南的要求，包括数据资源分类.数据资源名称数 据资源代码，数据资源提供方，数据资源提供方代码，数据资源摘 要，数据资源格式，数据资源项信息，共享条件，开放属性，更新周 期、发布期.关联资源代码等。对于数据共享，无条件共享应为 可提供给所有使用者使用的数据资源属于无条件共享类，有条件

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

5.1.1数据提供者和数据使用者，可以结合各目的系统对安全 性，可靠性等因素的要求，选择使用数据推送交换方式或数据抓 取交换方式。采用数据抓取交换方式，交换平台会直接从使用者 业务系统中抓取数据，因业务系统直接与交换平台对接，且数据 使用者在抓时间和数据交换的数量等方面存在不确定因素，在 安全性和性能上对业务系统可能存在一定的影响：数据推送交换 方式将业务系统与交换平台进行了分离，提供数据者对提供数据 的推送时间和数量相对更加主动，因此对安全性和业务系统的性 能影响较小。

性、可靠性等因素的要求，选择使用数据推送交换方式或数据抓 取交换方式。采用数据抓取交换方式，交换平台会直接从使用者 业务系统中抓取数据，因业务系统直接与交换平台对接，且数据 使用者在抓敢时间和数据交换的数量等方面存在不确定因素，在 安全性和性能上对业务系统可能存在一定的影响；数据推送交换 方式将业务系统与交换平台进行了分离，提供数据者对提供数据 的推送时间和数量相对更加主动，因此对安全性和业务系统的性 能影响较小。 5.2数据交换技术要求 5.2.1数据提供者根据客自提供的数据的情况，可以选择数据 库交换，接口交换和文件交换方式进行数据交换。 5.2.2对于数据库交换技术，提供者应提供主流的数据库支持 随着国产数据库的产品越来越成熟，已经逐渐被更多的用户选择 使用：同一数据类型在不同数据库中可能存在不同的表述方式， 数据提供者提供的数据类型应支持在主流数据库之间进行数据 类型的转换，以确保提供的数据能够得到正确使用。 5.2.3对于数据接口交换技术，由于不同用户的开发环境选择 不一样，因此提供的接口应该支持webService，Http，Rest等通 用类型服务接口，考愿到城乡建设领域的数据特点，还宜支持 OGC.ArCGIS等主流地理信息数据接口，以满足应用的需要。 39

5.2.1数据提供者根据各自提供的数据的情况，可以选择数据 库交换，接口交换和文交换方式进行数据交换。 5.2.2对于数据库交换技术，提供者应提供主流的数据库支持 随着国产数据库的产品越来越成熟，已经逐渐被更多的用户选择 使用；同一数据类型在不同数据库中可能存在不同的表述方式， 数据提供者提供的数据类型应支持在主流数据库之间进行数据 类型的转换，以确保提供的数据能够得到正确使用。 5.2.3对于数据接口交换技术，由于不同用户的开发环境选择 学国

不一样，因此提供的接口应该支持webService，Http，Rest等通 用类型服务接口，考愿到城乡建设领域的数据特点，还宜支持 OGC.ArCGIS等主流地理信息数据接口，以满足应用的需要

5.2.4数据文件交换技术，除常规的文件格式之外，还应提供城

52.4数据文件交换技术，除常规的文件格式之外，还应提供城

5.2.4数据文件交换技术，除常规的文件格式之外，还应提供城 乡建设领域被广泛应用的文件格式支持，特别是在图纸，BIM模 型、地理信息等格式。

5.3数据传输技术要求

5.3.6城乡建设领域被广泛应用的图纸JTG/T 3610-2019 公路路基施工技术规范，M模型，地理信息等

5.3.6城乡建设领域被广泛应用的图纸.BM模型.地理信 数据，具有文件数量多.单个文件大的特点，数据传输要确保 文件的传输支持。

6.2共享数据权限管理

数据共享属性分为无条件共享，有条件共享和不予共享，其 中不予共享的数据不纳人交换管理，对于有条件共享的数据，应 该对数据进行权限管理，避免数据通过交换导致安全失控。 6.3数据接口使用权限认证 数据使用者在申请接口接人，需进行接口鉴权，确保是合法 的使用接口，避免被非法冒用,导致数据非法交换流失。 6.4/前置机安全管理 前置机模式由于会在用户侧部署前置机前置节点，同时前置 机会有交换数据的暂存，因此对前置机的安全管理应该严格管 理，确保前置机不受到非法入侵，并严格记录每次推送的数据资 源、时间.数量等信息，并与数据使用者进行核对。

本标准规范说明了资源目录接口的定义和使用方法，包括目 录接口Schema的定义和使用方法，目录分类列表接口的定义和 更用方法JT／T 1166-2017 桥梁高强混凝土抗压强度无损检测，自录分类对应信息资源列表接口的定义和使用方法。 信息资源下数据项列表接口的定义和使用方法。

本标规范说明了数据内容接口的定义和使用方法，包括接 口描述.接口定义，调用方式，支持协议，数据格式，数据使用者可 使用getData的请求参数以及返回的参数调用接口进行数据内容 查询。