ICS35.240.99

CCSL67

37

山東省地方標(biāo)準(zhǔn)

DB37/T4563—2022

電子印章系統(tǒng)接入規(guī)范

Accessspecificationsoftheelectronicsealsystem

2022-11-30發(fā)布2022-12-30實施

山東省市場監(jiān)督管理局發(fā)布

DB37/T4563—2022

目次

前言III

1范圍1

2規(guī)范性引用文件1

3術(shù)語和定義1

4縮略語1

5概述1

5.1接入架構(gòu)2

5.2系統(tǒng)組成2

6接入流程2

6.1總體流程2

6.2接入申請2

6.3接入審核3

6.4接入測試3

6.5正式接入3

7接入接口3

7.1電子印章應(yīng)用系統(tǒng)接入3

7.2業(yè)務(wù)系統(tǒng)接入3

附錄A（資料性）接入申請表5

A.1電子印章應(yīng)用系統(tǒng)接入申請表5

A.2業(yè)務(wù)系統(tǒng)接入申請表6

附錄B（規(guī)范性）電子印章應(yīng)用系統(tǒng)接入接口說明7

B.1獲取公鑰接口7

B.2加密密鑰對導(dǎo)入接口7

B.3電子文件寫入接口8

B.4文件解密加密接口9

B.5電子印章狀態(tài)查詢接口10

附錄C（規(guī)范性）業(yè)務(wù)系統(tǒng)接入接口信息12

C.1PDF位置簽章接口12

C.2PDF騎縫章簽章接口13

C.3OFD位置簽章接口13

C.4OFD騎縫章簽章接口14

C.5電子文件驗簽接口信息15

C.6鎖定簽名接口16

C.7刪除鎖定簽名接口17

C.8簽章并鎖定簽名接口18

C.9加注并鎖定簽名接口信息19

C.10電子證照簽章驗簽接口信息19

I

DB37/T4563—2022

參考文獻(xiàn)21

II

DB37/T4563—2022

前言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔(dān)識別專利的責(zé)任。

本文件由山東省大數(shù)據(jù)局提出、歸口并組織實施。

III

DB37/T4563—2022

電子印章系統(tǒng)接入規(guī)范

1范圍

本文件規(guī)定了省電子印章系統(tǒng)接入架構(gòu)、系統(tǒng)組成、接入流程和接入接口要求。

本文件適用于省級/市級部門電子印章應(yīng)用系統(tǒng)、業(yè)務(wù)系統(tǒng)接入省電子印章系統(tǒng)。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時間表示法

GB/T33190—2016電子文件存儲與交換格式版式文檔

GM/T0016—2012智能密碼鑰匙密碼應(yīng)用接口規(guī)范

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

電子印章electronicseal

一種由制作者簽名的包括持有者信息和圖形化內(nèi)容的數(shù)據(jù)，可用于簽署電子文件。

[來源：GB/T33481—2016，3.4]

3.2

電子印章系統(tǒng)electronicsealsystem

支持電子印章（3.1）制作、管理、使用和驗證等過程的系統(tǒng)的統(tǒng)稱。

[來源：GB/T33481—2016，3.5]

3.3

數(shù)字證書digitalcertificate

用戶的公鑰連同其他信息，并由發(fā)布該證書的證書認(rèn)證機構(gòu)的私鑰進行加密使其不可偽造。

[來源：GB/T33481—2016，3.2]

4縮略語

下列縮略語適用于本文件。

CA：數(shù)字證書頒發(fā)機構(gòu)（CertificateAuthority）

OFD：開放版式文檔（OpenFixedLayoutDocument）

PDF：可移植文檔格式（PortableDocumentFormat）

5概述

1

DB37/T4563—2022

5.1接入架構(gòu)

電子印章系統(tǒng)接入架構(gòu)包括國家政務(wù)服務(wù)平臺電子印章系統(tǒng)、省電子印章系統(tǒng)和接入部門系統(tǒng)，電

子印章系統(tǒng)接入架構(gòu)見圖1。省電子印章系統(tǒng)包括電子印章制作系統(tǒng)、電子印章狀態(tài)發(fā)布系統(tǒng)、電子印

章應(yīng)用系統(tǒng)，接入部門系統(tǒng)包括省級/市級部門電子印章應(yīng)用系統(tǒng)、業(yè)務(wù)系統(tǒng)。

