DB4403∕T 383.4-2023 电子印章 第4部分:应用服务接口(深圳市).pdf
《DB4403∕T 383.4-2023 电子印章 第4部分:应用服务接口(深圳市).pdf》由会员分享,可在线阅读,更多相关《DB4403∕T 383.4-2023 电子印章 第4部分:应用服务接口(深圳市).pdf(50页珍藏版)》请在咨信网上搜索。
1、ICS 35.240.01 CCS L 67 DB4403 深圳市地方标准 DB4403/T 383.42023 电子印章 第 4 部分:应用服务接口 Electronic seal Part 4:Application programming interface 2023-11-02 发布 2023-12-01 实施深圳市市场监督管理局 发布 DB4403/T 383.42023 I 目 次 前言.III 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 应用接口技术要求.1 6 应用接口清单.2 7 基础功能.3 7.1 概述.3 7.2 获取可用印章列表接口.
2、4 7.3 文件格式转换接口.6 8 系统登录.8 8.1 概述.8 8.2 获取扫码登录或签名接口.11 8.3 获取扫码状态接口.13 8.4 获取扫码登录或扫码签名结果接口.14 8.5 USBKey 介质登录或签名接口.16 9 通用签章.16 9.1 概述.16 9.2 生成摘要接口.18 9.3 智能移动终端证书摘要签名接口.22 9.4 USBKey 证书签名接口.22 9.5 服务器密码机证书签名接口.22 9.6 签章合成接口.22 10 验章.24 10.1 概述.24 10.2 已签文件验证接口.25 10.3 印章验证接口.27 11 集中签章.29 11.1 概述.2
3、9 11.2 文件上传接口.32 11.3 签章接口.33 11.4 文件下载接口.36 DB4403/T 383.42023 II附录 A(规范性)电子印章应用服务接口参数编码.38 A.1 证件类型编码.38 A.2 使用场景编码.38 A.3 扫码状态编码.38 附录 B(规范性)电子印章应用服务接口异常信息表.40 附录 C(规范性)电子印章应用服务接口通用数据结构.42 C.1 坐标规则结构.42 C.2 关键字规则结构.42 C.3 骑缝章规则结构.42 参考文献.44 DB4403/T 383.42023 III 前 言 本文件按照 GB/T 1.12020标准化工作导则 第 1
4、 部分:标准化文件的结构和起草规则的规定起草。本文件是 DB4403/T 3832023电子印章的第 4 部分。DB4403/T 3832023 已经发布了以下部分:第 1 部分:通用要求;第 2 部分:数字证书;第 3 部分:业务办理和应用指南;第 4 部分:应用服务接口;第 5 部分:第三方应用接入要求和测试方法;第 6 部分:商事主体电子印章图像;第 7 部分:商事主体电子印章备案。本文件由深圳市政务服务数据管理局提出并归口。本文件起草单位:深圳市政务服务数据管理局、深圳市市场监督管理局、深圳市信息安全管理中心、深圳市标准技术研究院、北京数字认证股份有限公司、平安科技(深圳)有限公司、广
5、州金格数安科技有限公司、北京国脉信安科技有限公司、广东省电子商务认证有限公司、中移动信息技术有限公司。本文件主要起草人:王志勇、肖永舒、李苏、姚逸滨、谢明康、张报建、罗菁春、黄立、董安波、谷鹏、简超、周鑫、刘家雄、饶文刚、林宇群、张雯、周佩雯、穆端端、林雄杰、程小茁、唐先海、何红、杨志强、蒋楠、林少柳、蔡志翔、王惠惠、赖慧诗、俞科、曾勇、陈慧铧、陈胜、周维、李玮。DB4403/T 383.42023 1 电子印章 第 4 部分:应用服务接口 1 范围 本文件规定了深圳市电子印章系统为第三方应用系统提供的应用服务接口的分类、使用方法、参数定义等。本文件适用于党政机关、商事主体以及其他机构对其系统
6、进行改造,以使用户在其系统中使用电子印章。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件。不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 352912017 信息安全技术 智能密码钥匙应用接口规范 GB/T 385402020 信息安全技术 安全电子签章密码技术规范 DB4403/T 383.12023 电子印章 第1部分:通用要求 DB4403/T 383.32023 电子印章 第3部分:业务办理和应用指南 3 术语和定义 DB4403/T 383.12023和DB4403/
7、T 383.32023界定的术语和定义适用于本文件。4 缩略语 下列缩略语适用于本文件。SDK:软件开发工具包(Software Development Kit)HTTP:超文本传输协议(Hyper Text Transfer Protocol)HTTPS:以安全为目标的 HTTP 通道(Hyper Text Transfer Protocol over Secure Socket Layer)JSON:JS对象标记(JavaScript Object Notation)URL:统一资源定位符(Uniform Resource Locator)CA:证书认证机构(certificate aut
8、hority)PDF:可携带文档格式(Portable Document Format)OFD:开放式版式文档(Open Fixed-layout Document)5 应用接口技术要求 DB4403/T 383.42023 2 应用接口按照HTTPS方式访问,采用UTF-8编码,通过HTTPS协议的POST/GET方法提交请求,报文内容采用SM4 CBC加密,接口专用参数通过请求正文,按照JSON格式封装提供。6 应用接口清单 应用接口清单见表1。表1 应用接口清单 分类编号 分类 接口编号 接口名称 函数 接口说明 01 基础 功能 BASISFUN-01 获取可用印章列表 genGetS
9、ealInfoList 获取可用电子印章图像数据。BASISFUN-02 文件格式转换 genFormatFile 将word、excel、html等不同格式电子文档,统一转换为PDF或OFD格式。02 系统 登录 LOGIN-01 获取扫码登录或签名 genGetLoginQRCode 获取扫码登录或扫码签名的二维码,然后使用移动端应用程序扫描,完成登录确认或签名确认。LOGIN-02 获取扫码状态 genGetScanStatusById 获取用户在电子印章系统的移动端应用程序扫码时的操作状态。LOGIN-03 获取扫码登录或扫码签名结果 genGetTaskResult 获取在电子印章系
10、统的移动端应用程序扫码登录或扫码签名的结果。LOGIN-04 USBKey介质登录或签名 与GB/T 352912017的规定保持一致 使用USBKey介质进行授权登录或签名。03 通用 签章 GENSIGN-01 生成摘要 genCalculateFileHash 生成待签章文件的摘要信息。GENSIGN-02 智能移动终端证书摘要签名 与 LOGIN-01接口一致 调用智能移动终端证书对摘要进行签名。GENSIGN-03 USBKey证书摘要签名 与GB/T 352912017的规定保持一致 调用USBKey证书对摘要进行签名。GENSIGN-04 服务器密码机证书摘要签名 与GB/T 3
11、52912017的规定保持一致 调用服务器密码机证书对摘要进行签名。GENSIGN-05 签章合成 genDetachedFile 使用时间戳、加密加签等处理方式,合成签章文件。04 验章 VERIFY-01 已签文件验证 genFileVerify 对已签署文件进行验证,包含验证时间戳、已签文档中某个电子印章或数字签名的有效性、已签文档中某个电子印章或数字签名所签署内容是否被篡改,以及已签文档中所有电子印章或数字签名的签章记录。VERIFY-02 印章验证 genRecognizeRegionalsSeal 验证印章编码、印章类型、发放单位、发放时间等信息。DB4403/T 383.4202
12、3 3 表 1(续)7 基础功能 7.1 概述 基础功能部分包含以下两个接口:获取可用印章列表接口:输入印章类型、注册授权码、统一社会信用代码、第三方应用系统编号等请求参数,返回用户可用电子印章图像数据。使用流程见图1;文件格式转换接口:输入word、excel、html等不同格式电子文档,返回PDF或OFD格式文件。使用流程见图2。第三方应用系统/用户SDK1、准备参数2、调用接口API-SEAL-BASISFUN-019、响应输出结果3、校验接口入参10、解析输出参数,完成接口调用深圳统一电子印章管理平台5、校验接口入参,获取数据,组装输出参数6、记录调用日志4、调用平台接口获取信息7、响
13、应输出结果8、重新封装输出参数图 1 获取可用印章列表流程分类编号 分类 接口编号 接口名称 函数 接口说明 05 集中 签章 CENTRALIZED-01 文件上传 genFileUplode 上传PDF或OFD格式待签章文件。CENTRALIZED-02 签章 genCentralizedSignature 查询可用印章接口,获取用户ID和印章编码信息,传入文件数据和签章位置参数,完成签章操作。CENTRALIZED-03 文件下载 genFileDownload 下载已签章文件。DB4403/T 383.42023 4 第三方应用系统/用户SDK1、准备参数2、调用接口API-SEAL-
14、BASISFUN-029、响应输出结果3、校验接口入参4、文件格式识别及转换处理10、解析输出参数,完成接口调用深圳统一电子印章管理平台6、记录调用日志5、调用平台接口7、响应输出结果8、重新封装输出参数图 2 文件格式转换流程7.2 获取可用印章列表接口 7.2.1 请求参数说明 获取可用印章列表接口请求参数说明见表2,请求参数样例见示例。表2 获取可用印章列表接口请求参数说明 参数编码 描述 类型 是否 可空 是否 唯一 备注 reqId 请求流水号 String 否 是 UUID appKey 传输数据加密密钥编号 String 是 是 非空:数据已加密 空:数据未加密 bsign 签名
15、 String 否 是 数据完整性验证标记 DB4403/T 383.42023 5 表 2(续)参数编码 描述 类型 是否 可空 是否 唯一 备注 content grantCode 注册授权码 String 否 是 用户被授权时获取的注册授权码 organizationCode 统一社会信用代码 String 否 是 电子印章所属用户的统一社会信用代码 systemID 第三方应用系统编号 String 否 是 用户在电子印章系统注册的系统编号 sealType 印章类型 String 否 是 印章类型应符合DB4403/T 383.12023中 4.2 的要求。参数格式:输入欲查询印章类
16、型编码,可查询一个或多个印章类型是否可用。示例:单个印章:1 多个印章:1|2|3|4 idCardMark 商事主体数据准确性验标记 String 否 是 对商事主体法定代表人或负责人证件类型+证件号组合计算的摘要值。证件类型应符合表A.1的要求 示例:请求参数样例JSON格式。reqId:17497dc4-9c7f-477d-8faa-1d37e2f2ca13,appKey:472b6491a5b04ca2ac140218215f80ba,bsign:FFW/OV9s5EBLtjAfvhLownl0MxUQTx1URasnJRhU/IU=,content:grantCode:f9eb06a
17、1498c418594d5864ccd359842,organizationCode:91440300000000166W,systemID:CIS2021-7-27,sealType:1|2|3|4,idCardMark:g9kk06a1498c418594d5864rrrr359842 7.2.2 返回参数说明 获取可用印章列表接口返回参数见表3,返回参数样例见示例。DB4403/T 383.42023 6 表3 获取可用印章列表接口返回参数说明 参数编码 描述 类型 是否 可空 是否 唯一 备注 reqId 请求流水号 String 否 是 来源于入参请求 ID code 返回代码 St
18、ring 否 是 应符合表 B.1 的要求 msg 返回消息 String 否 是 应符合表 B.1 的要求 appKey 传输数据加密密钥编号 String 否 是 非空:数据已加密 空:数据未加密 asign 签名值 String 否 是 数据完整性验证 data sealList 印章列表 String 否 是 JSON Array 格式 sealType 印章类型 String 否 是 印章类型应符合 DB4403/T 383.12023 中 4.2 的要求 sealImg 印章样章图片 String 否 是 Base64 格式 sealStatus 可用状态 String 否 是 Y
19、:可用 N:不可用 示例:返回参数样例JSON格式。reqId:17497dc4-9c7f-477d-8faa-1d37e2f2ca13,code:T000000,msg:操作成功,appKey:472b6491a5b04ca2ac140218215f80ba,asign:YYcCHlUJqZz1X6OGc1Zj2HPCoBOR6IR476Xm/gMboEs=,data:sealDataList:sealType:1 sealImg:KzPIcWdA1A73DCNG1X4OBxfIUtnaDEwAev0kHyRageYzQT9Xp/+jYJ5f.,sealStatus:Y 7.3 文件格式转换
20、接口 7.3.1 请求参数说明 文件格式转换接口请求参数说明见表4,请求参数样例见示例。DB4403/T 383.42023 7 表4 文件格式转换接口请求参数说明 参数编码 描述 类型 是否 可空 是否 唯一 备注 reqId 请求流水号 String 否 是 UUID appKey 传输数据加密密钥编号 String 是 是 非空:数据已加密 空:数据未加密 bsign 签名 String 否 是 数据完整性验证标记 content sourceFileType 输入文件类型 String 是 是 word、excel、html 等文件格式 fileB64 输入文件的 Base64 格式
21、String 是 是-destFileType 输出文件类型 String 是 是 可选格式:PDF、OFD 示例:请求参数样例JSON格式。reqId:17497dc4-9c7f-477d-8faa-1d37e2f2ca13,appKey:472b6491a5b04ca2ac140218215f80ba,bsign:FFW/OV9s5EBLtjAfvhLownl0MxUQTx1URasnJRhU/IU=,content:sourceFileType:word,fileB64:4suE+ZKxq/m+HFM0qvEeDSRQmNXg6ChSkRrE0FLj6p75+weS/2mytb7HH17
22、FsEPlr/ey.,destFileType:OFD 7.3.2 返回参数说明 文件格式转换接口返回参数说明见表5,返回参数样例见示例。表5 文件格式转换接口返回参数说明 参数编码 描述 类型 是否 可空 是否 唯一 备注 reqId 唯一请求 ID String 否 是 来源于入参请求 ID code 返回代码 String 否 是 应符合表 B.1 的要求 msg 返回消息 String 否 是 应符合表 B.1 的要求 appKey 传输数据加密密钥编号 String 是 是 非空:数据已加密 空:数据未加密 asign 签名值 String 否 是-data destfileB64
23、输出文件 Base64 格式 String 否 是-destFileType 输出文件类型 String 否 是 可选格式:PDF、OFD DB4403/T 383.42023 8 示例:返回参数样例JSON格式。reqId:17497dc4-9c7f-477d-8faa-1d37e2f2ca13,code:T000000,msg:成功,appKey:472b6491a5b04ca2ac140218215f80ba,asign:YYcCHlUJqZz1X6OGc1Zj2HPCoBOR6IR476Xm/gMboEs=,data:destfileB64:4suE+ZKxq/m+HFM0qvEeDS
24、RQmNT1WgjqbeerXg6ChSkRrE0lZbxPbFL.,destFileType:OFD 8 系统登录 8.1 概述 系统登录部分包含以下4个接口:获取扫码登录或签名接口:输入使用场景编码、注册授权码、第三方应用系统编号等参数,经过验证后,返回任务ID、二维码的字符串等参数。使用流程见图3;获取扫码状态接口:输入注册授权码、第三方应用系统ID、任务ID等请求参数,返回用户在电子印章系统的移动端应用程序的扫码状态。使用流程见图4;获取扫码登录或扫码签名结果接口:输入注册授权码、第三方应用系统ID、任务ID请求参数,调用本接口,如果是登录,则返回登录人姓名、登录人所属统一社会信用代码
25、、印章类型等信息;如是扫码签名,则返回签名值。使用流程见图5;USBKey介质登录或签名接口:与GB/T 352912017的规定保持一致。DB4403/T 383.42023 9 第三方应用系统/用户SDK1、准备参数2、调用接口API-SEAL-LOGIN-019、响应输出结果3、校验接口入参10、解析输出参数,完成接口调用深圳统一电子印章管理平台5、获取数据,组装输出参数6、记录调用日志4、调用平台接口7、响应输出结果8、重新封装输出参数图 3 获取扫码登录或签名流程DB4403/T 383.42023 10 第三方应用系统/用户SDK1、准备参数2、调用接口API-SEAL-LOGIN
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB4403T 383.4-2023 电子印章 第4部分:应用服务接口深圳市 DB4403 383.4 2023 电子 印章 部分 应用服务 接口 深圳市
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。