1、ICS 3 5.0 4 0CCS L 7 13301浙 江 省 杭 州 市 地 方 标 准D B 3 3 0 1/T 0 3 6 6.3 2 0 2 2一 码 通 应 用 规 范 第 3 部 分：服 务 要 求2 0 2 2-0 6-3 0 发 布 2 0 2 2-0 7-3 0 实 施杭 州 市 市 场 监 督 管 理 局 发 布D B 3 3 0 1/T 0 3 6 6.3 2 0 2 2I目 次前 言.I I引 言.I I I1 范 围.12 规 范 性 引 用 文 件.13 术 语 和 定 义.14 缩 略 语.15 服 务 场 景.16 服 务 框 架.17 一 码 通 用 户 服
2、务 要 求.28 业 务 应 用 方 服 务 要 求.39 接 口 服 务.3附 录 A（资 料 性）一 码 通 应 用 场 景.5附 录 B（规 范 性）接 口 调 用 方 式 和 参 数 要 求.6附 录 C（规 范 性）通 用 接 口 返 回 值 代 码 说 明.1 0D B 3 3 0 1/T 0 3 6 6.3 2 0 2 2I I前 言本 文 件 按 照 G B/T 1.1 2 0 2 0 标 准 化 工 作 导 则 第 1 部 分：标 准 化 文 件 的 结 构 和 起 草 规 则 的 规 定起 草。本 文 件 是 D B 3 3 0 1/T 0 3 6 6 一 码 通 应 用
3、规 范 的 第 1 部 分。D B 3 3 0 1/T 0 3 6 6 已 经 发 布 了 以 下 部 分：第 1 部 分：通 用 要 求；第 2 部 分：管 理 要 求；第 3 部 分：服 务 要 求。请 注 意 本 文 件 的 某 些 内 容 可 能 涉 及 专 利。本 文 件 的 发 布 机 构 不 承 担 识 别 专 利 的 责 任。本 文 件 由 杭 州 市 数 据 资 源 管 理 局 提 出、归 口 并 组 织 实 施。本 文 件 起 草 单 位：杭 州 市 余 杭 区 数 据 资 源 管 理 局、杭 州 余 杭 大 数 据 经 营 有 限 公 司。本 文 件 主 要 起 草 人：
4、王 维 忠、高 燕、周 围、鲍 全 贵、吴 鹏 程、董 世 聪、祝 玉 婷、何 义 胜、沈 琴 琴、林 兵、高 勇。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 2I I I引 言“码”作 为 个 人 信 息 的 载 体，是 应 用 场 景 中 信 息 互 认 的 有 效 方 式。在 不 同 场 景、不 同 人 群、不 同 平台 统 一 使 用 码 的 过 程 中，需 要 采 集、存 储 和 处 理 各 种 数 据 信 息，以 实 现 多 种 场 景 应 用。目 前 用 于 身 份 识 别 的 二 维 码 五 花 八 门，不 同 的 码 制 组 成 和 数 据 格 式 不 一 致
5、、数 据 不 共 享 和 互 认 机 制缺 乏 等 问 题，给 码 的 集 成 及 应 用 带 来 了 阻 碍：用 户 在 不 同 场 景 需 切 换 二 维 码，操 作 繁 琐 使 用 不 便；业 务应 用 方 在 建 设 或 接 入 时，不 同 的 码 标 准 在 硬 件 接 入 过 程 中 要 求 各 异，可 能 发 生 业 务 受 阻 或 重 复 建 设 的 问题；管 理 部 门 无 法 统 一 数 据 获 取 标 准，为 数 字 化 管 理 工 作 带 来 困 扰。基 于 以 上 现 状，“一 码 通”平 台 通 过 构 建 统 一 的 标 准，并 结 合 健 康 码 亮 码 应 用
6、，进 而 逐 步 搭 建 覆 盖全 人 群、全 场 景 的 码 体 系。自“一 码 通”平 台 开 设 试 点 以 来，“码”在 交 通 出 行、政 务 服 务、医 疗 健 康、文 化 旅 游 等 多 个 领 域 的 应 用 场 景 中 发 挥 了 巨 大 的 作 用。因 此，从 当 前 的 实 践 情 况 和 长 远 的 应 用 需 求 来 看，需 要 实 现 码 的 标 准 一 致。D B 3 3 0 1/T 0 3 6 6 旨 在 规 定 一 码 通 相 关 应 用 系 统 的 设 计、开 发 和 系 统 集 成 方 面 的 要 求。三 个 部 分 的 编制 目 的 如 下：第 1 部
7、分：通 用 要 求，给 出 一 码 通 应 用 规 范 的 管 理 和 服 务 基 本 原 则 和 一 码 通 的 基 本 要 求；第 2 部 分：管 理 要 求，给 出 一 码 通 应 用 规 范 的 数 据 管 理 要 求、运 维 管 理 要 求 和 安 全 管 理 要 求；第 3 部 分：服 务 要 求，给 出 一 码 通 应 用 规 范 的 服 务 场 景、服 务 框 架、一 码 通 用 户 服 务 要 求、业 务 应 用 方 服 务 要 求 和 接 口 服 务。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 21一 码 通 应 用 规 范 第 3 部 分：服 务 要 求1
8、 范 围本 文 件 规 定 了 一 码 通 应 用 规 范 的 服 务 场 景、服 务 框 架、一 码 通 用 户 服 务 要 求、业 务 应 用 方 服 务 要 求和 接 口 服 务。本 文 件 适 用 于 一 码 通 及 个 人 信 息 相 关 应 用 系 统 的 服 务 标 准 化 管 理。2 规 范 性 引 用 文 件下 列 文 件 中 的 内 容 通 过 文 中 的 规 范 性 引 用 而 构 成 本 文 件 必 不 可 少 的 条 款。其 中，注 日 期 的 引 用 文 件，仅 该 日 期 对 应 的 版 本 适 用 于 本 文 件；不 注 日 期 的 引 用 文 件，其 最 新
9、版 本（包 括 所 有 的 修 改 单）适 用 于 本文 件。D B 3 3 0 1/T 0 3 6 6.1 一 码 通 应 用 规 范 第 1 部 分：通 用 要 求D B 3 3 0 1/T 0 3 6 6.2 一 码 通 应 用 规 范 第 2 部 分：管 理 要 求3 术 语 和 定 义D B 3 3 0 1/T 0 3 6 6.1、D B 3 3 0 1/T 0 3 6 6.2 界 定 的 以 及 下 列 术 语 和 定 义 适 用 于 本 文 件。3.1应 急 码 e m e r g e n c y c o d e在 服 务 器 不 可 用、系 统 崩 溃 等 紧 急 情 况 下
10、可 离 线 使 用 的 二 维 码。4 缩 略 语下 列 缩 略 语 适 用 于 本 文 件。R E S T：表 述 性 状 态 转 移（R e p r e s e n t a t i o n a l S t a t e T r a n s f e r）W e b：全 球 广 域 网（W o r l d W i d e W e b）5 服 务 场 景一 码 通 用 户 可 通 过 移 动 通 信 终 端 申 领 简 码，用 户 可 凭 码 进 出 多 种 公 共 场 所，如 公 园、博 物 馆、医 院等，实 现 不 同 场 景 下 的 快 速 核 验 需 求，应 用 服 务 场 景 包 括 但
11、 不 限 于 以 下 方 面：一 码 出 行、一 码 通 办、一码 入 园、一 码 入 馆、一 码 就 医、一 码 连 心、一 码 入 学、才 金 直 通、三 色 五 益、助 残 助 学、幸 福 计 算 器 等。具 体 服 务 场 景 说 明 见 附 录 A。6 服 务 框 架D B 3 3 0 1/T 0 3 6 6.3 2 0 2 226.1 一 码 通 应 建 立 信 息 化 服 务 平 台，应 具 有 统 一 的 身 份 认 证、统 一 电 子 证 照、统 一 数 据 交 换 等 公 共 支撑 服 务 功 能。一 码 通 信 息 可 服 务 于 市 民、企 业、政 府 的 生 活 便
12、利、服 务 便 利 和 管 理 便 利。一 码 通 平 台 服务 框 架 见 图 1。图 1 一 码 通 平 台 服 务 框 架 图6.2 一 码 通 平 台 基 于 底 层 数 据 库，如 互 联 网 数 据、物 联 网 数 据、公 安 数 据、社 保 数 据、医 保 数 据、市民 卡 卡 管 数 据、健 康 码 数 据、业 务 场 景 采 集 的 数 据 等，实 现“一 码”身 份 统 一 和 统 一 数 据 管 理。平 台 功能 包 括 场 景 的 接 入 管 理、规 则 管 理、场 景 管 理、身 份 认 证、场 景 标 签、规 则 引 擎、硬 件 管 理 等。6.3 一 码 通 平
13、台 依 据 的 数 据 源 应 包 括 以 下 信 息：a)用 户 的 身 份 信 息：姓 名、手 机 号 码、证 件 类 型、证 件 号 码；b)用 户 的 户 籍 信 息：用 户 的 户 籍 信 息 及 所 在 地 区 的 居 住 信 息；c)用 户 的 防 疫 信 息：用 户 的 国 家 健 康 码 状 态 信 息、用 户 的 新 冠 疫 苗 接 种 状 态 信 息、用 户 在 近 期时 间 内 是 否 途 径 或 停 留 国 内 存 在 疫 情 风 险 地 区 的 相 关 信 息；d)用 户 的 类 别 信 息：用 户 对 应 人 才 引 进 政 策 的 人 才 级 别 信 息、用 户
14、 是 否 为 部 队 退 伍 军 人 的 信 息；e)其 他 相 关 信 息。7 一 码 通 用 户 服 务 要 求7.1 服 务 流 程7.1.1 实 名 认 证所 有 使 用 一 码 通 服 务 的 用 户，需 要 通 过 应 用 软 件 进 行 实 名 认 证，通 过 后 进 入 领 码 操 作。7.1.2 领 码领 码 时 会 要 求 用 户 进 行 个 人 信 息 授 权，用 户 同 意 后，通 过 接 入 渠 道 的 授 权 接 口 获 取 到 用 户 个 人 信 息。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 237.1.3 制 码通 过 实 名 认 证 与 领
15、码 操 作 的 用 户，可 请 求 生 成“一 码 通 信 息 码”的 二 维 码，并 在 需 要 的 时 候 出 示 此码，作 为 个 人 信 息 证 明。主 要 流 程 包 括：a)用 户 进 行 亮 码 操 作 时，应 用 软 件 通 过“二 维 码 调 用 申 请”接 口 发 起 业 务 请 求，再 调 用“个 人身 份 标 签”接 口，获 取 个 人 身 份 标 签 信 息；b)“个 人 身 份 标 签”接 口 根 据 用 户 授 权 内 容 返 回 相 应 的 二 维 码。7.2 服 务 提 供7.2.1 一 码 通 软 件 应 具 有 使 用 端 服 务 功 能，解 答 用 户
16、问 询 和 处 理 用 户 投 诉。7.2.2 当 遇 到 系 统 崩 溃、网 络 阻 塞 等 一 码 通 功 能 无 法 正 常 使 用 的 情 况，应 通 过 软 件 或 短 信 提 示 等 方 式及 时 告 知 用 户。根 据 实 际 业 务 需 求，在 突 发 状 况 下 可 提 供 应 急 码 供 用 户 使 用。8 业 务 应 用 方 服 务 要 求8.1 服 务 流 程8.1.1 业 务 应 用 方 可 线 上 进 行 使 用 申 请，对 使 用 场 景、所 需 信 息 进 行 备 案 登 记，获 取 二 维 码 使 用 类 型、用 户 信 息。8.1.2 平 台 应 遵 循 统
17、 一 性 和 易 用 性 要 求，集 成 通 用 服 务 功 能，实 现 个 人 信 息、硬 件 设 备 和 使 用 场 景 的规 范 统 一 管 理。8.2 应 用 要 求8.2.1 具 体 码 应 用 场 景 由 各 场 景 业 务 应 用 方 负 责，一 码 通 主 要 为 不 同 场 景 提 供 便 捷 化 服 务，提 供 综 合的 大 数 据 分 析 比 对，为 各 个 场 景 提 供 码 标 准 和 相 关 数 据 查 询 接 口 服 务。8.2.2 各 场 景 可 通 过 一 码 通 平 台 的 个 人 信 息，结 合 场 景 服 务，通 过 同 一 个 码 面 向 用 户 服
18、务。8.2.3 各 场 景 业 务 应 用 方 负 责 所 辖 场 景 码 服 务 的 投 诉 处 理。8.3 对 接 要 求8.3.1 已 建 设 码 的 相 关 业 务 应 用 方，应 按 照 本 文 件 与 一 码 通 平 台 对 接。各 场 景 应 用 软 件 应 能 识 别 由 一码 通 平 台 生 成 的 简 码，实 现 基 于 一 码 通 平 台 简 码 的 互 联 互 通。一 码 通 平 台 提 供 跨 地 区 的 个 人 信 息 查 询 服务。各 业 务 应 用 方 应 在 此 基 础 上，结 合 个 人 信 息 数 据，进 行 场 景 化 应 用。8.3.2 尚 未 建 设
19、 码 应 用 的 场 景，应 直 接 将 一 码 通 作 为 场 景 码 使 用，提 供 特 定 的 服 务。9 接 口 服 务9.1 基 本 要 求一 码 通 系 统 对 外 发 布 服 务 和 接 受 请 求 应 采 用 符 合 R E S T 架 构 原 则 的 W e b 服 务。9.2 服 务 类 型一 码 通 相 关 的 服 务 类 型 说 明 见 表 1。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 24表 1 服 务 类 型 说 明序号 服务类型 服务名称1 1 0 0 0 二维码产生接口2 2 0 0 0 0 二维码解码接口3 3 0 0 0 0 第三方应用授权
20、接口9.3 接 口 管 理9.3.1 概 述接 口 类 型 及 说 明 见 表 2。表 2 接 口 类 型 及 说 明序号 接口类型 接口说明名1 产生二维码接口 生成二维码2 用户标签信息查询接口 获取一码通用户的标签信息数据3 渠道二维码接口 一码通用户渠道请求二维码4 解码能力接口 一码通用户提供解码能力接口5 第三方授权接口 一码通用户第三方授权接口9.3.2 接 口 调 用 方 式 和 参 数各 类 型 接 口 调 用 方 式 和 参 数 应 符 合 附 录 B 的 规 定，接 口 返 回 值 代 码 说 明 应 符 合 附 录 C 的 规 定。D B 3 3 0 1/T 0 3 6
21、 6.3 2 0 2 25A A附 录 A（资 料 性）一 码 通 应 用 场 景应 用 场 景 服 务 说 明 如 下：a)一 码 出 行,以“码”为 载 体，实 现 公 交、地 铁、水 上 巴 士 等 各 类 公 共 交 通 场 景 的 刷 码 通 用。同时 为 人 才 等 提 供 个 性 化 服 务，例 如 刷 码 免 费 乘 坐 指 定 路 线 公 交；b)一 码 通 办,可 在 行 政 服 务 中 心 可 通 过 扫 码 进 行 预 约 取 号 和 现 场 取 号；c)一 码 入 园,可 通 过 扫 码 实 名 制 进 入 公 园 游 玩；d)一 码 入 馆,可 通 过 扫 码 实
22、名 制 进 入 博 物 院 游 玩，同 步 支 持 自 助 图 书 馆 扫 码 借 还 图 书；e)一 码 就 医,可 通 过 扫 码 在 医 院 和 社 区 卫 生 服 务 中 心 进 行 体 检 预 约 签 到、扫 码 进 行 自 助 基 础 健 康监 测、购 买 应 急 药 品；f)一 码 连 心，搭 建 市 民 线 上 信 访 快 速 通 道，当 市 民 遇 到 问 题 或 需 要 帮 助 时，可 随 时 随 地 进 行 咨询 或 反 映，是 市 民 联 系 政 府 的 首 选 通 道；g)一 码 入 学，紧 贴 市 民 入 学 需 求，市 民 可 精 准 及 时 了 解 教 育 资
23、源 供 给，招 生 入 学 等 政 策 信 息，强 化 市 民 对 于 教 育 信 息 的 有 效 获 取、教 育 政 策 的 正 确 理 解、未 来 需 求 的 准 确 预 期 等。h)才 金 直 通，被 标 记 的 人 才 通 过 扫 码 或 亮 码，可 实 现 人 才 政 策“一 键 兑 现”、人 才 办 事“一 站入 口”、人 才 双 创“一 帮 到 底”、人 才 服 务“一 码 供 给”；i)三 色 五 益，对 医 疗 卫 生、食 品 药 品、教 育 培 训、公 交 客 运、养 老 服 务 等 五 大 民 生 公 益 领 域 的从 业 人 员 通 过 红、黄、蓝 三 色 赋 码 管
24、理，市 民 可 进 行 特 定 行 业 从 业 限 制 查 询；j)助 残 助 学，帮 助 全 教 育 阶 段 残 疾 学 生 在 线 申 请 就 学 补 助，同 时 也 帮 助 他 们 解 决 日 常 学 习 和 生活 中 遇 到 的 各 类 问 题；k)幸 福 计 算 器，市 民 可 直 接 检 索 满 足 自 身 资 质 可 享 受 到 的 优 惠 政 策，将 福 利 政 策 直 达 市 民，打通 政 府 与 市 民 之 间 的 最 后 一 公 里，提 高 主 动 服 务 和 精 准 服 务 的 力 度。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 26B B附 录 B（规
25、 范 性）接 口 调 用 方 式 和 参 数 要 求B.1 产 生 二 维 码 接 口B.1.1 调 用 方 式产 生 二 维 码 接 口 应 通 过 互 联 网 或 政 务 外 网 调 用。B.1.2 参 数 要 求产 生 二 维 码 接 口 参 数 要 求 见 表 B.1。表 B.1 产 生 二 维 码 接 口 参 数 要 求类别 参数 是否必填 数据类型 说明输入参数 a c c e s s T o k e n 是 字符串 用户授权后的渠道令牌输入参数 l a t i t u d e 是 字符串 纬度输入参数 l o n g i t u d e 是 字符串 经度输出参数 c o d e
26、是 字符串 返回值代码输出参数 m e s s a g e 是 字符串 返回情况说明输出参数 c o n c e a l C a r d 是 字符串 脱敏的用户身份证号码输出参数 c o n c e a l N a m e 是 字符串 脱敏的用户姓名输出参数 q r c o d e B a s e 6 4 是 字符串 二维码 b a s e 6 4 字符串输出参数 q r c o d e T y p e 是 字符串 二维码类型输出参数 s e r v e r T i m e 是 时间 服务器时间返 回 数 据 格 式 统 一 采 用 字 符 串 格 式：示例：code:PY0000,msg:成
27、功,response:qrcodeType:gj,qrcodeBase64:iVBORw0KGCqYUXU0gxEIwAAAAASUVORK5CYII=,serverTime:2021-09-16 20:12:00,concealName:*严,concealCard:5*4D B 3 3 0 1/T 0 3 6 6.3 2 0 2 27B.2 用 户 标 签 信 息 查 询 接 口B.2.1 调 用 方 式用 户 标 签 信 息 查 询 接 口 应 通 过 互 联 网 或 政 务 外 网 调 用。B.2.2 参 数 要 求用 户 标 签 信 息 查 询 接 口 参 数 要 求 见 表 B.2
28、。表 B.2 用 户 标 签 信 息 查 询 接 口 参 数 要 求类别 参数 是否必填 数据类型 说明输入参数 a c c e s s T o k e n 是 字符串 用户授权后的渠道令牌输出参数 c o d e 是 字符串 返回值代码输出参数 m e s s a g e 是 字符串 返回情况说明输出参数 I c o n 是 字符串 返回的填 i c o n 图片地址输出参数 n o 是 整数 标签序号输出参数 t e x t 是 字符串 标签的文本内容输出参数 b a c k g r o u n d C o l o r 是 整数 返回的标签底色颜色枚举值输出参数 f o n t C o l
29、 o r 是 整数 返回的字体颜色枚举值返 回 数 据 格 式 统 一 采 用 字 符 串 格 式：示例：code:PY0000,msg:成功,response:icon:https:/类人才,fontColor:1D B 3 3 0 1/T 0 3 6 6.3 2 0 2 28B.3 渠 道 二 维 码 接 口B.3.1 调 用 方 式渠 道 二 维 码 接 口 应 通 过 互 联 网 或 政 务 外 网 调 用。B.3.2 参 数 要 求渠 道 二 维 码 接 口 参 数 要 求 见 表 B.3。表 B.3 渠 道 二 维 码 接 口 参 数 要 求类别 参数 是否必填 数据类型 说明输入
30、参数 a c c e s s T o k e n 是 字符串 用户授权后的渠道令牌输入参数 l o n g i t u d e 是 字符串 经度输入参数 l a t i t u d e 是 字符串 维度输出参数 c o d e 是 字符串 返回值代码输出参数 m e s s a g e 是 字符串 返回情况说明输出参数 q r c o d e T y p e 是 字符串 公交码类型输出参数 q r c o d e B a s e 6 4 是 字符串 二维码 b a s e 6 4 加密字符串输出参数 i d C a r d 是 字符串 用户身份证输出参数 s e r v e r T i m e
31、 是 字符串 请求时间输出参数 u s e r N m a e 是 字符串 用户姓名输出参数 c o n c e l N a m e 是 字符串 用户脱敏姓名输出参数 c o n c e l C a r d 是 字符串 用户脱敏身份证返 回 数 据 格 式 统 一 采 用 字 符 串 格 式：示例：code:PY0000,msg:成功,response:qrcodeType:gj,qrcodeBase64:iVBORw*kSuQmCC,idCard:33032719970101123X,serverTime:2021-09-16 12:39:04,userName:张三,concealName
32、:*三,concealCard:3*XB.4 解 码 能 力 接 口B.4.1 调 用 方 式解 码 能 力 接 口 应 通 过 互 联 网 或 政 务 外 网 调 用。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 29B.4.2 参 数 要 求解 码 能 力 接 口 参 数 要 求 见 表 B.4。表 B.4 解 码 能 力 接 口 参 数 要 求类别 参数 是否必填 数据类型 说明输入参数 m e r c h a n t I d 是 字符串 商户 i d输入参数 t i m e 是 字符串 时间字符串 y y y y M M s s H H m m s s输入参数 s i g
33、 n 是 字符串 R S A 签名输入参数 q r c o d 是 字符串 二维码值输入参数 m a c I d 是 字符串 设备编号输出参数 r e s p o n s e 是 字符串 A E S 加密的传输信息返 回 数 据 格 式 统 一 采 用 字 符 串 格 式：示例：code:PY0000,msg:成功,response:spoafjapioejrqpojrepanvcapfhodshfoaihfdoahvraiohrvquiooifgadosfjadoasfiopajsgoipasnfgaposndapodfsjfiopasncoapsdichpsaojgdioaspjfvian
34、dsopfjaiopsndfvoiapsndvioaspnvapngvudafgioansvpasnfiajopdjfaisudjfpfgasjdfaiponcioapngoaphasdB.5 第 三 方 授 权 接 口B.5.1 调 用 方 式第 三 方 授 权 接 口 应 通 过 互 联 网 或 政 务 外 网 调 用。B.5.2 参 数 要 求第 三 方 授 权 接 口 参 数 要 求 见 表 B.5。表 B.5 第 三 方 授 权 接 口 参 数 要 求类别 参数 是否必填 数据类型 说明输入参数 c o d e 是 字符串 第三方授权 c o d e输入参数 a p p I d 是
35、字符串 应用唯一标识响 应 方 式：跳 转 第 三 方 地 址。D B 3 3 0 1/T 0 3 6 6.3 2 0 2 21 0C C附 录 C（规 范 性）通 用 接 口 返 回 值 代 码 说 明通 用 接 口 返 回 值 代 码 说 明 见 表 C.1。表 C.1 通 用 接 口 返 回 值 代 码 说 明返回值代码 说明P Y 0 0 0 0 成功P Y 1 9 9 9 系统异常（未知错误）E r r o r 1 0 0 1 参数异常E r r o r 1 0 0 2 未登录或登录已过期E r r o r 1 0 0 3 业务异常E r r o r 1 0 0 4 未实名认证E r r o r 1 0 0 5 还未开通虚拟公交卡E r r o r 1 0 0 9 无效二维码E r r o r 1 0 1 0 二维码已使用或已过期E r r o r 3 0 0 0 小程序授权失败