圖1接入架構(gòu)

5.2系統(tǒng)組成

省電子印章系統(tǒng)各組成部分基本功能包括但不限于：

a)電子印章制作系統(tǒng)：應(yīng)提供電子印章申請、制作、備案、注銷等功能；

b)電子印章狀態(tài)發(fā)布系統(tǒng)：應(yīng)提供電子印章狀態(tài)發(fā)布、查詢、下載等功能；

c)電子印章應(yīng)用系統(tǒng)：應(yīng)提供電子印章簽章、驗章等功能，支持對PDF和OFD格式的版式文件

進行簽章和驗章。

6接入流程

6.1總體流程

電子印章系統(tǒng)接入總流程見圖2。

圖2總流程

6.2接入申請

2

DB37/T4563—2022

接入部門電子印章應(yīng)用系統(tǒng)申請接入省電子印章系統(tǒng)（附錄A）的，應(yīng)向省電子印章系統(tǒng)主管部門

提交電子印章應(yīng)用系統(tǒng)接入申請表，申請表見表A.1。接入部門業(yè)務(wù)系統(tǒng)申請接入省電子印章系統(tǒng)的，

應(yīng)向省電子印章系統(tǒng)主管部門提交業(yè)務(wù)系統(tǒng)接入申請表，申請表見表A.2。

6.3接入審核

省電子印章系統(tǒng)主管部門應(yīng)對接入部門提交的接入申請進行審核，審核通過后，開通省電子印章系

統(tǒng)接入測試接口權(quán)限。

6.4接入測試

接入部門應(yīng)按照接入接口技術(shù)要求對接入部門電子印章應(yīng)用系統(tǒng)、業(yè)務(wù)系統(tǒng)進行升級開發(fā)，在測試

環(huán)境下與省電子印章系統(tǒng)進行接入聯(lián)調(diào)。

6.5正式接入

聯(lián)調(diào)測試通過后，省電子印章系統(tǒng)主管部門為接入部門開通正式環(huán)境下的接口權(quán)限，接入部門電子

印章應(yīng)用系統(tǒng)、業(yè)務(wù)系統(tǒng)正式接入省電子印章系統(tǒng)，測試接口權(quán)限關(guān)閉。

7接入接口

7.1電子印章應(yīng)用系統(tǒng)接入

接入部門電子印章應(yīng)用系統(tǒng)接入省電子印章系統(tǒng)的接口包括電子印章證書管理、電子印章集中式用

章、電子印章狀態(tài)查詢等，接口目錄見表1。各接口功能描述、接口方式、輸入/輸出參數(shù)等接口說明應(yīng)

符合附錄B的相關(guān)規(guī)定。

表1電子印章應(yīng)用系統(tǒng)接入接口目錄

序號分類名稱

1獲取簽名公鑰接口

2電子印章證書管理加密密鑰對導(dǎo)入接口

3電子文件寫入接口

4電子印章集中式用章電子文件解密加密接口

5電子印章狀態(tài)查詢電子印章狀態(tài)查詢接口

7.2業(yè)務(wù)系統(tǒng)接入

接入部門業(yè)務(wù)系統(tǒng)接入省電子印章系統(tǒng)的接口包括電子文件簽章、電子文件驗簽、電子證照簽章、

電子證照簽章驗簽等，接口目錄見表2。各接口功能描述、接口方式、輸入/輸出參數(shù)等接口說明應(yīng)符合

附錄C的相關(guān)規(guī)定。

表2業(yè)務(wù)系統(tǒng)接入接口目錄

序號分類名稱

1PDF位置簽章接口

2PDF騎縫章簽章接口

電子文件簽章

3OFD位置簽章接口

4OFD騎縫章簽章接口

3

DB37/T4563—2022

表2業(yè)務(wù)系統(tǒng)接入接口目錄（續(xù)）

序號分類名稱

5電子文件驗簽電子文件驗簽接口

6鎖定簽名接口

7刪除鎖定簽名接口

電子證照簽章

8簽章并鎖定簽名接口

9加注并鎖定簽名接口

10電子證照簽章驗簽電子證照簽章驗簽接口

4

DB37/T4563—2022

附錄A

（資料性）

