DB4403-T 383.4-2023 電子印章 第4部分：應(yīng)用服務(wù)接口

67

DB4403

電子印章

部分：應(yīng)用服務(wù)接口

深圳市市場監(jiān)督管理局發(fā)布DB4403/T

目次前言

...............................................................................

范圍

..............................................................................

規(guī)范性引用文件

....................................................................

........................................................................

縮略語

............................................................................

應(yīng)用接口技術(shù)要求

..................................................................

......................................................................

基礎(chǔ)功能

..........................................................................

概述

..........................................................................

7.2

..........................................................

7.3

文件格式轉(zhuǎn)換接口

..............................................................

系統(tǒng)登錄

..........................................................................

概述

..........................................................................

8.2

.......................................................

118.3

獲取掃碼狀態(tài)接口

.............................................................

138.4

...............................................

14

.....................................................

16

通用簽章

.........................................................................

16 概述

.........................................................................

169.2

生成摘要接口

.................................................................

189.3

.................................................

22

...........................................................

229.5

.....................................................

229.6

簽章合成接口

.................................................................

2210

驗章

.............................................................................

2410.1

概述

........................................................................

2410.2

已簽文件驗證接口

............................................................

2510.3

印章驗證接口

................................................................

2711

集中簽章

.........................................................................

2911.1

概述

........................................................................

2911.2

文件上傳接口

................................................................

3211.3

....................................................................

3311.4

文件下載接口

................................................................

36DB4403/T

附錄

.......................................

38A.1

證件類型編碼

.................................................................

38A.2

使用場景編碼

.................................................................

38A.3

掃碼狀態(tài)編碼

.................................................................

38附錄

.....................................

40附錄

...................................

42C.1

坐標(biāo)規(guī)則結(jié)構(gòu)

.................................................................

42C.2

關(guān)鍵字規(guī)則結(jié)構(gòu)

...............................................................

42C.3

騎縫章規(guī)則結(jié)構(gòu)

...............................................................

42參考文獻(xiàn)

............................................................................

44IIDB4403/T

前 言

本文件是

DB4403/T

本文件主要起草人：王志勇、肖永舒、李蘇、姚逸濱、謝明康、張報建、羅菁春、黃立、董安波、DB4403/T

電子印章第

4

35291—2017

38540—2020

DB4403/T

Transfer

Protocol）

HTTP

Text

Layer）

Notation）

Document）

DB4403/T

應(yīng)用接口按照HTTPS方式訪問，采用UTF-8編碼，通過HTTPS協(xié)議的POST/GET方法提交請求，報文內(nèi)容采用SM4

應(yīng)用接口清單見表1。

DB4403/T

7.1

號等請求參數(shù)，返回用戶可用電子印章圖像數(shù)據(jù)。使用流程見圖1；——文件格式轉(zhuǎn)換接口：輸入word、excel、html等不同格式電子文檔，返回PDF或OFD格式文件。使用流程見圖2。第三方應(yīng)用系統(tǒng)/用戶SDK深圳統(tǒng)一電子印章管理平臺1、準(zhǔn)備參數(shù)2、調(diào)用接口API-SEAL-BASISFUN-013、校驗接口入?yún)?、調(diào)用平臺接口獲取信息5、校驗接口入?yún)ⅲ@取數(shù)據(jù)，組裝輸出參數(shù)6、記錄調(diào)用日志7、響應(yīng)輸出結(jié)果8、重新封裝輸出參數(shù)9、響應(yīng)輸出結(jié)果10、解析輸出參數(shù)，完成接口調(diào)用

獲取可用印章列表流程DB4403/T

文件格式轉(zhuǎn)換流程

的要求。DB4403/T

[{

DB4403/T

",

[{

sealImg"："

}]}]

DB4403/T

"appKey"："

"，"content":

[{

",

4suE+ZKxq/m+HFM0qvEeDSRQmNXg6ChSkRrE0FLj6p75+weS/2mytb7HH17FsEPlr/ey......

"，

OFD"

DB4403/T

"msg

":"成功",

"，"data":{

過驗證后，返回任務(wù)ID、二維碼的字符串等參數(shù)。使用流程見圖3；——獲取掃碼登錄或掃碼簽名結(jié)果接口：輸入注冊授權(quán)碼、第三方應(yīng)用系統(tǒng)ID、任務(wù)ID請求參數(shù)，息；如是掃碼簽名，則返回簽名值。使用流程見圖5；

第三方應(yīng)用系統(tǒng)/用戶SDK1、準(zhǔn)備參數(shù)3、校驗接口入?yún)?、重新封裝輸出參數(shù)

DB4403/T

深圳統(tǒng)一電子印章管理平臺4、調(diào)用平臺接口5、獲取數(shù)據(jù)，組裝輸出參數(shù)6、記錄調(diào)用日志7、響應(yīng)輸出結(jié)果9、響應(yīng)輸出結(jié)果10、解析輸出參數(shù)，完成接口調(diào)用

獲取掃碼登錄或簽名流程DB4403/T

第三方應(yīng)用系統(tǒng)/用戶SDK1、準(zhǔn)備參數(shù)3、校驗接口入?yún)?、重新封裝輸出參數(shù)

