DB32 T 3498-2019 道路运输管理信息接口技术要求.pdf

《DB32 T 3498-2019 道路运输管理信息接口技术要求.pdf》由会员分享，可在线阅读，更多相关《DB32 T 3498-2019 道路运输管理信息接口技术要求.pdf（97页珍藏版）》请在麦多课文档分享上搜索。

1、ICS 03.220.20R 10备 案 号 ： DB32江 苏 省 地 方 标 准DB32/T 34982019道 路 运 输 管 理 信 息 接 口 技 术 要 求 Road transportation management information sharing interface standard 2019-01-12发 布 2019-01-30实 施江 苏 省 市 场 监 督 管 理 局 发 布 DB32/T 34982019 I 目 次目 次 .I前 言 .II道 路 运 输 管 理 信 息 接 口 技 术 要 求 .11 范 围 .12 规 范 性 引 用 文 件 .13 缩

2、略 语 .14 安 全 策 略 .15 接 口 内 容 规 范 .25.1 接 入 业 务 分 类 .2 5.2 接 口 交 换 要 求 .25.3 接 口 报 文 格 式 .26 数 据 接 口 总 体 要 求 .46.1 获 取 数 据 的 接 口 .46.2 上 传 数 据 接 口 定 义 .87 具 体 业 务 数 据 接 口 要 求 .97.1 从 业 人 员 业 务 数 据 接 口 要 求 .97.2 业 户 .177.3 车 辆 .247.4 其 他 .437.5 5 接 入 平 台 数 据 项 说 明 .47附 录 A.82A.1 性 别 编 码 .82 A.2民 族 编 码

3、.82A.3身 份 证 件 类 别 编 码 .84A.4从 业 资 格 编 码 .84A.5申 请 种 类 编 码 .85A.6学 历 编 码 .85A.7健 康 状 况 编 码 .86A.8车 牌 颜 色 编 码 .86A.9车 辆 技 术 等 级 编 码 .86A.10客 车 等 级 编 码 .87A.11经 营 范 围 编 码 .87A.12许 可 事 项 编 码 .91A.13经 济 类 型 编 码 .91A.14车 型 编 码 .92 DB32/T 34982019 II 前 言本 标 准 按 照 GB/T 1.1-2009 给 出 的 规 则 编 写 。本 标 准 由 江 苏 省

4、交 通 运 输 厅 运 输 管 理 局 提 出 。本 标 准 由 江 苏 省 交 通 运 输 厅 运 输 管 理 局 归 口 。本 标 准 起 草 单 位 ： 江 苏 省 交 通 运 输 厅 运 输 管 理 局 、 江 苏 长 天 智 远 交 通 科 技 有 限 公 司 、 无 锡市 运 输 管 理 处 、 苏 州 市 运 输 管 理 处 。本 标 准 主 要 起 草 人 ： 陆 元 良 、 陶 绪 林 、 李 云 飞 、 王 登 才 、 高 潮 、 张 进 、 方 力 、 叶 嘉 宁 、 张新 民 、 吴 勇 、 李 瑞 航 、 张 鹏 飞 、 刘 霄 云 、 陆 熠 等 。 DB32/T

5、34982019 III DB32/T 34982019 1 道 路 运 输 管 理 信 息 接 口 技 术 要 求1 范 围本 标 准 规 定 了 江 苏 省 道 路 运 输 管 理 信 息 共 享 接 口 服 务 的 基 本 内 容 。本 标 准 适 用 于 江 苏 省 内 的 道 路 运 输 管 理 过 程 中 的 信 息 共 享 。2 规 范 性 引 用 文 件下 列 文 件 对 于 本 标 准 的 应 用 是 必 不 可 少 的 。 凡 是 注 日 期 的 引 用 文 件 ， 仅 所 注 日 期 的 版 本 适用 于 本 标 准 。 凡 是 不 注 日 期 的 引 用 文 件 ， 其

