DONSEE東信智能 - 身份證社保卡讀卡智能終端應用服務商

廣東東信智能科技有限公司DONSEE EST-100多功能手寫簽批屏開發文檔，包括了手寫簽字、指紋采集、讀身份證、社保卡、IC卡、銀行卡、高拍儀、人臉識別比對等多種功能。

開發文檔下載地址：

1、Web瀏覽器端開發文檔下載↓

2、DLL庫開發文檔下載↓

產品銷售咨詢：138-2221-6429

鴻蒙技術咨詢：139-2221-0502

東信智能多功能簽批屏Web瀏覽器接口

用戶開發手冊

修訂人 修訂日期 修訂內容

何工 2025-03-27 支持PDF關鍵字簽字、PDF任意簽字、獲取PDF簽字圖片、人像采集、高拍采集、身份證讀取、指紋采集、獲取簽字圖片

1.使用說明

1.1.服務地址

Url：ws://127.0.0.1:30089

1． 通信協議

API的所有接口均通過 WebSocket進行通信

2．請求方式

請求方式： json 文本

3． 字符編碼

均使用UTF-8 編碼

4． 公共參數

公共參數是用于表示用戶和接口目的的參數

參數名稱 類型 必選 描述

action string 是 具體操作的指令的接口編號

ret string 是 響應報文對請求功能的返回值描述

用戶請求連接的形式舉例,將請求參數封裝成 json 字符串發送

{“action”: “50”}

響應報文描述實例：

{“action”: “50”, “ret”: “00”}

2.服務接口說明

2.1. 打開設備連接

2.1.1 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_01

2.1.2 輸出參數

參數名稱 類型 數據約束 描述

action string donsee_01

ret string 00 設備連接成功

   01 設備連接失敗

2.2. 斷開設備連接

2.2.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_02

2.1輸出參數

參數名稱 類型 數據約束 描述

action string donsee_02

ret string 00 設備斷開連接成功

   01 設備斷開連接失敗

2.3. 獲取設備序列號

2.3.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_03

2.3.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_03

SN string 設備序列號

ret string 00 成功

   01 失敗

2.4. 寫設備序列號

2.4.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_04

SN string 序列號

2.4.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_04

ret string 00 成功

   01 失敗

2.5. 寫首頁背景

2.5.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_05

imgPath string 首頁背景圖片路徑

2.5.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_05

ret string 00 成功

   01 失敗

2.6. 重置首頁背景

2.6.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_61

2.6.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_61

ret string 00 成功

   01 失敗

2.7.設置簽字板標題

2.7.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_06

title string 簽字板標題

2.7.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_06

ret string 00 成功

   01 失敗

2.8.設置筆顏色

2.8.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_07

color int RGBA格式 簽字筆顏色，例如0xFF0000FF 紅色

2.8.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_07

ret string 00 成功

   01 失敗

2.9. 設置筆壓

2.9.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_08

pressure float 筆壓范圍: 0.1~1.0

2.9.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_08

ret string 00 成功

   01 失敗

2.10. 設置簽字框位置

2.10.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_09

x int x起點

y int y起點

width int 寬度

height int 高度

2.10.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_09

ret string 00 成功

   01 失敗

2.11.設置邊框

2.11.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_10

type int 邊框寬度

2.11.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_10

ret string 00 成功

   01 失敗

2.12.設置邊框顏色

2.12.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_11

color int RGBA格式 邊框顏色，例如0xFF0000FF 紅色

2.12.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_11

ret string 00 成功

   01 失敗

2.13.設置簽字筆寬度

2.13.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_12

width int 簽字圖片寬度

2.13.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_12

ret string 00 成功

   01 失敗

2.14.設置簽字筆高度

2.14.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_13

height int 簽字圖片高度

2.14.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_13

ret string 00 成功

   01 失敗

2.15.開始簽字

2.15.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_14

2.15.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_14

ret string 00 成功

   01 失敗

2.16.重簽

2.16.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_15

2.16.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_15

ret string 00 成功

   01 失敗

2.17.關閉簽字版

2.17.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_16

2.17.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_16

ret string 00 成功

   01 失敗

2.18.獲取簽字筆跡軌跡圖片路徑

2.18.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_17

2.18.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_17

path string 簽字圖片保存路徑

ret string 00 成功

   01 失敗

2.19.獲取簽字筆跡軌跡圖片

2.19.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_18

2.19.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_18

path string 簽字圖片保存路徑

ret string 00 成功

   02 等待客戶端確認簽字

   01 失敗

2.20.獲取簽字圖片base64

2.20.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_19

2.20.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_19

imgBase64 string 簽字圖片

ret string 00 成功

   01 失敗

2.21.保存簽字圖片

2.21.1. 輸入參數

