电子证照共享服务平台证照数据对接技术规范DB3704/T 0042-2024.pdf
I C S 3 5.0 2 0C C S L 8 0DB3704枣 庄 市 地 方 标 准D B 3 7 0 4/T 0 0 4 2-2 0 2 4电 子 证 照 共 享 服 务 平 台 证 照数 据 对 接 技 术 规 范2 0 2 4-0 3-2 7 发 布 2 0 2 4-0 4-2 7 实 施枣 庄 市 市 场 监 督 管 理 局发 布D B 3 7 0 4/T 0 0 4 2 2 0 2 4目 次前 言.1电 子 证 照 共 享 服 务 平 台 证 照 数 据 对 接 技 术 规 范.21 范 围.22 规 范 性 引 用 文 件.23 术 语 和 定 义.24 公 用 服 务.54.1 接 口 使 用 须 知.54.2 对 接 须 知.54.3 接 口 列 表.55 字 典 数 据.4 35.1 持 证 主 体 代 码 类 型 代 码.4 35.2 接 口 返 回 值 列 表.4 45.3 证 照 类 型 列 表.4 4D B 3 7 0 4/T 0 0 4 2 2 0 2 41前 言本 文 件 按 照 G B/T 1.1-2 0 2 0 标 准 化 工 作 导 则 第 1 部 分:标 准 化 文 件 的 结 构 和 起 草 规 则 的 规 定 起草。请 注 意 本 文 件 的 某 些 内 容 可 能 涉 及 专 利。本 文 件 的 发 布 机 构 不 承 担 识 别 专 利 的 责 任。本 文 件 由 枣 庄 市 大 数 据 局 提 出、归 口 并 组 织 实 施。本 文 件 起 草 单 位:枣 庄 市 大 数 据 中 心、南 威 软 件 股 份 有 限 公 司。本 文 件 主 要 起 草 人:陈 夫 真、赵 瑞 欣、赵 荣、陈 亚 楠、郗 金 鑫、苗 媛 媛、王 振、孙 竹 梅、韩 帮 冉、褚 萌、马 亮。本 文 件 为 首 次 发 布。D B 3 7 0 4/T 0 0 4 2 2 0 2 42电 子 证 照 共 享 服 务 平 台 证 照 数 据 对 接 技 术 规 范1 范 围本 技 术 规 范 设 计 是 为 了 规 范 第 三 方 业 务 系 统 如 何 生 成、管 理、查 询、获 取 电 子 证 照,如 网 上 办 事 大厅、行 政 审 批 系 统、办 公 或 颁 证 业 务 系 统 等,接 口 支 持 多 种 开 发 语 言 的 接 入,定 义 统 一 的 数 据 对 接 标 准,提 供 可 靠 性、安 全 性、规 范 化 的 接 口 标 准。本 规 范 的 阅 读 对 象 是 业 务 系 统 的 软 件 开 发 人 员、各 项 目 管 理 与 开 发 人 员。本 规 范 部 分 接 口 配 套 提 供 基 础 的 调 试 D E M O,开 发 人 员 可 根 据 实 际 情 况 自 行 扩 展 D E M O。2 规 范 性 引 用 文 件下 列 文 件 中 的 内 容 通 过 文 中 的 规 范 性 引 用 而 构 成 本 文 件 必 不 可 少 的 条 款。其 中,注 日 期 的 引 用 文 件,仅 该 日 期 对 应 的 版 本 适 用 于 本 文 件;不 注 日 期 的 引 用 文 件,其 最 新 版 本(包 括 所 有 的 修 改 单)适 用 于 本文 件。G B T 3 6 9 0 1-2 0 1 8 电 子 证 照 总 体 技 术 架 构G B T 3 6 9 0 2-2 0 1 8 电 子 证 照 目 录 信 息 规 范G B T 3 6 9 0 3-2 0 1 8 电 子 证 照 元 数 据 规 范G B T 3 6 9 0 4-2 0 1 8 电 子 证 照 标 识 规 范G B T 3 6 9 0 5-2 0 1 8 电 子 证 照 文 件 技 术 要 求G B T 3 6 9 0 6-2 0 1 8 电 子 证 照 共 享 服 务 接 口 规 范Z W F W C 0 1 2 3-2 0 1 8 国 家 政 务 服 务 平 台 证 照 类 型 代 码 及 目 录 信 息Z W F W C 0 1 2 4-2 0 1 8 国 家 政 务 服 务 平 台 电 子 证 照 跨 区 域 共 享 服 务 接 入 要 求3 术 语 和 定 义G B T 3 6 9 0 1-2 0 1 8、G B T 3 6 9 0 2-2 0 1 8、G B T 3 6 9 0 3-2 0 1 8 及 G B T 3 6 9 0 4-2 0 1 8 界 定 的 以 及 下列 术 语 和 定 义 适 用 于 本 文 件。3.1证 照由 机 关、团 体、企 事 业 单 位 颁 发 的,能 够 证 明 资 格 或 权 利 等 的 凭 证 类 文 件。注:证 照 包 括 证 件 和 执 照 等。来 源:G B/T 3 6 9 0 1-2 0 1 8,3.1 3.2接 口 角 色 及 分 类D B 3 7 0 4/T 0 0 4 2 2 0 2 43用 于 接 口 授 权 中 的 角 色 及 接 口 日 志 的 分 类 管 理,通 常 根 据 业 务 的 应 用 场 景 定 义,分 为 检 索 证 照、下载 证 照、获 取 信 息、查 看 证 照 等。3.3电 子 证 照由 计 算 机 等 电 子 设 备 形 成、传 输 和 存 储 的 证 照 数 据 文 件。来 源:G B/T 3 6 9 0 1-2 0 1 8,3.3 3.4证 照 照 面电 子 证 照 可 视 内 容 的 直 接 表 现 形 式,包 含 图 像 和 文 字 信 息 两 种 形 式,与 实 体 证 照 保 持 一 致。3.5电 子 证 照 文 件以 版 式 文 档 表 示 的 电 子 证 照,该 文 件 既 包 含 照 面 固 定 版 式 效 果,又 包 含 证 照 元 数 据 及 标 识,并 应 用密 码 技 术 保 障 这 些 内 容 的 真 实 性 和 完 整 性。来 源:G B/T 3 6 9 0 1-2 0 1 8,3.4 3.6证 照 目 录 信 息揭 示 电 子 证 照 文 件 主 要 内 容 和 形 式 特 征 的 条 目 信 息 集 合,是 证 照 管 理、共 享 和 服 务 的 基 本 工 具。3.7X M L可 扩 展 置 标 语 言(e X t e n s i b l e M a r k u p L a n g u a g e)。3.8B a s e 6 4 编 码B a s e 6 4 内 容 传 送 编 码 被 设 计 用 来 把 任 意 序 列 的 8 位 字 节 描 述 为 一 种 不 易 被 人 直 接 识 别 的 形 式。3.9J S O N 格 式J S O N(J a v a S c r i p t O b j e c t N o t a t i o n)是 一 种 轻 量 级 的 数 据 交 换 格 式。易 于 人 阅 读 和 编 写,可 以 在多 种 语 言 之 间 进 行 数 据 交 换。同 时 也 易 于 机 器 解 析 和 生 成。3.1 0T o k e n令 牌,代 表 执 行 某 些 操 作 的 权 利 的 对 象。是 一 串 字 符,用 于 标 识 用 户 的 身 份 和 权 限,通 常 包 含 一 些 加密 信 息,以 确 保 其 安 全 性。D B 3 7 0 4/T 0 0 4 2 2 0 2 443.1 1R E S T f u l一 般 指 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,简 称 R E S T)是 一 种软 件 架 构 风 格。它 是 一 种 针 对 网 络 应 用 的 设 计 和 开 发 方 式,可 以 降 低 开 发 的 复 杂 性,提 高 系 统 的 可 伸 缩性。3.1 2O A u t h 2.0一 种 用 户 验 证 和 授 权 的 互 联 网 标 准 协 议,该 协 议 要 么 通 过 组 织 在 资 源 拥 有 者 和 H T T P 服 务 商 之 间 的 被批 准 的 交 互 动 作 代 表 用 户,要 么 允 许 第 三 方 应 用 代 表 用 户 获 得 访 问 的 权 限。同 时 为 W e b 应 用,桌 面 应 用和 手 机,和 起 居 室 设 备 提 供 专 门 的 认 证 流 程。唯 一 凭 证 K E Y:接 口 传 输 中 用 与 标 识 身 份 的 签 名 字 段;凭 证 密 钥:与 凭 证 一 起 使 用,用 于 确 认 接 口 调 用 者 身 份。3.1 3认 证 机 制使 用 凭 证+凭 证 密 钥 的 方 式 进 行 接 口 认 证,除 了“4.3.1 用 户 身 份 验 证 接 口”以 外 的 每 个 接 口 访 问 时都 要 带 认 证 信 息 a c c e s s _ t o k e n(简 称 叫 t o k e n),此 t o k e n 是 通 过“4.3.1 用 户 身 份 验 证 接 口”的 返 回 结 果中 的“a c c e s s _ t o k e n”参 数 获 取 的。3.1 4编 码 格 式数 据 的 接 收 与 发 送 统 一 使 用 U T F-8 编 码。3.1 5数 据 规 约接 口 数 据 传 输 使 用 J S O N 格 式,数 据 的 提 交 使 用 H T T P 协 议 的 P O S T 标 准。数 据 返 回 包 含 有 消 息 头 h e a d 如 下 示 例:h e a d:m e s s a g e:获 取 成 功,s t a t u s:0,d a t a:t o t a l:0,d a t a:。3.1 6服 务 类 型电 子 证 照 国 标 共 享 服 务:根 据 电 子 证 照 国 家 标 准 中 的 共 享 服 务 接 口 规 范 提 供 的 相 关 接 口。3.1 7服 务 方 式a)推 荐 通 过 共 享 服 务 系 统 发 布 为 W e b s e r v i c e 或 R E S T f u l 服 务;b)R E S T f u l 服 务 直 接 调 用。D B 3 7 0 4/T 0 0 4 2 2 0 2 454 公 用 服 务4.1 接 口 使 用 须 知电 子 证 照 共 享 服 务 接 口 以 G B/T 3 6 9 0 1-2 0 1 8 中 指 出 的 电 子 证 照 系 统 与 业 务 系 统 之 间 的 交 互 关 系 为 应用 场 景,电 子 证 照 系 统 是 共 享 服 务 的 提 供 方,业 务 系 统 是 共 享 服 务 的 调 用 方。4.2 对 接 须 知a)由 业 务 部 门 向 共 享 平 台 申 请 接 口 权 限,审 批 后 接 口 发 给 电 子 证 照 项 目 组 开 通 权 限;b)系 统 根 据 部 门 申 请 信 息 分 配 u s e r n a m e(访 问 标 识)、p a s s w o r d(应 用 认 证 信 息),并 邮 件 发 送至 对 接 单 位 的 相 关 人 员;c)业 务 部 门 对 接 时 向 电 子 证 照 项 目 组 索 要 访 问 地 址 的 I P 和 p o r t 端 口 号。4.3 接 口 列 表4.3.1 用 户 身 份 验 证 接 口接 口 说 明:此 接 口 用 于 获 取 a c c e s s _ t o k e n 串,其 他 接 口 都 需 要 此 接 口 返 回 的 t o k e n 作 为 入 参。调 用 路 径:h t t p:/i p:p o r t/l i c e n s e-a p i-r e l e a s e/o a u t h/t o k e n接 口 调 用 请 求 说 明:h t t p 请 求 方 式:P O S T参 数 说 明:参数 是否 必须 说明c l i e n t _ i d 是 固定值为:x x x x-o a u t hc l i e n t _ s e c r e t 是 固定值为:x x x x-m o b i l eg r a n t _ t y p e 是 固定值为:p a s s w o r ds c o p e 是 固定值为:r e a d w r i t eu s e r n a m e 是 用户名(见 4.2 对接须知)p a s s w o r d 是 密码(见 4.2 对接须知)返 回 说 明:返 回 a c c e s s _ t o k e n 串。使 用 返 回 的 a c c e s s _ t o k e n 的 值 做 为 其 他 接 口 的 a c c e s s _ t o k e n 的 入 参 值。本 接 口 负 责 对 调 用 方 的 权 限 及 身 份 进 行 认 证,通 过 身 份 认 证 后 将 获 取 到 一 个 身 份 验 证 串(有 效 期 1 2小 时),调 用 方 使 用 该 身 份 验 证 串 就 可 以 调 用 相 应 权 限 的 接 口。证 照 共 享 相 关 接 口。access_token:f54922eb-62da-43df-acee-c2e7d69b0a9c,token_type:bearer,refresh_token:bc2d74f1-88ad-42ad-af9d-12b4d57d16bf,expires_in:43199,scope:read writeD B 3 7 0 4/T 0 0 4 2 2 0 2 464.3.2 证 照 标 识 获 取 下 载 地 址 接 口接 口 说 明:根 据 电 子 证 照 标 识 和 事 由、有 效 期 等 信 息 生 成 电 子 证 照 加 注 件 并 返 回 下 载 地 址,同 时 该 下 载 地 址有 时 效 控 制,默 认 1 0 分 钟。调 用 路 径:h t t p:/i p:p o r t/l i c e n s e-a p i-r e l e a s e/m/v/l i c e n s e/e x t e r n a l/a p i/S h a r e D o w n l o a d U r l接 口 方 式H T T P+J S O N请 求 方 式:P O S T编 码 类 型:U T F-8调 用 参 数参数 名称 类型 是否 必填 描述 信息a c c e s s _ t o k e n S t r i n g 是 访问标识c e r t i f i c a t e I D S t r i n g 是电子证照标识(证照持有主体代码获取证照信息接口/二维码获取证照信息接口有返回此值)e x p i r y T i m e S t r i n g 否电子证照加注件有效期截止时间,格式“y y y y-M M-d d”,如“2 0 2 1-0 8-2 6”c e r t i f i c a t e S y s t e m N a m e S t r i n g 是 系统名称,如:X X X X 服务平台c e r t i f i c a t e C a l l C a t e g o r y S t r i n g 是调用类别,0 标识事项调用,1 标识非事项调用c e r t i f i c a t e M a t t e r N a m e S t r i n g 是 事项名称,如:个人参保缴费证明查询打印c e r t i f i c a t e E v e n t C o d e S t r i n g 是事项编码(暂时定义“实施编码”),如:1 1 3 7 0 0 0 0 0 0 4 5 0 2 5 8 5 5 2 3 7 2 0 1 4 0 2 0 0 0 2c e r t i f i c a t e C o p y C a u s e S t r i n g 是 申请事由,不超过 2 0 0 字,如:个人参保缴费D B 3 7 0 4/T 0 0 4 2 2 0 2 47证明查询打印,需要用到身份证数据c a l l D i s t r i c t S t r i n g 否调用区(市)(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)c a l l D e p a r t m e n t S t r i n g 否 调用部门d i s t r i c t L e v e l S t r i n g 否 区(市)级别(市级、区级、街镇级)省 级 接 口 返 回 结 果 说 明:(1)当 返 回 结 果 为 省 级 接 口 返 回 数 据 时 如 下:h e a d:m e s s a g e:接 口 调 用 成 功!,t y p e:1,s t a t u s:0,d a t a:t o t a l:1,d a t a L i s t:c e r t I d e n t i f i e r:1.2.1 5 6.3 0 0 5.2.1 1 1 0 0 0 0 0 0 0 0 0 1 3 3 2 X W 0 0 2.1 1 3 7 0 0 0 0 0 0 4 5 0 4 6 7 9 L.3 F 3 5 4 B E B E E 9 D 4 D 1 C 8 A A C D D 8 2 0 D9 A 6 D F 8.0 0 1.O,c o n t e n t T y p e:h t t p,c o n t e n t:h t t p:/i p:p o r t/C e r t S h a r e/z z g x p t/d o w n l o a d?i d=f e 7 d 0 b 1 3 8 e 6 8 4 8 b c 8 8 2 6 8 a 9 5 0 a a 6 d 0 0 5 失 败 返 回:head:message:接口调用失败!,status:2,data:证照源未提供此服务接口(2)返 回 参 数 说 明字段名称 字段类型 描述D B 3 7 0 4/T 0 0 4 2 2 0 2 48h e a d.s t a t u s i n t 错误码;0.成功;其他.失败,详见 5.2 接口返回值列表h e a d.t y p e S t r i n g 1 为省级接口查询返回结果数据,2 为市级接口查询返回结果数据h e a d.m e s s a g e S t r i n g 返回结果说明t o t a l i n t 数量d a t a L i s t.c o n t e n t T y p e S t r i n g 取值为“h t t p”或“h t t p s”d a t a L i s t.c e r t I d e n t i f i e r S t r i n g 电子证照标识,其值遵循 G B T 3 6 9 0 4-2 0 1 8 电子证照标识规范d a t a L i s t.c o n t e n t S t r i n g 证件文件下载地址,下载后的文件是符合 G B/T 3 6 9 0 5-2 0 1 8 的要求备 注:省 里 的 身 份 证 数 据 返 回 值 是 一 个 u r l,此 u r l 访 问 后 是 p d f。市 级 接 口 返 回 结 果 说 明(1)当 返 回 结 果 为 市 级 接 口 返 回 数 据 时 如 下:h e a d:m e s s a g e:接 口 调 用 成 功,s t a t u s:0,d a t a:t o t a l:1,d a t a L i s t:i s s u e D e p t:证 照 颁 发 机 构,c e r t i f i c a t e N u m b e r:证 照 编 号,f i l e U r l:h t t p:/i p:p o r t/l i c e n s e-a p i-r e l e a s e/e l s s p/v 1/d o w n l o a d _ n a t i o n a l?f i l e I d=e m Z 2 M 3 J w d 0 E w T l F q Sj R l S z B p Z U I 3 n l L U 0 Z o U T l L d H V m R 3 R R T G h r T E Z h T U Z a N 1 V O a 2 x H R W t F O D R 4 Q W V T S 1 F n N g=&f i l e F o r m a t=O F D,i s s u e D a t e:2 0 1 3 年 0 9 月 2 4 日,f i l e F o r m a t:O F D,c e r t i f i c a t e T y p e:证 照 类 型 名 称(2)返 回 参 数 说 明字段名称 字段类型 描述h e a d.s t a t u s i n t 错误码:0.成功;其他.失败(详见 5.2 接口返回值列表)h e a d.m e s s a g e S t r i n g 返回结果说明D B 3 7 0 4/T 0 0 4 2 2 0 2 49t o t a l i n t 数量d a t a L i s t.i s s u e D e p t S t r i n g 证照颁发机构d a t a L i s t.c e r t i f i c a t e N u m b e r S t r i n g 证照编号d a t a L i s t.f i l e U r l S t r i n g 证件文件下载地址,下载后的文件是符合 G B/T 3 6 9 0 5-2 0 1 8 的要求d a t a L i s t.i s s u e D a t e S t r i n g 证照颁发日期d a t a L i s t.f i l e F o r m a t S t r i n g 证照文件格式d a t a L i s t.C e r t i f i c a t e T y p e S t r i n g 证照类型名称4.3.3 证 照 标 识 获 取 证 照 信 息 接 口接 口 说 明根 据 电 子 证 照 标 识 获 取 该 证 照 的 信 息 内 容。调 用 路 径:h t t p:/i p:p o r t/l i c e n s e-a p i-r e l e a s e/m/v/l i c e n s e/e x t e r n a l/a p i/S h a r e Q u e r y C e r t I n f o接 口 方 式H T T P+J S O N请 求 方 式P O S T编 码 类 型U T F-8调 用 参 数参数名称 类型 是否必填 描述信息a c c e s s _ t o k e n S t r i n g 是 访问标识D B 3 7 0 4/T 0 0 4 2 2 0 2 41 0c e r t i f i c a t e I D S t r i n g 是电子证照标识(证照持有主体代码获取证照信息接口/二维码获取证照信息接口有返回此值)i n t e r f a c e T y p e S t r i n g 否0 调用省接口,1 调用市接口默认 0c e r t i f i c a t e S y s t e m N a m e S t r i n g 是 系统名称c e r t i f i c a t e C a l l C a t e g o r y S t r i n g 是 调用类别 0 标识事项调用,1 标识非事项调用c e r t i f i c a t e M a t t e r N a m e S t r i n g 是 事项名称c e r t i f i c a t e E v e n t C o d e S t r i n g 是 事项编码(暂时定义“实施编码”)c e r t i f i c a t e C o p y C a u s e S t r i n g 是 申请事由,不超过 2 0 0 字c a l l D i s t r i c t S t r i n g 否调用区(市)(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)c a l l D e p a r t m e n t S t r i n g 否 调用部门d i s t r i c t L e v e l S t r i n g 否 区(市)级别(市级、区级、街镇级)省 级 接 口 返 回 结 果 说 明(1)返 回 结 果 如 下:h e a d:m e s s a g e:接 口 调 用 成 功!,t y p e:1,s t a t u s:0,d a t a:t o t a l:1,d a t a L i s t:c e r t n o:3 7 0 8 2 6 1 9 8 8 0 X X X X X X X,g m s f h m:3 7 0 8 2 6 1 9 8 8 0 X X X X X X X,n a m e:X X,c e r t _ i d e n t i f i e r:1.2.1 5 6.3 0 0 5.2.1 1 1 0 0 0 1 0 0 0 0 0 1 3 1 2 7 D 0 0 1.1 1 3 7 0 0 0 0 0 0 4 5 0 4 9 2 7 A.C F D 9 3 5 2 4 1 7 3 8 4 8 F 3 A 2 E D 4 A B 7 A 3 6 E7 A 5 0.0 0 1.8 D B 3 7 0 4/T 0 0 4 2 2 0 2 41 1(2)返 回 参 数 说 明字段名称 字段类型 描述h e a d.s t a t u s i n t 错误码:0.成功;其他.失败(详见 5.2 接口返回值列表)h e a d.t y p e S t r i n g 1 为省级接口查询返回结果数据,2 为市级接口查询返回结果数据h e a d.m e s s a g e S t r i n g 返回结果说明t o t a l i n t 总数量d a t a L i s t.*S t r i n g 电子证照照面信息,每个证照具体的返回字段市 级 接 口 返 回 结 果 说 明(1)当 返 回 结 果 为 市 级 接 口 返 回 数 据 时 如 下:h e a d:m e s s a g e:接 口 调 用 成 功,s t a t u s:0,d a t a:t o t a l:1,d a t a L i s t:c e r t i f i c a t e H o l d e r:陈 x x,c e r t i f i c a t e V a l i d a t e S t a r t:2 0 1 3 年 0 9 月 2 3 日,c e r t i f i c a t e V a l i d a t e E n d:2 0 1 6 年 0 9 月 2 2 日,i s s u e D e p t:X X 市 无 线 电 管 理 处,c e r t i f i c a t e N a m e:中 国 X X X X 操 作 证 书,c e r t i f i c a t e H o l d e r T y p e:1 1 1,c e r t i f i c a t e N u m b e r:A 0 0 0 0 0 2 5 7 6,i s s u e D e p t C o d e:1 2 3 7 0 4 0 0 F 4 9 2 0 1 5 5 8 F,c e r t i f i c a t e H o l d e r C o d e:3 7 0 4 0 3 1 9 X X X X 1 2 0 9,d e t a i l:,i s s u e D a t e:2 0 1 3 年 0 9 月 2 3 日,d i g i t a l S i g n:,c e r t i f i c a t e T y p e:中 国 X X X X 操 作 证 书 D B 3 7 0 4/T 0 0 4 2 2 0 2 41 2(2)返 回 参 数 说 明字段名称 字段类型 描述h e a d.s t a t u s i n t 错误码:0.成功;其他.失败(详见 5.2 接口返回值列表)h e a d.m e s s a g e S t r i n g 返回结果说明t o t a l i n t 总数量d a t a L i s t.*S t r i n g 电子证照照面信息,每个证照具体的返回字段4.3.4 证 照 类 型 代 码 验 证 证 照 信 息 接 口接 口 说 明根 据 持 证 主 体 代 码、证 照 类 型 代 码 以 及 其 他 指 定 的 证 照 信 息 内 容,查 验 电 子 证 照 有 效 性。调 用 路 径:h t t p:/i p:p o r t/l i c e n s e-a p i-r e l e a s e/m/v/l i c e n s e/e x t e r n a l/a p i/S h a r e V e r i f y C e r t I n f o接 口 方 式H T T P+J S O N请 求 方 式P O S T编 码 类 型U T F-8调 用 参 数参 数 名 称 类 型 是 否 必 填 描 述 信 息a c c e s s _ t o k e n S t r i n g 是 访问标识D B 3 7 0 4/T 0 0 4 2 2 0 2 41 3c e r t T y p e C o d e S t r i n g 是 证照类型代码,参考附件 5.3 证照类型代码表c e r t i f i c a t e D a t a S t r i n g 是要查验的电子证照数据 j s o n 字符串,在对接时由各业务单位提交验证字段申请,由电子证照系统后台配置。u s e F o r S t r i n g 是 申请事由,不超过 2 0 0 字c e r t i f i c a t e H o l d e r C o d e S t r i n g 是 持证主体代码(如:公民身份号码、统一社会信用代码)i n t e r f a c e T y p e S t r i n g 否0 调用省接口,1 调用市接口默认 0c a l l D i s t r i c t S t r i n g 否调用区(市)(市中区、薛城区、峄城区、台儿庄区、山亭区、滕州市)c a l l D e p a r t m e n t S t r i n g 否 调用部门d i s t r i c t L e v e l S t r i n g 否 区(市)级别(市级、区级、街镇级)省 级 接 口 返 回 结 果 说 明(1)返 回 结 果 如 下:h e a d:m e s s a g e:接 口 调 用 成 功!,t y p e:1,s t a t u s:0,d a t a:t o t a l:1,d a t a L i s t:r e s u l t:0,m e s s a g e:信 息 正 确 且 有 效(2)返 回 参 数 说 明字段名称 字段类型 描述h e a d.s t a t u s i n t 错误码:0.成功;其他.失败(详见 5.2 接口返回值列表)D B 3 7 0 4/T 0 0 4 2 2 0 2 41 4h e a d.t y p e S t r i n g1 为省级接口查询返回结果数据,2 为市级接口查询返回结果数据h e a d.m e s s a g e S t r i n g 返回结果说明D a t a.t o t a l i n t 总数量d a t a.d a t a L i s t.r e s u l t S t r i n g 校验结果,返回 0 表示校验正确,其他值表示失败d a t a.d a t a L i s t.m e s s a g e S t r i n g校验结果说明,与校验结果代码对应的文字说明,如:“0”:“信息正确且有效”;“1”:“信息正确且未激活”;“2”:“信息正确且证照暂时失效”“3”:“信息正确且证照已失效”;“4”:“信息不全无法验证”;“5”:“查无此信息”市 级 接 口 返 回 结 果 说 明(1)当 返 回 结 果 为 市 级 接 口 返 回 数 据 时 如 下:h e a d:m e s s a g e:接 口 调 用 成 功,s t a t u s:0,d a t a:v e r i f y R e s u l t:t r u e(2)返 回 参 数 说 明字段名称 字段类型 描述h e a d.s t a t u s i n t 错误码:0.成功;其他.失败(详见 5.2 接口返回值列表)h e a d.m e s s a g e S t r i n g 返回结果说明d a t a.v e r i f y R e s u l t S t r i n g 校验结果,返回 t r u e 表示校验正确,其他值表示失败4.3.5 证 照 类 型 代 码 验 证 证 照 文 件 接 口D B 3 7 0 4/T 0 0 4 2 2 0 2 41 5接 口 说 明根 据 提 供 的 电 子 证 照 原 件 或 加 注 件,验 证 电 子 证 照 文 件 真 实 性、电 子 证 照 文 件 完 整 性 及 电 子 证 照有 效 性。调 用 路 径:h t t p:/i p:p o r t/l i c e n s e-a p i-r e l e a s e/m/v/l i c e n s e/e x t e r n a l/a p i/S h a r e V e r i f y C e r t I n f o接 口 方 式H T T P+J S O N请 求 方 式P O S T编 码 类 型U T F-8调 用 参 数参数名称 类型 是否必填 描述信息a c c e s s _ t o k e n S t r i n g 是 应用认证信息c e r t T y p e C o d e S t r i n g 是 证照类型代码,参考 5.3 证照类型代码表c o n t e n t T y p e S t r i n g 是 固定为 b a s e 6 4。c o n t e n t S t r i n g 是B a s e 6 4 字符串,解码后的内容应符合 G B/T 3 6 9 0 5-2 0 1 8 的要求u s e C a u s e S t r i n g 是 申请事由,不超过 2 0 0 字i n t e r f a c e T y p e S t r i n g 否 0 调用省接口,1 调用市接口c a l l D i s t r i c t S t r i n g 否 调用区(市)(市中区、薛城区、峄城区、台儿庄区、山亭D B 3 7 0 4/T 0 0 4 2 2 0 2 41 6区、滕州市)c a l l D e p a r t m e n t S t r i n g 否 调用部门d i s t r i c t L e v e l S t r i n g 否 区(市)级别(市级、区级、街镇级)(1)返 回 结 果 如 下:h e a d:s t a t u s:0,m e s s a g e:接 口 调 用 成 功,d a t a:0 4 D 4 F B 9 5 9 4 3 B 9 E 0 4 1 9 3 9 0 A 3 7 B 4 8 A 6 F 2 8 0 5 F 9 0 9 1(2)返 回 结 果 说 明字段名称 字段类型 描述h e a d.s t a t u s i n t 错误码:0.成功;其他.失败(详见 5.2 接口返回值列表)h