6、 最 新 版 本 （ 包 括 所 有 的 修 改 单 ） 适 用 于 本 标 准 。GB/T 2659 2000 世 界 各 国 和 地 区 名 称 代 码JT/T 414 2006 道 路 运 输 电 子 政 务 平 台 信 息 分 类 与 指 标JT/T 415 2006 道 路 运 输 电 子 政 务 平 台 编 目 编 码 规 则 JT/T 697.1 2013 交 通 信 息 基 础 数 据 元 第 1部 分 ： 总 则JT/T 697.7 2014 交 通 信 息 基 础 数 据 元 第 7部 分 ： 道 路 运 输 信 息 基 础 数 据 元JT/T 809 交 通 部 卫 星

7、定 位 数 据 传 输 标 准3 缩 略 语下 列 缩 略 语 适 用 于 本 文 件 。Base64： 一 种 用 于 传 输 8Bit 字 节 代 码 的 编 码 方 式CDATA： 不 由 XML解 析 器 进 行 解 析 的 文 本 数 据 （ Character Data）CSV： 逗 号 分 隔 值 （ Comma-Separated Values）FTP： 文 件 传 输 协 议 （ File Transfer Protocol）FTPS： 增 强 型 FTP协 议 （ FTP-SSL或 者 FTP-over-SSL）GBK： 汉 字 内 码 扩 展 规 范 （ Chinese

8、Internal Code Specification）HTTP： 超 文 本 传 输 协 议 （ Hypertext Transfer Protocol） ID： 标 识 号 ， 是 某 个 体 系 中 相 对 唯 一 的 标 识 （ Identification）MD5： 信 息 -摘 要 算 法 第 五 版 （ Message-Digest Algorithm 5）RSA： 公 钥 加 密 算 法 （ RSA Algorithm）SOAP： 简 单 对 象 访 问 协 议 （ Simple Object Access Protocol）SSL： 安 全 套 接 层 (Secure Soc

9、kets Layer)UTF-8： 是 一 种 针 对 Unicode 的 可 变 长 度 字 符 编 码 ， 又 称 万 国 码 （ 8-bit Unicode TransformationFormat）XML： 可 扩 展 标 记 语 言 （ Extensible Markup Language）4 安 全 策 略运 输 信 息 平 台 边 界 接 入 平 台 Transport information platform boundary access platform运 输 信 息 边 界 接 入 平 台 （ 以 下 简 称 “ 接 入 平 台 ” ） 是 边 界 接 入 业 务 与 运

10、 输 信 息 平 台 进 行 数 据 交 换 和 授 权 访 问 的 基 础 。 接 入 平 台 提 供 各 类 接 入 业 务 与 运 输 信 息 通 信 网 进 行 数 据 交 换 和 授 权访 问 的 网 络 通 道 ， 对 各 类 接 入 业 务 进 行 注 册 、 监 控 与 审 计 。系 统 安 全 策 略 System Security Policy DB32/T 34982019 2 需 要 建 立 系 统 安 全 防 范 策 略 ， 包 括 访 问 控 制 与 安 全 边 界 、 弱 点 漏 洞 分 析 和 风 险 审 计 、 入 侵检 测 与 防 御 、 信 息 监 控 、

11、 病 毒 防 护 以 及 系 统 安 全 的 安 全 管 理 ， 从 链 路 、 网 络 主 机 、 应 用 等 方 面采 取 必 要 的 安 全 技 术 措 施 ， 在 实 现 接 入 业 务 交 换 的 同 时 ， 保 障 接 入 平 台 及 运 输 信 息 通 信 网 的 安全 。 接 口 服 务 器 Interface Server业 务 接 入 服 务 器 必 须 具 备 病 毒 防 护 、 入 侵 检 测 与 防 御 的 安 全 管 理 策 略 ， 确 保 接 入 服 务 器 不影 响 运 输 信 息 平 台 。5 接 口 内 容 规 范5.1 接 入 业 务 分 类运 输 管 理