參數名稱 類型 數據約束 描述

action string donsee_20

2.21.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_20

path string 簽字圖片路徑

ret string 00 成功

   01 失敗

2.22.打開攝像頭

2.22.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_21

index int 攝像頭索引，例如0、1、2

width int 寬

height int 高

2.22.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_21

ret string 00 成功

   01 失敗

2.23.拍照（保存圖片路徑）

2.23.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_22

index int 攝像頭索引

2.23.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_22

path string 拍照圖片路徑

ret string 00 成功

   01 失敗

2.24.拍照圖片base64

2.24.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_23

index int 攝像頭索引

2.24.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_23

imgBase64 string 拍照圖片

width int 拍照圖片寬

height int 拍照圖片高

ret string 00 成功

   01 失敗

2.25. 關閉攝像頭

2.25.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_24

index int 攝像頭索引

2.25.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_24

ret string 00 成功

   01 失敗

2.26. 獲取攝像頭個數

2.26.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_25

2.26.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_25

count int 攝像頭個數

ret string 00 成功

   01 失敗

2.27.獲取攝像頭名稱（遍歷所有攝像頭）

2.27.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_26

2.27.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_26

cameraNames stringArr 攝像頭分辨率，二維數組形式[[“320x480”,”640x480”], [“320x480”, “640x480”]]

ret string 00 成功

   01 失敗

2.28.獲取當前攝像頭分辨率

2.28.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_28

2.28.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_28

width int 寬

height int 高

ret string 00 成功

   01 失敗

2.29.旋轉

2.29.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_29

2.29.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_29

ret string 00 成功

   01 失敗

2.30.沿x軸翻轉

2.30.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_30

2.30.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_30

ret string 00 成功

   01 失敗

2.31.沿y軸翻轉

2.31.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_31

2.31.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_31

ret string 00 成功

   01 失敗

2.32.開啟自動裁剪

2.32.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_32

2.32.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_32

ret string 00 成功

   01 失敗

2.33.關閉自動裁剪

2.33.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_33

2.33.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_33

ret string 00 成功

   01 失敗

2.34.縮小

2.34.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_34

2.34.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_34

ret string 00 成功

   01 失敗

2.35.放大

2.35.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_35

2.35.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_35

ret string 00 成功

   01 失敗

2.36.設置預覽回調

2.36.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_36

2.36.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_36

imgBase64 string 僅當 ret=”00” 時才有數據

ret string 00 成功

   02 等待預覽數據

   01 失敗

2.37.圖片轉base64

2.37.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_37

path string 圖片路徑

2.37.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_37

imgBase64 string 圖片base64數據

ret string 00 成功

   01 失敗

2.38.圖片合成PDF

2.38.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_38

imgArrary stringArr 圖片數組，例如[“xxx.jpg”, “xxx.jpg”]

keepRatio int 是否縮放0: 保持原始比例，0: 不處理、1：以寬為基準、2：以高為基準

fullPage int 是否縮放到整頁，0: 不縮放 1:填充整個頁面

paddingLeft int 左邊距

paddingTop int 上邊距

paddingRight int 右邊距

paddingBottom int 底邊距

2.38.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_38

pdfPath string pdf路徑

ret string 00 成功

   01 失敗

2.39.讀身份證

2.39.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_40

2.39.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_40

idInfo string 身份證信息，以|分割

ret string 00 成功

   02 等待用戶刷身份證

   01 失敗

2.40.讀身份證頭像

2.40.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_41

2.40.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_41

photoData string hexString 身份證頭像數據

ret string 00 成功

   01 失敗

2.41.讀身份證指紋

2.41.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_60

2.41.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_60

finData string hexString 身份證頭像數據

ret string 00 成功

   01 失敗

2.42.停止讀取身份證

2.42.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_42

2.42.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_42

ret string 00 成功

   01 失敗

2.43.讀取條碼信息

2.43.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_43

2.43.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_43

barcode string 條碼數據

ret string 00 成功

   01 失敗

2.44.讀取指紋

2.44.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_44

2.44.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_44

imgBase64 string 指紋圖片base64

ret string 00 成功

   02 等待按壓指紋

   01 失敗

2.45.關閉讀取指紋

2.45.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_46

2.45.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_46

ret string 00 成功

   01 失敗

2.46.發起PDF簽字（任意簽）

2.46.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_47

pdfData string pdf數據

pdfType 為0 是傳入PDF文件路徑。

1：時傳入 pdf base64

pdfType number 0:  pdfFile, 1: pdfBase64

timeout string 簽字操作時間

2.46.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_47

pdfBase64 pdf簽字后base64文件

SignNameJson string 簽字JSON

SignNameCount int 簽字的個數

FinPrintJson string 指紋JSON

FinPrintCount int 指紋的個數

