DB23 ICS 35.240.01 CCS L 67 黑 DB23/T 2838-2021 龙 江 省 地 方 标 准 DB23/T 2838-2021 黑龙江“全省事”依申请类政务服务应用 接入规范 2021 - 04- 13 发布 黑龙江省市场监督管理局 2021 - 05 - 12 实施 发 布 DB23/T 2838-2021 前 言 本文件按照GB/T 1.1-2020给出的规则起草。 本文件由黑龙江省营商环境建设监督局提出并归口。 本文件主要起草单位：黑龙江省营商环境建设监督局、黑龙江省政务大数据中心、黑龙江省标准化 研究院、哈尔滨工业大学软件工程股份有限公司。 本文件主要起草人：高占亮、卫柏吟、王林林、刘禹、王生瑶、姜娜、邰宇、黄鹤、张刚、郑志含、 陈要武、杨大志、吕猛、王磊、李严、王艳君。 I DB23/T 2838-2021 黑龙江“全省事”依申请类政务服务应用接入规范 1 范围 本文件规定了黑龙江“全省事”依申请类政务服务应用接入的通用要求，描述了接入流程、接入安 全、接口规范、界面视觉等。 本文件适用于在黑龙江省移动政务服务系统建设过程中指导省内各级部门开展接入工作。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 ZWFW C 0115-2019 国家政务服务平台安全接入检测要求 DB23/T 2837-2021 黑龙江“全省事”移动政务服务平台总体规范 3 术语和定义 DB23/T 2837-2021界定的术语和定义适用于本文件。 4 缩略语 下列缩略语适用于本文件。 APP （Application） 应用程序 HTTP （Hyper Text Transfer Protocol） 超文本传输协议 Json （JavaScript Object Notation） 基于JavaScript语法子集的开放标准数据交换格式 px （Pixel） 像素图像的最小单位 UI （User Interface） 用户界面 AES （Advanced Encryption Standard） 高级加密标准 5 5.1 接入总体要求 工作原则 黑龙江“全省事”依申请类政务服务资源接入以“统一界面、统一接口、统一数据、统一监管”为 原则，主要完成六种依申请类政务服务事项在线办理应用对接工作。 5.2 接入范围 省内各级部门办理依申请六类政务服务事项的相关应用。 1 DB23/T 2838-2021 6 接入流程 6.1 接入要求 接入需符合以下要求： a) 统一标准流程，应按照本文件 5.2 中要求的流程进行接入； b) 统一接口规范，依申请事项办件应按照本文件中第 8 章进行开发； c) 统一界面风格，应参照本文件中第 9 章进行设计，实现界面风格统一； d) 统一用户对接，如涉及用户信息对接，应统一接入互联网统一身份认证系统，实现用户信息统 一管理。 6.2 接入流程 6.2.1 接入步骤 黑龙江“全省事”依申请政务服务应用接入需要做的工作如下： a) 对接互联网统一身份认证系统； b) 将依申请六类政务服务事项、网办地址等内容录入省级政务服务事项管理系统； c) 依申请六类政务服务事项所属系统按相关标准升级改造； d) 将政务服务事项办件数据由各业务系统按照省级政务服务平台相关要求推送到省级政务服务 数据共享交换系统，省直部门根据格式要求直接推送到省级政务服务数据共享交换系统，市地 及以下业务系统办件数据应统一汇聚至市地，再由市地根据格式要求推送到省级政务服务数据 共享交换系统； e) 根据本文件第 8 章中要求提供接口，用于黑龙江“全省事”移动政务服务平台调取办件数据； f) 对接政务服务好差评系统。 6.2.2 详细流程 省内各级部门办理依申请六类政务服务事项的相关应用，在接入黑龙江“全省事”移动政务服务平 台时，应按照接入步骤进行，具体流程见图1。 2 DB23/T 2838-2021 图1 7 依申请六类应用接入黑龙江“全省事”移动政务服务平台流程图 接入安全要求 与黑龙江“全省事”移动政务服务平台对接的业务信息系统，要按照 ZWFW C 0115-2019 中完成相 应的等级保护，并且不可自行更改接入的外部链接系统地址及相关功能。 8 依申请事项办件接口规范 3 DB23/T 2838-2021 8.1 使用场景 办件接口，黑龙江“全省事”用户登陆后在“我的办件”中根据登陆身份展示我的办件数据，接口 应使用Http Post方式请求，用Json作为传输数据格式。 8.2 接口安全要求 办件接口传输过程中应对传输数据进行加密，所需要的加密解密模块和密钥由黑龙江省营商环境建 设监督局提供。 8.3 办件列表接口 根据个人用户的身份证号或法人用户的统一社会信用代码获取用户办件列表，接口参数应符合附录 A.1中要求。 8.4 办件详情接口 根据办件列表中返回的办件编号，查询办件的详细信息，接口参数应符合附录A.2中要求。 8.5 办件撤销或删除接口 根据办件列表中的编号进行实时操作，接口参数应符合附录A.3中要求。 9 9.1 界面视觉要求 申请界面样式要求 分辨率：采用响应式界面设计在分辨率不低于360px*640px的情况下自适应。 标题栏：字号17px，文字颜色#333333，背景色#FFFFFF，高度54px，宽度自适应。 事项标题文字：字号17px，颜色#FFFFFF，高度70px，宽度自适应。 分类标题：字号16px粗体，颜色#333333，高度19px，宽度320px。 分类间距：12px。 暂存按钮：宽度52px，高度26px，背景色#4366A8，字号14px，颜色#FFFFFF。 提交按钮：宽度220px，高度38px，背景色#4366A8，字号14px，颜色#FFFFFF。 输入框：单行高度49px，字号17px，背景色#FFFFFF。 申请界面样式要求可参考图2。 4 DB23/T 2838-2021 图2 申请界面样式要求 5 DB23/T 2838-2021 9.2 完成申请界面样式要求 分辨率：采用响应式界面设计在分辨率不低于360px*640px的情况下自适应，推荐宽度400px。 标题栏：字号17px，文字颜色#333333，背景色#FFFFFF，高度54px，宽度自适应。 事项标题文字：字号17px，颜色#FFFFFF，高度70px，宽度自适应。 消息描述文字：字号14px，颜色#333333，高度自适应，宽度375px。 表格框间距：12px。 操作按钮：宽度52px，高度26px，背景色#4366A8，字号14px，颜色#FFFFFF。 结果表格：单行高度32px，表头宽度119px，表头背景色#F1F5FF，字号17px，内容宽度256px，背 景色#FFFFFF。 应用二维码：表格高度136px，背景色#FFFFFF，二维码图片宽高均为120px。 完成申请界面样式要求可参考图3。 图3 6 完成申请界面样式要求 DB23/T 2838-2021 A 附 录 A （规范性） 依申请事项办件接口规范 A.1 办件列表接口 A.1.1 请求参数格式要求 A.1.1.1 根据个人用户的身份证号或法人用户的统一社会信用代码获取用户办件列表。接口请求参数 的相关信息见表A.1和A.2。所有字段命名遵循小驼峰式命名规则，第一个单词是全部字母小写，后面的 单词首字母大写。 表 A.1 请求参数 参数名称 类型 参数说明 data JsonObject 请求数据对象 表 A.2 是否必填 是 data 参数中的请求数据 参数名称 类型 cardId String userType Integer state Integer page Integer 请求的页码，从 0 开始 是 pageCount Integer 每页多少条 是 A.1.1.2 参数说明 个人用户的身份证号或法人用户的统一社 会信用代码 ,需要 AES 加密。密钥单独分发 类型：1 个人 、2 法人。 办理状态（0 全部、1 未提交、2 预受理、3 办理中、4 已办结） 是否必填 是 是 是 办件列表接口调用请求参数使用见示例。 示例： { "data": { "cardId": "XXXXX", "userType":1, "state":1, "page": 0, "pageCount": 20 } } A.1.2 返回数据格式要求 A.1.2.1 返回数据整体使用AES加密，需提供密钥。返回数据相关信息见表A.3和A.4。所有字段命名遵 循小驼峰式命名规则，第一个单词是全部字母小写，后面的单词首字母大写。 7 DB23/T 2838-2021 表 A.3 返回参数 名称 类型 code Int message String 参数说明 请求是否成功标识，默认 1 为成功，其他为失败，可为请求失败自 定义错误码 请求描述，若成功可为空，也可设置为“请求成功”；若失败需返 回错误原因，并且该原因是用于显示给用户查看的，不可返回代码 错误 data JsonObject 具体的返回数据 表 A.4 data 返回参数 参数名称 类型 参数说明 projectNo String 办件编号 是 taskName String 事项名称(办件名称) 是 cardId String 申请人证件号码(身份证或统一信用代码) 是 applyDate String 申请时间(申报时间) 是 orgName String 受理部门 是 acceptDate String 受理日期 applyerName String 申报人/单位 是 resultExplain String 办理结果说明，仅办结情况下有 否 results Integer 办理结论(1 通过\0 不通过) ，仅办结情况下有 否 state Integer 办理状态（1 未提交、2 预受理、3 办理中、4 已办结） 是 dataSource String 数据来源 是 操作情形参数（operStates） optionName String 操作名字，用于展示在按钮上 是否必填 未受理状态 可为空 是 是 app 操作 url，操作按钮点击