接入申請表

A.1電子印章應(yīng)用系統(tǒng)接入申請表

接入部門電子印章應(yīng)用系統(tǒng)接入申請表見表A.1。

表A.1電子印章應(yīng)用系統(tǒng)接入申請表

接入系統(tǒng)信息

接入系統(tǒng)名稱

訪問地址

接入系統(tǒng)IP

網(wǎng)絡(luò)環(huán)境

技術(shù)聯(lián)系人聯(lián)系電話

接入部門信息

接入部門名稱

接入部門聯(lián)系人聯(lián)系電話

接入部門意見簽字（蓋章）：

日期：

省電子印章系統(tǒng)主管

簽字（蓋章）：

部門意見

日期：

5

DB37/T4563—2022

A.2業(yè)務(wù)系統(tǒng)接入申請表

接入部門業(yè)務(wù)系統(tǒng)接入申請表見表A.2。

表A.2業(yè)務(wù)系統(tǒng)接入申請表

接入系統(tǒng)信息

接入系統(tǒng)名稱

對接業(yè)務(wù)

承建部門

網(wǎng)絡(luò)環(huán)境

技術(shù)聯(lián)系人聯(lián)系電話

接入系統(tǒng)IP

接入部門信息

接入部門名稱

接入部門聯(lián)系人聯(lián)系電話

接入部門意見簽字（蓋章）：

日期：

省電子印章系統(tǒng)主管部

簽字（蓋章）：

門意見

日期：

6

DB37/T4563—2022

附錄B

（規(guī)范性）

電子印章應(yīng)用系統(tǒng)接入接口說明

B.1獲取公鑰接口

B.1.1接口功能描述

在制作電子印章過程中，省電子印章系統(tǒng)從接入部門電子印章應(yīng)用系統(tǒng)獲取簽名公鑰信息。

B.1.2請求方式

接口請求方式為POST。

B.1.3輸入?yún)?shù)

獲取公鑰接口輸入?yún)?shù)見表B.1。

表B.1輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，省電子印章系統(tǒng)對message_content進行數(shù)字簽名得到

sign字符型

的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

簽名密鑰索引號，可為空值，空值時表示生成簽名密鑰并返回簽

message_contentindex字符型

名密鑰索引號；非空時表示根據(jù)該索引號獲取公鑰信息

B.1.4輸出參數(shù)

獲取公鑰接口輸出參數(shù)見表B.2。

表B.2輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，接入部門電子印章應(yīng)用系統(tǒng)對message_content進行

sign字符型

數(shù)字簽名得到的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

code數(shù)字型獲取公鑰結(jié)果代碼，0-成功，1-失敗

msg字符型結(jié)果描述信息

message_content簽名公鑰，采用Base64編碼格式，公鑰長度為65個字節(jié)，由

publicKey字符型

“04”+64個字節(jié)組成

index字符型簽名密鑰索引號

B.2加密密鑰對導(dǎo)入接口

B.2.1接口功能描述

省電子印章系統(tǒng)將CA返回的數(shù)字證書對應(yīng)的加密密鑰對導(dǎo)入接入部門電子印章應(yīng)用系統(tǒng)。

7

DB37/T4563—2022

B.2.2請求方式

該接口請求方式為POST。

B.2.3輸入?yún)?shù)

加密密鑰對導(dǎo)入接口輸入?yún)?shù)見表B.3。

表B.3輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，省電子印章系統(tǒng)對message_content進行數(shù)字簽名得

sign字符型

到的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

index字符型簽名密鑰對索引號

encindex字符型加密密鑰對索引號

message_content

加密密鑰對，采用Base64編碼格式,加密數(shù)據(jù)格式采用GM/T

encKey字符型

0016—2012ENVELOPEDKEYBLOB格式

B.2.4輸出參數(shù)

加密密鑰對導(dǎo)入接口輸出參數(shù)見表B.4。

表B.4輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，接入部門電子印章應(yīng)用系統(tǒng)對message_content進行

sign字符型

簽名得到的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

code數(shù)字型密鑰導(dǎo)入結(jié)果代碼，0-成功，1-失敗

message_contentmsg字符型結(jié)果描述信息

encindex字符型加密密鑰對索引號

B.3電子文件寫入接口

B.3.1接口功能描述