XMLJson string 簽字軌跡JSON

XMLCount int 簽字軌跡個數

ret string 00 成功

   02 正在下載PDF

   03 等待用戶操作完成

   04 簽字超時

   01 失敗

2.47.發起網絡PDF簽字（任意簽）

2.47.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_147

downloadPath string 下載地址

uploadPath string 上傳地址

userId string 可選 用戶id

key string key

timeout number 簽字操作時間

2.47.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_147

ret string 00 成功

   02 正在下載PDF

   03 等待用戶完成操作

   04 PDF簽字超時

   05 上傳失敗

   01 失敗

2.48. 關閉PDF簽字

2.48.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_48

2.48.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_48

ret string 00 成功

   01 失敗

2.49.打開評價器

2.49.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_49

2.49.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_49

value string 評價結果: 1:非常滿意、2:滿意、3:一般、4:不滿意、5:非常不滿意

ret string 00 成功

   02 等待用戶完成評價

   01 失敗

2.50. 關閉評價

2.50.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_50

2.50.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_50

ret string 00 成功

   01 失敗

2.51.PDF關鍵字簽字

2.51.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_51

timeout int 操作時間

compose int 簽名是否需要合成, 1： 合成到指定頁面、2：僅展示不合成

width int 簽字寬度占頁面的百分比

height int 簽字高度占頁面的百分比

keyword stringArr 關鍵字數組，例如[“申請人簽字”,”受訪者簽字”]

keywordCnt int 關鍵字個數，既數組長度

title string 簽字標題

pdfData string pdf數據

根據pdfType選擇，0：文件，1：base64

pdfType number 0: pdfFile 1: pdf base64

2.51.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_51

SignPdfBase64 string pdf簽字后base64

SignNameBase64 string 簽字圖片base64

FinPngBase64 string 指紋圖片base64，可能為空

ret string 00 成功

   02 正在下載PDF

   03 等待用戶完成操作

2.52.PDF網絡關鍵字簽字

2.52.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_151

timeout int 操作時間

compose int 簽名是否需要合成, 1： 合成到指定頁面、2：僅展示不合成

width int 簽字寬度占頁面的百分比

height int 簽字高度占頁面的百分比

keyword stringArr 關鍵字數組，例如[“申請人簽字”,”受訪者簽字”]

keywordCnt int 關鍵字個數，既數組長度

title string 簽字標題

downloadPath string 下載接口地址

uploadPath string 上傳地址

userId string 用戶ID

key string key秘鑰

2.52.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_151

SignNameBase64 string 簽字圖片base64

FinPngBase64 string 指紋圖片base64，可能為空

ret string 00 成功

   02 正在下載PDF

   03 等待用戶完成操作

   04 PDF簽字超時

   05 上傳失敗

   01 失敗

2.53.關閉PDF關鍵字簽字

2.53.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_52

2.53.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_52

ret string 00 完成

   01 失敗

2.54.發起圖片簽字

2.54.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_53

timeout int 操作時間

compose int 是否合成到圖片上，1: 合成、2:僅展示不合成

left int 簽字位置距離圖片起始位置百分比

top int 簽字位置距離圖片左上角百分比

titile string 簽字標題

imgPath string JPG圖片路徑

2.54.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_53

imgBase64 string 簽字后的圖片base64

singImgBase64 string 簽字圖片base64

ret string 00 成功

   02 等待用戶簽字完成

   01 失敗

2.55.關閉圖片簽字

2.55.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_54

2.55.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_54

ret string 00 成功

   01 失敗

2.56.讀取社保卡信息

2.56.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_57

2.56.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_57

sscardInfo string 社保卡信息，以|分割

ret string 00 成功

   02 等待用戶刷社保卡

   01 失敗

2.57.基于加密機的讀卡步驟一

2.58.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_58

2.58.1.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_58

sscardInfo string 社保卡信息，以|分割

ret string 00 成功

   01 失敗

2.59.基于加密機的讀卡步驟二

2.60.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_59

pKey string pKey

2.60.1.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_59

sscardInfo string 社保卡信息，以|分割

ret string 00 成功

   01 失敗

2.61.關閉社保卡讀取

2.62.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_60

2.62.1.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_60

ret string 00 成功

   01 失敗

2.63.打開網頁

2.64.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_165

2.64.1.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_165

ret string 00 成功

   01 失敗

2.65.關閉網頁

2.66.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_166

2.66.1.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_166

ret string 00 成功

   01 失敗

2.67.更新APK

2.67.1.輸入參數

參數名稱 類型 數據約束 描述

action string donsee_62

apkPath string 不為空                    apk文件路徑

2.67.2.輸出參數

參數名稱 類型 數據約束 描述

action string donsee_62

ret string 00 成功

   01 失敗