资源描述
ICS 3 5.2 0 0CCS L 7 014山 西 省 地 方 标 准D B 1 4/T 3 0 2 4 2 0 2 4惠 民 惠 农 财 政 补 贴 资 金 一 卡 通 服 务 平 台与 代 发 银 行 接 口 规 范2 0 2 4-0 5-2 9 发 布 2 0 2 4-0 8-2 8 实 施山 西 省 市 场 监 督 管 理 局 发 布D B 1 4/T 3 0 2 4 2 0 2 4I目 次前 言.I I1 范 围.12 规 范 性 引 用 文 件.13 术 语 和 定 义.14 接 口 类 型.15 接 口 调 用.26 接 口 描 述.37 安 全 要 求.1 4D B 1 4/T 3 0 2 4 2 0 2 4I I前 言本 文 件 按 照 G B/T 1.1 2 0 2 0 标 准 化 工 作 导 则 第 1 部 分：标 准 化 文 件 的 结 构 和 起 草 规 则 的 规定 起 草。本 文 件 由 山 西 省 财 政 厅 提 出、组 织 实 施 和 监 督 检 查。山 西 省 市 场 监 督 管 理 局 对 标 准 的 组 织 实 施 情 况 进 行 监 督 检 查。本 文 件 由 山 西 省 财 政 标 准 化 技 术 委 员 会（S X S/T C 4 8）归 口。本 文 件 起 草 单 位：山 西 省 财 政 科 学 研 究 院、山 西 宝 佳 质 量 基 础 研 究 院（有 限 合 伙）。本 文 件 主 要 起 草 人：葛 强、任 巍 英、张 宝 林、韩 慧 彦、李 林 骏、张 素 娥、董 阿 敏、徐 维 迪、李 斌、石 鑫。D B 1 4/T 3 0 2 4 2 0 2 41惠 民 惠 农 财 政 补 贴 资 金 一 卡 通 服 务 平 台 与 代 发 银 行 接 口 规 范1 范 围本 文 件 规 定 了 惠 民 惠 农 财 政 补 贴 资 金“一 卡 通”服 务 平 台（以 下 简 称“一 卡 通 平 台”）与 代 发 银 行的 接 口 类 型、接 口 调 用、接 口 描 述 和 安 全 要 求。本 文 件 适 用 于 代 发 银 行 接 入 一 卡 通 平 台 的 设 计、开 发 和 应 用。2 规 范 性 引 用 文 件本 文 件 没 有 规 范 性 引 用 文 件。3 术 语 和 定 义下 列 术 语 和 定 义 适 用 于 本 文 件。代 发 银 行省、市、县（市、区）区 域 内，依 法 设 置 的 各 项 财 政 补 贴 资 金 委 托 代 发 银 行。4 接 口 类 型一 卡 通 平 台 与 代 发 银 行 接 口 包 括 B T 0 0 1 身 份 登 录 接 口、Y H 0 0 8 单 笔 银 行 账 号 验 证 接 口、Y H 0 1 0 批 量银 行 账 号 验 证 接 口、B T 0 0 9 银 行 账 号 验 证 结 果 接 收 接 口、Y H 0 0 5 补 贴 明 细 接 收 接 口、B T 0 0 6 上 卡 结 果 接收 接 口、Y H 0 1 1 查 询 银 行 工 作 状 态 接 口、Y H 0 1 2 获 取 银 行 回 盘 文 件 接 口，接 口 类 型 如 表 1 所 示。表 1 接 口 类 型接口名称 类型描述B T 0 0 1 身份登录接口该接口由一卡通平台建设，由代发银行调用，用于调用 B T 0 0 9 与 B T 0 0 6 接口前进行身份验证Y H 0 0 8 单笔银行账号验证接口该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的单笔银行账号（账户名，证件号码，银行账号）信息，验证准确性后同步返回验证结果Y H 0 1 0 批量银行账号验证接口该接口由代发银行建设，由一卡通平台调用，用于接收来自一卡通平台的批量银行账号信息，验证准确性后通过接口 B T 0 0 9 返回验证结果B T 0 0 9 银行账号验证结果接收接口该接口由一卡通平台建设，由代发银行调用，用于接收来自银行的银行账号异步返回验证结果Y H 0 0 5 补贴明细接收接口 该接口由代发银行建设，由一卡通平台调用，传递银行上卡明细数据及汇总数据D B 1 4/T 3 0 2 4 2 0 2 42表 1 接 口 类 型（续）接口名称 类型描述B T 0 0 6 上卡结果接收接口 该接口由一卡通平台建设，由代发银行调用，用于接收代发银行上卡结果Y H 0 1 1 查询银行工作状态接口该接口由代发银行建设，由一卡通平台调用，用于获取银行方某批次验卡或发放状态结果，返回结果应包含以下状态：未收到请求（默认），未开始验卡、验卡审批中、验卡进行中、验卡结束；未启动发放、发放审批中、发放结束等Y H 0 1 2 获取银行回盘文件接口该接口由代发银行建设，由一卡通平台调用，用于一卡通平台主动向银行获取回盘文件5 接 口 调 用一 卡 通 平 台 与 代 发 银 行 使 用 各 数 据 接 口，经 过 身 份 认 证、信 息 验 证、补 贴 发 放、银 行 状 态 查 询、获取 银 行 回 盘 文 件 五 个 步 骤 实 现 惠 民 惠 农 财 政 补 贴 资 金 的 发 放，各 接 口 调 用 如 附 录 A 图 A.1 所 示，各 阶 段接 口 调 用 方 式 如 下：身 份 认 证：银 行 调 用“B T 0 0 1 身 份 登 录 接 口”进 行 身 份 认 证，认 证 通 过 后 完 成 后 续 阶 段 业 务；信 息 验 证：一 卡 通 平 台 调 用“Y H 0 0 8 单 笔 银 行 账 号 验 证 接 口”推 送 单 笔 银 行 账 号 信 息，银 行 验证 准 确 性 后 同 步 返 回 验 证 结 果；一 卡 通 平 台 调 用“Y H 0 1 0 批 量 银 行 账 号 验 证 接 口”推 送 批 量 银行 账 号 信 息，银 行 验 证 准 确 性 后，调 用“B T 0 0 9 银 行 账 号 验 证 结 果 接 收 接 口”返 回 验 证 结 果；补 贴 发 放：一 卡 通 平 台 调 用“Y H 0 0 5 补 贴 明 细 接 收 接 口”推 送 补 贴 对 象 明 细 信 息，银 行 发 放 结束 后，调 用“B T 0 0 6 上 卡 结 果 接 收 接 口”返 回 发 放 结 果；银 行 状 态 查 询：一 卡 通 平 台 推 送 成 功 至 银 行 后，调 用“Y H 0 1 1 查 询 银 行 工 作 状 态 接 口”，查 询某 批 次 账 号 验 证 或 补 贴 发 放 状 态；获 取 银 行 回 盘 文 件：当 一 卡 通 平 台 网 络 出 现 问 题，银 行 未 能 成 功 生 成 回 盘 详 情 文 件 时，一 卡通 平 台 调 用“Y H 0 1 2 获 取 银 行 回 盘 文 件 接 口”，令 银 行 再 次 生 成 回 盘 详 情 文 件，并 读 取 详 情 文件 更 新 数 据。D B 1 4/T 3 0 2 4 2 0 2 43图 1 接 口 调 用 方 式6 接 口 描 述通 用 要 求6.1.1 数 据 类 型接 口 参 数 数 据 类 型 包 括 数 值 型（n u m b e r）和 字 符 型（s t r i n g）两 种。D B 1 4/T 3 0 2 4 2 0 2 446.1.2 数 据 格 式接 口 之 间 数 据 传 输 采 用 J S O N 数 据 格 式。6.1.3 消 息 结 构6.1.3.1 组 成由 消 息 头 和 消 息 体 组 成。消 息 头 格 式 如 表 2 所 示；消 息 体 由 h e a d 与 d a t a 组 成，h e a d 包 含 唯 一 标识、日 期、银 行 联 行 号 等 通 用 字 段，如 表 3 所 示，d a t a 对 应 不 同 接 口 功 能 性 字 段，详 见 本 章 各 接 口 请求 参 数。表 2 消 息 头 格 式键名称 说明A u t h o r i z a t i o n j w t 身份验证 t o k e n表 3 消 息 体 h e a d 格 式参数名称 数据类型 可选/必选 说明i d s t r i n g 必选 接口类型标识u u i d s t r i n g 必选 批次号（3 2 位 u u i d）c a l l D a t e s t r i n g 必选 调用日期c a l l T i m e s t r i n g 必选 调用时间c a l l U s e r s t r i n g 必选 调用人a r e a C o d e s t r i n g 必选 区域编码（1 2 位）b a n k N o s t r i n g 必选 银行联行号（1 2 位）6.1.3.2 返 回 消 息 码6.1.3.2.1 数 据 返 回 编 码 如 表 4 所 示。表 4 数 据 返 回 编 码 表数据返回编 码 返回说明 备注0 0 2 户名不符-0 0 3 账户信息不正确-0 0 4 卡冻结-0 0 5 卡注销-D B 1 4/T 3 0 2 4 2 0 2 45表 4 数 据 返 回 编 码 表（续）0 0 6 卡休眠-0 0 7 卡透支-0 0 8 卡挂失-0 0 9 其他原因-0 1 0 文件异常 文件读取解析错误6.1.3.2.2 接 口 调 用 返 回 编 码 如 表 5 所 示。表 5 接 口 调 用 返 回 编 码 表接口调用返回编码 返回说明 备注2 0 0 处理成功 O K2 0 2 已接受处理请求，但处理尚未完成 A c c e p t e d2 0 4 服务器已接 收请求，但尚未处理 N o C o n t e n t4 0 0 协议或者参数非法 B a d R e q u e s t4 0 1 签名验证失败 U n a u t h o r i z e d4 0 3 权限异常 F o r b i d d e n4 0 4 请求的资源不存在 N o t F o u n d4 2 9 请求超过频率限制 T o o M a n y R e q u e s t s5 0 0 系统错误 S e r v e r E r r o r5 0 2 服务下线，暂时不可用 B a d G a t e w a y5 0 3 服务不可用，过载保护 S e r v i c e U n a v a i l a b l e9 0 0 请求参数不符合业务要求-9 0 1 返回参数不符合业务要求-6.1.4 调 用 策 略接 口 调 用 策 略 包 括：超 时 时 间：在 与 接 口 进 行 通 信 时，时 间 限 制 为 2 0 秒；调 用 次 数：无 限 制。参 数 要 求6.2.1 B T 0 0 1 身 份 登 录 接 口接 口 参 数 如 表 6 所 示。D B 1 4/T 3 0 2 4 2 0 2 46表 6 B T 0 0 1 身 份 登 录 接 口6.2.2 Y H 0 0 8 单 笔 银 行 账 号 验 证 接 口接 口 参 数 如 表 7 所 示。表 7 Y H 0 0 8 单 笔 银 行 账 号 验 证 接 口接口名称 Y H 0 0 8 单笔银行账号验证接口接口访问地址 a p i/b a n k/v e r f i y A c c o u n t 接口请求方式 P O S T功能银 行接 收 来自 一 卡 通平 台 的单 笔 银行 账 号（账 户 名，证 件号 码，银 行 账 号）信 息，验 证准 确 性后 同步返回验证结果请求参数参数名称 数据类型 可选/必选 说明n a m e s t r i n g 必选 账户名i d N o s t r i n g 必选 证件号码b a n k A c c t s t r i n g 必选 银行账号接口名称 B T 0 0 1 身份登录接口接口访问地址 a p i/u s e r/s y s/l o g i n 接口请求方式 P O S T功能 对接入一卡通平台的银行用户进行身份验证请求参数u s e r n a m e s t r i n g 必选 账户名（B a s e 6 4 加密）p a s s w o r d s t r i n g 必选 密码（B a s e 6 4 加密）c a p t c h a s t r i n g 必选 验证码（默认：0）c h e c k K e y s t r i n g 必选 验证码 k e y（默认：0）p r o j e c t I d s t r i n g 必选 项目 i d（默认：2 6）响应参数参数名称 数据类型 可选/必选 说明t o k e n s t r i n g 必选长度 不超过 6 4 字节，每一 次接口调 用的唯一 标识，当 异步返回结果时，u u i d 为调用请求报文中的 u u i dc o d e s t r i n g 必选 如表 4 数据返回编码表所示m s g s t r i n g 可选 补充说明原因D B 1 4/T 3 0 2 4 2 0 2 47表 7 Y H 0 0 8 单 笔 银 行 账 号 验 证 接 口（续）e x t e n d 1 s t r i n g 可选 预留字段 1e x t e n d 2 s t r i n g 可选 预留字段 2响应参数参数名称 数据类型 可选/必选 说明n a m e s t r i n g 必选 账户名i d N o s t r i n g 必选 证件号码b a n k A c c t s t r i n g 必选 银行账号r e s u l t s t r i n g 必选 验证结果（-1-验证不通过；0-未验证；1-验证通过）e r r o r C o d e s t r i n g 可选 错误代码e r r o r M s g s t r i n g 可选 错误描述e x t e n d 1 s t r i n g 可选 预留字段 1e x t e n d 2 s t r i n g 可选 预留字段 26.2.3 Y H 0 1 0 批 量 银 行 账 号 验 证 接 口6.2.3.1 接 口 参 数 如 表 8 所 示。表 8 Y H 0 1 0 批 量 银 行 账 号 验 证 接 口接口名称 Y H 0 1 0 批量银行账号验证接口接口访问地址 a p i/b a n k/a c c e p t V a l i d a t e d D e t a i l 接口请求方式 P O S T功能 银行接收来自一卡通平台的批量银行账号信息请求参数参数名称 数据类型 可选/必选 说明r o w C n t n u m b e r 必选 总行数f i l e N a m e s t r i n g 必选 卡信息文件下载名称e x t e n d 1 s t r i n g 可选 预留字段 1e x t e n d 2 s t r i n g 可选 预留字段 2响应参数参数名称 数据类型 可选/必选 说明D B 1 4/T 3 0 2 4 2 0 2 48表 8 Y H 0 1 0 批 量 银 行 账 号 验 证 接 口（续）c o d e s t r i n g 必选 调用结果e r r o r s t r i n g 可选 失败原因6.2.3.2 接 口 说 明 如 下：文 件 说 明：批 量 银 行 账 号 文 件 用 于 存 储 一 卡 通 平 台 的 批 量 银 行 账 号 信 息，其 命 名 方 式 为：接口 编 码 _ C a l l U s e r _ A r e a C o d e+T o+B a n k N o+_+u u i d+.t x t，其 中 u u i d 须 与 银 行 账 号 验 证 结 果 文 件名 中 的 u u i d 一 致；示例：Y H 0 1 0 _ 1 5 0 1 5 1 1 0 1 4 3 3 6 _ 1 4 0 0 0 0 0 0 0 0 0 0 T o 1 0 1 0 0 0 0 0 0 0 0 0 _ 8 7 d 6 9 0 8 4 a c 4 8 4 3 2 1 c b 3 e e 6 b 2 1 6 d e c c e 1.t x t。文 件 格 式：字 段 通 过|$分 隔，行 通 过 n 分 隔；文 件 行 数：最 大 1 0 万 笔；文 件 字 段 说 明 如 表 9 所 示。表 9 批 量 银 行 账 号 文 件 字 段名称 字体类型 最大长度 允许为空 说明明细流水 s t r i n g 1 2 8 N 当前文件唯一账户名 s t r i n g 2 5 6 N-证件号码 s t r i n g 3 2 N-银行账号 s t r i n g 3 2 N-预留字段 1 s t r i n g 1 2 8 Y-预留字段 2 s t r i n g 2 5 6 Y-6.2.4 B T 0 0 9 银 行 账 号 验 证 结 果 接 收 接 口6.2.4.1 接 口 参 数 如 表 1 0 所 示。表 1 0 B T 0 0 9 银 行 账 号 验 证 结 果 接 收 接 口接口名称 B T 0 0 9 银行账号验证结果接收接口接口访问地址/a p i/b a n k/p a y R e s/v a l i d a t e d R e s u l t 接口请求方式 P O S T功能 银行调取异步返回数据信息验证结果请求参数参数名称 数据类型 可选/必选 说明r o w C n t n u m b e r 必选 总行数s u c R o w C n t n u m b e r 必选 验证通过行数D B 1 4/T 3 0 2 4 2 0 2 49表 1 0 B T 0 0 9 银 行 账 号 验 证 结 果 接 收 接 口（续）f i l e N a m e s t r i n g 必选 验证结果文件名称e x t e n d 1 s t r i n g 可选 预留字段 1e x t e n d 2 s t r i n g 可选 预留字段 2响应参数参数名称 数据类型 可选/必选 说明c o d e s t r i n g 必选 调用结果e r r o r s t r i n g 可选 失败原因6.2.4.2 接 口 说 明 如 下：文 件 说 明：银 行 账 号 验 证 结 果 文 件 用 于 存 储 银 行 返 回 账 号 信 息 验 证 结 果，其 命 名 方 式 为：接口 编 码 _ C a l l U s e r _ B a n k N o+T o+A r e a C o d e+_+u u i d+.t x t,其 中 u u i d 须 与 批 量 银 行 账 号 文 件 名 中的 u u i d 一 致；示例：B T 0 0 9 _ 1 5 0 1 5 1 1 0 1 4 3 3 6 _ 1 0 1 0 0 0 0 0 0 0 0 0 T o 1 4 0 0 0 0 0 0 0 0 0 0 _ 8 7 d 6 9 0 8 4 a c 4 8 4 3 2 1 c b 3 e e 6 b 2 1 6 d e c c e 1.t x t。文 件 格 式：字 段 通 过|$分 隔，行 通 过 n 分 隔；文 件 行 数：最 大 1 0 万 笔；文 件 字 段 说 明 如 表 1 1 所 示。表 1 1 银 行 账 号 验 证 结 果 文 件 字 段名称 字体类型 最大长度 允许为空 说明明细流水 s t r i n g 1 2 8 N 当前文件唯一账户名 s t r i n g 2 5 6 N-证件号码 s t r i n g 3 2 N-银行账号 s t r i n g 3 2 N-验证结果 s t r i n g 2 N-1：验证不通过；0：未验证；1：验证通过错误代码 s t r i n g 3 Y 如表 4 数据返回编码表所示错误描述 s t r i n g 2 5 6 Y 当错误代码为 0 0 9 时，错误描述不为空预留字段 1 s t r i n g 1 2 8 Y-预留字段 2 s t r i n g 2 5 6 Y-6.2.5 Y H 0 0 5 补 贴 明 细 接 收 接 口6.2.5.1 接 口 参 数 如 表 1 2 所 示。D B 1 4/T 3 0 2 4 2 0 2 41 0表 1 2 Y H 0 0 5 补 贴 明 细 接 收 接 口接口名称 Y H 0 0 5 补贴明细接收接口接口访问地址/a p i/b a n k/a c c e p t D a t a 接口请求方式 P O S T功能 一卡通平台向银行传输上卡明细数据及汇总数据请求参数参数名称 数据类型 可选/必选 说明p a y e e A c c t N o s t r i n g 可选/付款人账号p a y e e A c c t N a m e s t r i n g 可选/付款人名称p a y e e A c c t D e p s t r i n g 可选/付款人开户行p r o j N a m e s t r i n g 可选/项目名称(用于上卡备注)a m t S u m n u m b e r 可选/总金额(单位：分)r o w C n t n u m b e r 可选/总笔数f i l e N a m e s t r i n g 可选/发放明细文件名称e x t e n d 1 s t r i n g 必选 预留字段 1e x t e n d 2 s t r i n g 必选 预留字段 2响应参数参数名称 数据类型 可选/必选 说明c o d e s t r i n g 必选 调用结果e r r o r s t r i n g 必选 失败原因6.2.5.2 接 口 说 明 如 下：文 件 说 明：补 贴 明 细 文 件 用 于 存 储 一 卡 通 平 台 向 银 行 传 输 上 卡 明 细 数 据，其 命 名 方 式 为：接口 编 码 _ C a l l U s e r _ A r e a C o d e+T o+B a n k N o+_+u u i d+.t x t,其 中 u u i d 须 与 代 发 银 行 上 卡 结 果 文 件名 中 的 u u i d 一 致；示例：Y H 0 0 5 _ 1 5 0 1 5 1 1 0 1 4 3 3 6 _ 1 4 0 0 0 0 0 0 0 0 0 0 T o 1 0 1 0 0 0 0 0 0 0 0 0 _ 8 7 d 6 9 0 8 4 a c 4 8 4 3 2 1 c b 3 e e 6 b 2 1 6 d e c c e 1.t x t。文 件 格 式：字 段 通 过|$分 隔，行 通 过 n 分 隔；文 件 行 数：最 大 1 0 万 笔；文 件 字 段 说 明 如 表 1 3 所 示。表 1 3 补 贴 明 细 文 件 字 段名称 字体类型 最大长度 允许为空 说明明细流水 s t r i n g 1 2 8 N 当前文件唯一姓名/企业名称 s t r i n g 2 5 6 N-D B 1 4/T 3 0 2 4 2 0 2 41 1表 1 3 补 贴 明 细 文 件 字 段（续）证件号码 s t r i n g 3 2 N-补贴金额 n u m b e r 2 0 N 单位：分银行账号 s t r i n g 3 2 N-本他行标志 s t r i n g 1 N 跨行必输（0：本行 1：他行）收款行号 s t r i n g 3 2 Y 可选，联行行号，跨行支付时必录手机号 s t r i n g 1 6 Y 需要发送短信时必输预留字段 1 s t r i n g 1 2 8 Y-预留字段 2 s t r i n g 2 5 6 Y-6.2.6 B T 0 0 6 上 卡 结 果 接 收 接 口6.2.6.1 接 口 参 数 如 表 1 4 所 示。表 1 4 B T 0 0 6 上 卡 结 果 接 收 接 口接口名称 B T 0 0 6 上卡结果接收接口接口访问地址/a p i/b a n k/p a y R e s/r e s u l t F e e d B a c k 接口请求方式 P O S T功能 一卡通平台接收代发银行上卡结果请求参数参数名称 数据类型 可选/必选 说明r e s u l t s t r i n g 必选 上卡结果r e s u l t R e a s o n s t r i n g 必选 上卡结果原因说明a m t S u m n u m b e r 必选 总金额r o w C n t n u m b e r 必选 总笔数s u c A m t n u m b e r 必选 成功金额s u c R o w C n t n u m b e r 必选 成功笔数f i l e N a m e s t r i n g 必选 结果文件名称e x t e n d 1 s t r i n g 可选 预留字段 1e x t e n d 2 s t r i n g 可选 预留字段 2响应参数D B 1 4/T 3 0 2 4 2 0 2 41 2表 1 4 B T 0 0 6 上 卡 结 果 接 收 接 口（续）参数名称 数据类型 可选/必选 说明c o d e s t r i n g 必选 调用结果e r r o r s t r i n g 可选 失败原因6.2.6.2 接 口 说 明 如 下：文 件 说 明：上 卡 结 果 文 件 用 于 存 储 代 发 银 行 上 卡 结 果，其 命 名 方 式 为：接 口 编 码_ C a l l U s e r _ B a n k N o+T o+A r e a C o d e+_+u u i d+.t x t，其 中 u u i d 须 与 补 贴 明 细 文 件 文 件 名 中 的 u u i d一 致；示例：B T 0 0 6 _ 1 5 0 1 5 1 1 0 1 4 3 3 6 _ 1 0 1 0 0 0 0 0 0 0 0 0 T o 1 4 0 0 0 0 0 0 0 0 0 0 _ 8 7 d 6 9 0 8 4 a c 4 8 4 3 2 1 c b 3 e e 6 b 2 1 6 d e c c e 1.t x t。文 件 格 式：字 段 通 过|$分 隔，行 通 过 n 分 隔；文 件 行 数：最 大 1 0 万 笔；文 件 字 段 说 明 如 表 1 5 所 示。表 1 5 上 卡 结 果 文 件 字 段名称 字体类型 最大长度 允许为空 说明明细流水 s t r i n g 1 2 8 N 当前文件唯一姓名/企业名称 s t r i n g 2 5 6 N-证件号码 s t r i n g 3 2 N-补贴金额 n u m b e r 2 0 N 单位：分银行账号 s t r i n g 3 2 N-本他行标志 s t r i n g 1 N 跨行必输（0：本行 1：他行）收款行号 s t r i n g 3 2 Y本行标志为 0 时该字段可为空，他行标志为 1 时该字段必填，字段内容为联行行号手机号 s t r i n g 3 2 Y 需要发送短信时必输代发结果 s t r i n g 1 N 0：失败；1：成功失败错误代码 s t r i n g 3 Y 如表 4 数据返回编码表所示失败描述 s t r i n g 2 5 6 Y 当失败错误代码为 0 0 9 时，此描述不为空预留字段 1 s t r i n g 1 2 8 Y-预留字段 2 s t r i n g 2 5 6 Y-6.2.7 Y H 0 1 1 查 询 银 行 工 作 状 态 接 口接 口 参 数 如 表 1 6 所 示。D B 1 4/T 3 0 2 4 2 0 2 41 3表 1 6 Y H 0 1 1 查 询 银 行 工 作 状 态 接 口接口名称 Y H 0 1 1 查询银行工作状态接口接口访问地址/a p i/b a n k/w o r k S t a t e 接口请求方式 P O S T功能 一卡通平台向银行查询某批次验卡或发放状态请求参数参数名称 数据类型 可选/必选 说明u u i d s t r i n g 必选Y H 0 1 0 批量银行账号验证接口和 Y H 0 0 5 补贴明细接收接口中的数据 u u i dt y p e s t r i n g 必选 接口类型编码，取值为 Y H 0 1 0 或 Y H 0 0 5c a l l U s e r s t r i n g 必选 操作人员编码b a n k N o s t r i n g 必选 银行调用接口的身份账号响应参数参数名称 数据类型 可选/必选 说明c o d e s t r i n g 必选 调用结果r e s C o d e s t r i n g 必选0 0 1 工作状态没有更新（默认）、0 0 2 未开始验卡、0 0 3 验卡审批中、0 0 4 验卡进行中、0 0 5 验卡结束、0 0 6 验卡结果已推送、0 0 7 未启动发放、0 0 8 发放审批中、0 0 9 发放进行中、0 1 0发放结束、0 1 1 发放结果已推送等r e s u l t s t r i n g 可选 备注6.2.8 Y H 0 1 2 获 取 银 行 回 盘 文 件 接 口接 口 参 数 如 表 1 7 所 示。表 1 7 Y H 0 1 2 获 取 银 行 回 盘 文 件 接 口接口名称 Y H 0 1 2 获取银行回盘文件接口接口访问地址/a p i/b a n k/g e n e r a t e F i l e 接口请求方式 P O S T功能 一卡通平台主动向银行获取回盘文件，防止接收数据遗漏，及时发现异常情况请求参数参数名称 数据类型 可选/必选 说明u u i d s t r i n g 必选Y H 0 1 0 批量银行账号验证接口和 Y H 0 0 5 补贴明细接收接口中的数据 u u i dt y p e s t r i n g 必选 接口类型编码，取值为 YH010 或 YH005c a l l U s e r s t r i n g 必选 操作人员编码D B 1 4/T 3 0 2 4 2 0 2 41 4表 1 7 Y H 0 1 2 获 取 银 行 回 盘 文 件 接 口（续）b a n k N o s t r i n g 必选 银行调用接口的身份账号响应参数参数名称 数据类型 可选/必选 说明c o d e s t r i n g 必选 调用结果r e s u l t s t r i n g 可选 备注7 安 全 要 求基 础 策 略7.1.1 网 络 层 采 用 I P 和 端 口 进 行 限 制：采 用 I P 白 名 单 只 允 许 特 定 的 I P 地 址 和 端 口 号 访 问 A P I 接 口，以 防 止 未 授 权 的 访 问 和 攻 击。7.1.2 协 议 层 采 用 H T T P S 传 输 协 议：使 用 H T T P S 协 议 对 数 据 进 行 加 密，并 使 用 S S L 证 书 验 证 服 务 器 身份，以 保 证 数 据 传 输 的 安 全 性。数 据 加 密采 用 S M 4 算 法 对 敏 感 数 据 进 行 加 密，保 障 数 据 安 全。数 据 完 整 性为 了 确 保 数 据 在 传 输 过 程 中 的 完 整 性 和 真 实 性，采 用 以 下 方 式：使 用 H T T P S 协 议：通 过 使 用 H T T P S 协 议，所 有 的 数 据 在 传 输 过 程 中 都 会 被 加 密，防 止 数 据 被窃 取 或 篡 改。确 保 数 据 传 输 的 机 密 性 和 完 整 性；接 口 参 数 约 定：通 过 制 定 接 口 参 数 的 约 定，确 保 数 据 在 传 输 过 程 中 不 被 修 改。定 义 接 口 请 求的 参 数 格 式、数 据 结 构 和 校 验 规 则，确 保 传 输 的 数 据 内 容 符 合 预 期，并 防 止 恶 意 篡 改；使 用 j w t 的 数 字 签 名 算 法：对 数 据 进 行 签 名，确 保 数 据 的 完 整 性 和 真 实 性。通 过 在 数 据 中 添加 数 字 签 名，接 收 方 可 以 验 证 数 据 是 否 在 传 输 过 程 中 被 篡 改。验 证 和 授 权采 用 用 户 名 密 码 进 行 用 户 身 份 验 证，验 证 通 过 后 才 授 权 访 问，确 保 只 有 合 法 用 户 能 够 访 问 A P I 接 口。请 求 限 制在 访 问 A P I 接 口 之 前，必 须 先 进 行 身 份 验 证，获 取 访 问 令 牌（t o k e n），并 在 请 求 中 携 带 该 访 问 令牌，以 确 保 只 有 经 过 身 份 验 证 的 用 户 能 够 访 问 A P I 接 口。其 它 要 求7.6.1 审 计 与 日 志 记 录：记 录 A P I 接 口 的 访 问 日 志 和 请 求 信 息，以 便 追 踪 和 分 析，及 时 发 现 异 常 行 为和 安 全 事 件，并 采 取 相 应 措 施。7.6.2 漏 洞 扫 描 与 安 全 测 试：定 期 对 A P I 接 口 进 行 漏 洞 扫 描 和 安 全 测 试，及 时 发 现 并 修 复 潜 在 的 安 全漏 洞。D B 1 4/T 3 0 2 4 2 0 2 41 57.6.3 更 新 与 升 级：及 时 更 新 A P I 接 口 的 依 赖 库、框 架 和 操 作 系 统 等，修 复 已 知 的 安 全 漏 洞，保 持 系统 的 安 全 性。
展开阅读全文