省電子印章系統(tǒng)將電子印章簽名證書、加密證書、電子印章數(shù)據(jù)等以文件的形式寫入接入部門電子

印章應(yīng)用系統(tǒng)。

B.3.2請求方式

該接口請求方式為POST。

B.3.3輸入?yún)?shù)

電子文件寫入接口輸入?yún)?shù)見表B.5。

8

DB37/T4563—2022

表B.5輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，省電子印章系統(tǒng)對message_content進行數(shù)字簽名得到

sign字符型

的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

type數(shù)字型電子文件類型，0-電子印章數(shù)字證書，1-電子印章

message_content

file字符型電子文件數(shù)據(jù)，采用Base64編碼格式

B.3.4輸出參數(shù)

電子文件寫入接口輸出參數(shù)見表B.6。

表B.6輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，接入部門電子印章應(yīng)用系統(tǒng)對message_content進行數(shù)

sign字符型

字簽名得到的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

code數(shù)字型文件是否寫入成功，0-是，1-否

message_content

msg字符型結(jié)果描述信息

B.4文件解密加密接口

B.4.1接口描述

省電子印章系統(tǒng)將公安下發(fā)數(shù)據(jù)發(fā)送給接入部門電子印章應(yīng)用系統(tǒng)，由接入部門電子印章應(yīng)用系統(tǒng)

對公安數(shù)據(jù)進行解密，并將解密出的設(shè)備編碼重新加密后返回至省電子印章系統(tǒng)。

B.4.2請求方式

該接口請求方式為POST。

B.4.3輸入?yún)?shù)

文件解密加密接口輸入?yún)?shù)見表B.7。

表B.7輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，省電子印章應(yīng)用系統(tǒng)對message_content進行數(shù)字簽名得

sign字符型

到的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

encindex字符型加密密鑰對索引號

message_contentencKey字符型對稱密鑰，采用Base64編碼格式

encFile字符型由對稱密鑰加密的文件數(shù)據(jù)，加密采用SM4ECCPKCS7PADDING方式

9

DB37/T4563—2022

B.4.4輸出參數(shù)

文件解密加密接口輸出參數(shù)見表B.8。

表B.8輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，接入部門電子印章應(yīng)用系統(tǒng)對message_content進行數(shù)字

sign字符型

簽名得到的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

code數(shù)字型文件解密加密結(jié)果代碼，0-成功，1-失敗

msg字符型結(jié)果描述信息

message_contentsealCode字符型電子印章編碼

deviceCode字符型設(shè)備編碼

encDeviceCode字符型經(jīng)過加密的設(shè)備編碼，加密采用SM4ECBPKCS7PADDING的方式

B.5電子印章狀態(tài)查詢接口

B.5.1接口描述

接入部門電子印章應(yīng)用系統(tǒng)通過省級電子印章狀態(tài)發(fā)布系統(tǒng)查詢已發(fā)布的電子印章狀態(tài)信息。

B.5.2請求方式

該接口請求方式為POST。

B.5.3輸入?yún)?shù)

電子印章狀態(tài)查詢接口輸入?yún)?shù)見表B.9。

表B.9輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，接入部門電子印章應(yīng)用系統(tǒng)對message_content內(nèi)容數(shù)

sign字符型

字簽名得到的值

message_header

ctime日期時間型時間戳，格式為YYYY-MM-DDhh:mm:ss，應(yīng)符合GB/T7408

sealName字符型電子印章名稱

sealCode字符型電子印章編碼

message_content查詢時間，格式為YYYY-MM-DDhh:mm:ss，應(yīng)符合GB/T7408，可

queryTime日期時間型

選性，默認(rèn)為當(dāng)前時間

sealUserCert字符型印章所有者數(shù)字證書，采用Base64編碼格式

B.5.4輸出參數(shù)

電子印章狀態(tài)信息查詢接口輸出參數(shù)見表B.10。

10

DB37/T4563—2022

表B.10輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，省電子印章系統(tǒng)對message_content內(nèi)容數(shù)字簽名得到

sign字符型

的值

message_header

ctime日期時間型時間戳，格式為YYYY-MM-DDhh:mm:ss，應(yīng)符合GB/T7408

code數(shù)字型電子印章狀態(tài)代碼，0-有效，1-無效

message_content

