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