12、 机 构 所 有 向 外 提 供 信 息 服 务 和 接 收 外 部 信 息 的 业 务 ， 以 下 简 称 “ 接 入 业 务 ” 。 接入 业 务 按 接 入 对 象 划 分 ， 主 要 分 为 三 大 类 ： 交 通 行 业 内 部 接 入 业 务 、 政 府 职 能 部 门 接 入 业 务 和 社 会 第 三 方 应 用 。政 府 职 能 部 门 接 入 业 务 ， 其 接 入 对 象 为 具 备 行 政 职 能 的 机 关 及 事 业 单 位 用 户 。 例 如 ： 政 府部 门 用 户 、 公 安 、 环 保 、 安 监 、 工 商 、 民 政 、 信 用 等 相 关 单 位 与

13、运 管 部 门 实 现 信 息 共 享 交 换 的业 务 。交 通 行 业 内 部 接 入 业 务 ， 其 接 入 对 象 为 ， 包 括 交 通 运 输 厅 、 交 通 运 输 部 、 地 方 交 通 局 等 部门 。 例 如 向 交 通 运 输 部 接 收 和 上 报 车 辆 和 业 户 的 接 入 及 基 础 信 息 获 取 服 务 等 。社 会 第 三 方 应 用 接 入 业 务 ， 其 接 入 对 象 为 机 动 车 检 测 站 、 驾 驶 员 培 训 学 校 、 教 育 学 习 网 、 卫星 定 位 系 统 服 务 商 等 社 会 单 位 。 例 如 向 运 管 部 门 上 报 车

14、 辆 定 位 信 息 、 从 业 人 员 继 续 教 育 学 时 等 。5.2 接 口 交 换 要 求全 省 运 政 系 统 与 其 它 相 关 系 统 互 为 SOAP 客 户 端 和 SOAP服 务 端 。 当 某 一 系 统 为 SOAP客 户 端时 ， 即 为 服 务 的 发 起 方 ， 发 送 报 文 后 30s 内 未 收 到 应 答 报 文 ， 应 中 断 后 重 新 进 行 一 次 请 求 。 作 为 SOAP服 务 端 一 方 ， 即 为 服 务 的 接 收 方 ， 收 到 报 文 后 应 及 时 按 数 据 格 式 要 求 提 供 信 息 反 馈 。每 个 数 据 接 口

15、中 ， 针 对 接 入 和 调 取 数 据 的 对 象 不 同 ， 如 ： 交 通 行 业 内 部 接 入 业 务 、 政 府 职能 单 位 接 入 业 务 和 社 会 第 三 方 应 用 ， 提 供 不 同 的 输 入 、 输 出 数 据 信 息 范 围 。5.3 接 口 报 文 格 式5.3.1 报 文 定 义报 文 (message)是 网 络 中 交 换 与 传 输 的 数 据 单 元 ， 即 站 点 一 次 性 要 发 送 的 数 据 块 。 报 文 包 含了 将 要 发 送 的 完 整 的 数 据 信 息 ， 其 长 短 很 不 一 致 ， 长 度 不 限 且 可 变 。 接 口

16、报 文 结 构 包 括 包 头（ header） 和 包 体 （ body） 节 点 ， 以 XML格 式 描 述 ， 编 码 方 式 为 UTF-8。具 体 业 务 编 码 含 义 参 见 附 录 ， 常 用 的 地 区 编 码 等 内 容 参 见 国 家 相 关 标 准 。5.3.2 约 束约 束 是 用 来 确 保 数 据 的 准 确 性 和 一 致 性 。 接 口 报 文 结 构 字 段 约 束 条 件 解 释 见 表 1。表 1 约 束 条 件 约 束 约 束 条 件? 0.1 可 以 没 有 ， 也 可 以 有* 0.n， 可 以 没 有 ， 也 可 以 有 多 项+ 1.n， 至