msg字符型結(jié)果描述信息

11

DB37/T4563—2022

附錄C

（規(guī)范性）

業(yè)務(wù)系統(tǒng)接入接口信息

C.1PDF位置簽章接口

C.1.1接口描述

業(yè)務(wù)系統(tǒng)請求省電子印章系統(tǒng)按照位置參數(shù)對PDF文件進行簽章，并將簽章后的PDF文件返回至業(yè)務(wù)

系統(tǒng)。

C.1.2請求方式

該接口請求方式為POST。

C.1.3輸入?yún)?shù)

PDF位置簽章接口輸入?yún)?shù)應(yīng)符合表C.1的要求。

表C.1輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，業(yè)務(wù)系統(tǒng)對message_content進行數(shù)字簽名得到

sign字符型

的值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

fileData字符型待簽章的PDF文件數(shù)據(jù)，采用Base64編碼

字符型PDF文檔保護的原文字節(jié)區(qū)域，開始位置與結(jié)束位置采用

filePaths

“-”連接

fileSign字符型簽名值，業(yè)務(wù)系統(tǒng)證書對filePaths標(biāo)注的原文保護區(qū)域

進行數(shù)字簽名得到的值

業(yè)務(wù)系統(tǒng)對應(yīng)的標(biāo)識號，在業(yè)務(wù)系統(tǒng)接入完成后，省電子

appId字符型

message_content印章系統(tǒng)向業(yè)務(wù)系統(tǒng)分配該標(biāo)識號

fileName字符型待簽章文件名稱

sealId字符型電子印章編碼

signListpageNum數(shù)字型簽章位置對應(yīng)PDF文件中的頁碼，從1開始

（簽章信zx數(shù)字型簽章位置的X坐標(biāo)，以簽章所在頁的左下角為坐標(biāo)原點

息列表）zy數(shù)字型簽章位置的Y坐標(biāo)，以簽章所在頁的左下角為坐標(biāo)原點

secretKey字符型電子印章數(shù)字證書密鑰索引號，可為空值

C.1.4輸出參數(shù)

PDF位置簽章接口輸出參數(shù)應(yīng)符合表C.2的要求。

表C.2輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

fileData字符型簽章后的PDF文件，采用Base64編碼格式

code數(shù)字型PDF位置簽章結(jié)果代碼，0-簽章成功，1-簽章失敗

12

DB37/T4563—2022

表C.2輸出參數(shù)（續(xù)）

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

msg字符型結(jié)果描述信息

C.2PDF騎縫章簽章接口

C.2.1接口描述

業(yè)務(wù)系統(tǒng)請求省電子印章系統(tǒng)，按照騎縫位置對PDF文件進行騎縫章簽章，并將簽章后的PDF文件返

回至業(yè)務(wù)系統(tǒng)。

C.2.2請求方式

該接口請求方式為POST。

C.2.3輸入?yún)?shù)

PDF騎縫章簽章接口輸入?yún)?shù)應(yīng)符合表C.3的要求。外框線

表C.3輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

sign字符型簽名值，業(yè)務(wù)系統(tǒng)對message_content進行數(shù)字簽名得到的值

message_headerctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

fileData字符型待簽章的PDF文件數(shù)據(jù)，采用Base64編碼格式

PDF文檔保護的原文字節(jié)區(qū)域，開始位置和結(jié)束位置采用“-”

filePaths字符型

連接

簽名值，業(yè)務(wù)系統(tǒng)證書對filePaths標(biāo)注的原文保護區(qū)域進行

fileSign字符型

數(shù)字簽名得到的值

message_content業(yè)務(wù)系統(tǒng)對應(yīng)的標(biāo)識號，在業(yè)務(wù)系統(tǒng)接入完成后，省電子印章

appId字符型

系統(tǒng)向業(yè)務(wù)系統(tǒng)分配該標(biāo)識號

sealId字符型電子印章編碼

connPage數(shù)字型簽章需要騎縫的頁數(shù)，即電子印章被拆分的份數(shù)

connY數(shù)字型騎縫印章在OFD文件的Y坐標(biāo)，每頁的右下角為坐標(biāo)原點

secretKey字符型電子印章數(shù)字證書密鑰索引號，可為空

C.2.4輸出參數(shù)