深圳統(tǒng)一電子印章管理平臺4、調(diào)用平臺接口5、獲取數(shù)據(jù)，組裝輸出參數(shù)6、記錄調(diào)用日志7、響應(yīng)輸出結(jié)果9、響應(yīng)輸出結(jié)果10、解析輸出參數(shù)，完成接口調(diào)用

獲取掃碼狀態(tài)流程第三方應(yīng)用系統(tǒng)/用戶 SDK1、準(zhǔn)備參數(shù)3、校驗接口入?yún)?、重新封裝輸出參數(shù)

DB4403/T

深圳統(tǒng)一電子印章管理平臺4、調(diào)用平臺接口5、獲取數(shù)據(jù)，組裝輸出參數(shù)6、記錄調(diào)用日志7、響應(yīng)輸出結(jié)果9、響應(yīng)輸出結(jié)果10、解析輸出參數(shù)，完成接口調(diào)用圖

5

獲取掃碼登錄或掃碼簽名結(jié)果流程

DB4403/T

"appKey"："

"，"bsign"："

[{

"，

","scene"："01"，

}]

DB4403/T

"signTaskId"："

"qrCode"："

}]

"appKey"：""，

[{"，

"，

}]

DB4403/T

"appKey"："

"，

獲取掃碼登錄或掃碼簽名結(jié)果接口請求參數(shù)說明見表10，請求參數(shù)樣例見示例。

DB4403/T

"appKey"："

"，"，

[{

"，

"，

獲取掃碼登錄或掃碼簽名結(jié)果接口返回參數(shù)說明見表11，返回參數(shù)樣例見示例。 "msg

"appKey"："

"data":{

",

DB4403/T

——智能移動終端證書摘要簽名接口：與

——USBKey證書摘要簽名接口：與GB/T

件。使用流程見圖8。圖

6

通用簽章接口調(diào)用順序

DB4403/T

圖

7

DB4403/T

文件轉(zhuǎn)

的要求

fileStr

的要求DB4403/T

時，填寫

USBKey

USBKey

DB4403/T

12"appKey"："

"，"，

"，

"，

"，

[{

DB4403/T

"searchType"："

"，"ukeyNo"："

"ukeyProvider"："

}]

"appKey"："

"，

[{

"：[{

"，

}]

個，單個

以內(nèi)；

DB4403/T

應(yīng)與GB/T

應(yīng)與GB/T

格式

DB4403/T

"appKey"："

"，"，

[{

"，

"，

"，

"："01"，

}]

"appKey"："

"，

"：[{DB4403/T

}]

10.1 概述章簽發(fā)單位等。使用流程見圖9；——印章驗證接口：輸入印章結(jié)構(gòu)體請求參數(shù)，返回印章的驗證信息，包括印章編碼、印章類型、發(fā)放單位、發(fā)放時間等。使用流程見圖10。第三方應(yīng)用系統(tǒng)/用戶SDK

已簽文件驗證流程

格式

OFD第三方應(yīng)用系統(tǒng)/用戶SDK

DB4403/T

深圳統(tǒng)一電子印章管理平臺1、準(zhǔn)備參數(shù)2、調(diào)用接口API-SEAL-VERIFY-013、校驗接口入?yún)?、解析待驗證文檔5、分析解析數(shù)據(jù)，如簽名有效性電子印章數(shù)據(jù)、時間戳、電子簽名等6、調(diào)用平臺接口7、校驗用戶身份及權(quán)限8、獲取平臺簽發(fā)和印章相關(guān)信息9、組裝返回參數(shù)，記錄調(diào)用日志11、解析響應(yīng)參數(shù)，獲取印章信息13、響應(yīng)輸出結(jié)果14、解析輸出參數(shù)，完成接口調(diào)用

加密）

DB4403/T

"appKey"："

"，"，

DB4403/T

17

"appKey"："

"asign"："

"，

"公章",

"version":

}]

DB4403/T

"appKey"：""，

{DB4403/T

61a5d847-8697-4b17-a2f5-b35851370ecb

","code":"T000000

","msg

"，"data":

"

sealCode"："20220702369865452545"，"

sealType"："1"，"

sealIssueUnit"："北京"，"

"

sealValidStart"："2022-07-02"，"

sealValidEnd"："2023-07-01"，"

sealStatus"："0"，"

sealInval