17、 少 有 1 项 ， 也 可 以 有 多 项1 必 须 且 只 能 填 1 项5.3.3 报 文 结 构 DB32/T 34982019 3 表 2 接 口 报 文 结 构序号 层 级 父 元 素 名称 元 素 名 称 约束 报 文 格 式 长度 描 述 取 值 说 明1 0 - transaction 1 - - 交 易 报 文 的主 节 点 -2 1 transacton header 1 - - 报 文 头 -3 1.1 header serialnum 1 String F32 流 水 号 6 位 代 码 （ 见 JT/T697.7 2014 中4.1.1.1.3） + 时 间格 式

18、YYYYMMDDhhmmss+ 12 位 序 列 号 ；4 1.2 header sourceservice 1 String F6 发 起 方 系 统 编 码 6 位 代 码 （ 见 JT/T697.7 2014 中4.1.1.1.3）5 1.3 header targetservice 1 String F6 接 收 方 系 统 编 码 6 位 代 码 （ 见 JT/T697.7 2014 中4.1.1.1.3）6 1.4 header systemid 1 String F6 服 务 的 系 统 编 码 默 认 值 0000007 1.5 header serviceid 1 Strin

19、g F6 业 务 接 口 代 码 - 8 1.6 header date 1 String F8 请 求 日 期 YYYYMMDD9 1.7 header time 1 String F6 请 求 时 间 hhmmss10 1.8 header isreq 1 String F1 标 志 位 0-请 求1-响 应11 1.9 header signature 1 - - 数 字 签 名 信 息 -12 1.9.1 signature md5 1 String F32 Md5 校 验 码 对 body 节 点 做Base64 编 码 对 编码 结 果 做 MD5 转 换 ，生 成 32 位 数

20、据 摘要 13 1.9.2 signature detail 1 String V256 数 字 签 名 使 用 RSA 算 法 对MD5 数 据 摘 要 进 行签 名14 1.10 header response 1 - 响 应 结 果 信 息 -15 1.10.1 response retcode 1 String F4 应 答 /错 误 代 码 见 A.1 应 答 代 码 与消 息16 1.10.2 response retmsg 1 String V256 应 答 /错 误 信 息 见 A.1 应 答 代 码 与消 息17 1.11 transaction body ? CDATA -

21、 具 体 交 易 的 XML 见 业 务 功 能 中 报 文结 构5.3.4 分 页 DB32/T 34982019 4 表 1（ 续 ）系 统 默 认 应 答 报 文 中 最 大 返 回 记 录 数 为 100， 对 于 查 询 结 果 大 于 100的 请 求 ， 客 户 端 应 请 求多 次 获 取 完 整 的 查 询 结 果 。 分 页 内 容 放 入 报 文 结 构 body 中 。分 页 请 求 报 文 字 段 解 释 见 表 3。 表 3 分 页 请 求 报 文序号 层 级 父 元 素 名 称 元 素 名 称 约 束 类 型 长 度 描 述 取 值 说 明1 1 - reqInf

22、o 1 - - 请 求 体 -2 2 reqInfo pageInfo 1 - - 分 页 信 息 -3 3 pageInfo page 1 String V6 页 码 -分 页 应 答 报 文 字 段 解 释 见 表 4。 表 4 分 页 应 答 报 文序 号 层 级 父 元 素 名 称 元 素 名 称 约 束 类 型 长 度 描 述 取 值 说 明1 0 - respInfo 1 - - 返 回 信 息 -2 1 respInfo pageInfo 1 - - 分 页 信 息 -3 2 pageInfo limit 1 String V6 每 页 记 录 数 默 认 1004 3 page