PDF騎縫章簽章接口輸出參數(shù)應(yīng)符合表C.4的要求。

表C.4輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

fileData字符型簽章后的PDF文件，采用Base64編碼格式

code數(shù)字型PDF騎縫章簽章結(jié)果代碼，0-成功，1-失敗

msg字符型結(jié)果描述信息

C.3OFD位置簽章接口

13

DB37/T4563—2022

C.3.1接口描述

業(yè)務(wù)系統(tǒng)請求省電子印章系統(tǒng)按照位置參數(shù)對OFD文件進行簽章，并將簽章后的OFD文件返回至業(yè)務(wù)

系統(tǒng)。OFD格式的版式文件應(yīng)符合GB/T33190—2016中相關(guān)規(guī)定。

C.3.2請求方式

該接口請求方式為POST。

C.3.3輸入?yún)?shù)

OFD位置簽章接口輸入?yún)?shù)應(yīng)符合表C.5的要求。

表C.5輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

簽名值，業(yè)務(wù)系統(tǒng)對message_content進行數(shù)字簽名得到的

sign字符型

值

message_header

ctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

fileData字符型待簽章的OFD文件，采用Base64編碼格式

OFD文檔中，除了OFD.xml和Signatures.xml文件外的其他

子文件所組成的文件路徑列表(文件路徑為絕對路徑)，且

filePaths字符型對文件路徑列表進行HASH運算,文件路徑之間采用“||”進

行分隔。例如：

/Doc_0/Document.xml||/Doc_0/Res/font_1.otf

簽名值，對filePaths所生成的文件路徑列表中的每個文件

fileSign字符型按順序進行HASH運算組成簽名原文，并用業(yè)務(wù)系統(tǒng)證書對

message_content

生成的簽名原文進行數(shù)字簽名得到的值

業(yè)務(wù)系統(tǒng)對應(yīng)的標(biāo)識號,在業(yè)務(wù)系統(tǒng)接入完成后，省電子印

appId字符型

章系統(tǒng)向業(yè)務(wù)系統(tǒng)分配該標(biāo)識號

sealId字符型電子印章編碼

signListpageNum數(shù)字型簽章位置對應(yīng)的OFD文件中的頁碼，從0開始

（簽章信息zx數(shù)字型簽章位置的X坐標(biāo)，以簽章所在頁的左上角為坐標(biāo)原點

列表）zy數(shù)字型簽章位置的Y坐標(biāo)，以簽章所在頁的左上角為坐標(biāo)原點

secretKey字符型電子印章數(shù)字證書密鑰索引號，可為空

C.3.4輸出參數(shù)

OFD位置簽章接口輸出參數(shù)應(yīng)符合表C.6的要求。

表C.6輸出參數(shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

fileData字符型簽章后的OFD文件，采用Base64編碼格式

code數(shù)字型OFD位置簽章結(jié)果代碼，0-簽章成功，1-簽章失敗

msg字符型結(jié)果描述信息

C.4OFD騎縫章簽章接口

14

DB37/T4563—2022

C.4.1接口描述

業(yè)務(wù)系統(tǒng)請求省電子印章系統(tǒng)按照騎縫位置對OFD文件進行騎縫章簽章，并將簽章后的OFD文件返回

至業(yè)務(wù)系統(tǒng)。

C.4.2請求方式

該接口請求方式為POST。

C.4.3輸入?yún)?shù)

OFD騎縫章簽章接口輸入?yún)?shù)應(yīng)符合表C.7的要求。

表C.7輸入?yún)?shù)

參數(shù)名稱數(shù)據(jù)類型參數(shù)說明

sign字符型簽名值，業(yè)務(wù)系統(tǒng)對message_content進行數(shù)字簽名得到的值

message_headerctime日期時間型時間戳，格式為YYYY—MM—DDhh:mm:ss，應(yīng)符合GB/T7408

version字符型接口版本號，默認(rèn)版本為1.0

fileData字符型待簽章的OFD文件數(shù)據(jù)，采用Base64編碼格式

OFD文檔中，除了OFD.xml和Signatures.xml文件外的其他子文件所組成的

文件路徑列表(文件路徑為絕對路徑)，且對文件路徑列表進行HASH運算，

filePaths字符型

文件路徑之間采用“||”進行分隔