23、Info page 1 String V6 当 前 页 码 -5 4 pageInfo totalcount 1 String V10 总 记 录 条 数 -6 5 pageInfo totalpages 1 String V6 总 页 数 - 6 数 据 接 口 总 体 要 求6.1 获 取 数 据 的 接 口1、 描 述用 来 获 取 江 苏 省 运 输 管 理 业 务 系 统 中 的 数 据 。2、 接 口 要 求public string GetData (string funName, string userId, string password, stringparam)3、 参

24、数 说 明funName： 业 务 功 能 名 称 ， 由 运 政 业 务 系 统 确 定 ， 例 .1： GetUserInfo；userId： 运 政 系 统 为 接 入 系 统 分 配 的 用 户 标 识 ， 系 统 验 证 用 ；password： 运 政 系 统 为 接 入 系 统 分 配 的 用 户 密 码 ， 系 统 验 证 用 ；param： 调 用 参 数 ， XML格 式 ， 描 述 如 下 ： DB32/T 34982019 5 gong 表 5 标 签 说 明标 签 及 属 性 是 否 必 须 说 明jstmbsinterface 是 Xml 的 根 级 元 素 ， 表

25、 示 江 苏 运 输 管 理 业 务 系 统 接 口batch 否 分 批 操 作 标 签 ， 用 来 标 识 要 获 取 哪 一 批 次 的 数 据 num 是 批 次 号 ， 如 果 有 batch 标 签 ， 此 属 性 则 是 必 须 的 ， 表 示 要 获 取 哪 一 批 数 据 ，num0count 否 此 属 性 可 为 空 ， 则 系 统 默 认 为 200 条 数 据 ， 大 于 200， 系 统 也 默 认 为 200 条 ，最 小 值 为 1condition 否 对 数 据 的 筛 选 条 件 ， 具 体 的 要 求 见 相 应 业 务 数 据 的 说 明返 回 参 数

26、 ： XML格 式 DB32/T 34982019 6 1 4 3 2 4 5 4 3 2 5 DB32/T 34982019 7 表 6 标 签 说 明标 签 及 属 性 是 否 必 须 说 明jstmbsinterface 是 Xml 的 根 级 元 素 ， 表 示 江 苏 运 输 管 理 业 务 系 统 接 口result 是 返 回 的 调 用 结 果code 是 属 性 ， 返 回 代 码 ：0 ： 成 功1 ： 用 户 标 识 或 密 码 错 误2 ： 用 户 已 停 用 3 ： 调 用 的 IP 地 址 不 相 符4 ： 不 可 识 别 的 业 务 功 能 （ funName 业

27、 务 功 能 不 可 识 别 ）5 ： 业 务 功 能 已 不 使 用6 ： 分 批 查 询 参 数 错 误 （ 如 果 是 分 批 查 询 ， 缺 少 批 次 号 ， 或 类 型 范 围 不 正确 ）7 ： 查 询 条 件 错 误 （ 缺 少 XX 查 询 条 件 ）8 ： 上 传 的 数 据 为 空9 ： 上 传 的 数 据 已 存 在 1 0 ： 获 取 的 数 据 不 存 在1 1 ： 上 传 的 数 据 有 误9 8 ： 系 统 WebService 服 务 关 闭9 9 ： 其 他 错 误description 否 内 容 为 返 回 代 码 的 补 充 描 述 ， 成 功 时 为

28、 空 字 符data 否 返 回 取 到 的 数 据 encryptflag 是 如 果 有 data 标 签 ， 则 此 属 性 必 填 ， 数 据 部 分 是 否 加 密 标 识 ， 0 :不 加 密 ，1 :加 密encryptkey 否 加 密 的 密 钥 ， 如 果 加 密 标 识 为 1 ， 密 钥 不 为 空数 据 标 签 否 根 据 具 体 的 业 务 数 据 定 义 ， 如 ： 从 业 人 员 定 义 为 Practitioner（ 注 ： 区分 大 小 写 ）count 否 此 属 性 则 是 非 必 须 的 ， 共 有 多 少 数 据batchnum 否 如 果 是 分

29、配 查 询 ， 此 属 性 则 是 必 须 的 ， 表 示 要 返 回 的 批 次 号 DB32/T 34982019 8 totalbatch 否 如 果 是 分 配 查 询 ， 此 属 性 则 是 必 须 的 ， 共 有 多 少 批action 否 数 据 操 作 属 性 ， 非 必 须 属 性1 ： 新 增 ， 2 ： 修 改 ， 3 ： 删 除 （ 删 除 时 业 务 数 据 中 只 有 主 键 标 识 ）6.2 上 传 数 据 接 口 定 义1、 描 述 ：用 来 上 传 数 据 到 江 苏 省 运 输 管 理 业 务 系 统 中 。2、 接 口 要 求public string S

30、etData (string funName, string userId, string password, stringdata)3、 参 数 说 明 ：funName： 业 务 功 能 名 称 ， 运 政 业 务 系 统 确 定 ， 例 ： SetPracApplyInfo； userId： 运 政 系统 为 接 入 系 统 分 配 的 用 户 标 识 ， 系 统 验 证 用 ； password： 运 政 系 统 为 接 入 系 统 分 配 的 用 户 密 码 ， 系 统 验 证 用 ；data： 上 报 的 业 务 数 据 ， XML格 式 ， 描 述 如 下 ： . 表 7 标 签

31、 说 明 标 签 及 属 性 是 否必 须 说 明jstmbsinterface 是 Xml 的 根 级 元 素 ， 表 示 江 苏 运 输 管 理 业 务 系 统 接 口Result 是 返 回 的 调 用 结 果 ， 内 容 为 返 回 代 码 的 补 充 描 述 ， 成 功 时 为 空 字 符 ， 参见 获 取 数 据 返 回 结 果 说 明 DB32/T 34982019 9 data 是 上 传 的 数 据 标 签encryptflag 是 如 果 有 data 标 签 ， 则 此 属 性 必 填 ， 数 据 部 分 是 否 加 密 标 识 ， 0:不 加 密 ，1:加 密encry

32、ptkey 否 加 密 的 密 钥 ， 如 果 加 密 标 识 为 1， 密 钥 不 为 空数 据 标 签 否 根 据 具 体 的 业 务 数 据 定 义 ， 如 ： 从 业 人 员 定 义 为 Practitioner（ 注 ： 区分 大 小 写 ）count 否 此 属 性 则 是 非 必 须 的 ， 共 有 多 少 数 据action 否 数 据 操 作 属 性 ， 非 必 须 属 性1： 新 增 ， 2： 修 改 ， 3： 删 除 （ 删 除 时 业 务 数 据 中 只 有 主 键 标 识 ） 返 回 参 数 ： XML 格 式7 具 体 业 务 数 据 接 口 要 求 7.1 从 业

33、 人 员 业 务 数 据 接 口 要 求7.1.1 上 传 从 业 资 格 申 请 数 据上 传 一 条 从 业 资 格 申 请 数 据 。7.1.1.1 业 务 功 能调 用 方 法 为 ： UploadPracApply7.1.1.2 数 据 标 签申 请 信 息申 请 材 料材 料 附 件7.1.1.3 数 据 格 式数 据 格 式 见 附 录 ， 示 例 为 ： 293849234732949123 身 份 证 复 印 件 DB32/T 34982019 1 0 file1 file1 申 请 表 复 印 件 7.1.2 获 取 从 业 资 格 申 请 审 核 情 况 信 息 7.1.2.1 业 务 功 能 （ 获 取 数 据 ）调 用 方 法 为 ： GetPracApplyInfo7.1.2.2 查 询 条 件 表 1 查 询 条 件条 件 名 称 描 述 是 否 必 须 数 据 类 型 备 注applyId 申 请 Id主 键 是 VARCHAR7.1.2.3 返 回 数 据 标 签申 请