EST-100多功能手寫簽批屏DLL&Web開發文檔
廣東東信智能科技有限公司DONSEE EST-100多功能手寫簽批屏開發文檔，包括了手寫簽字、指紋采集、讀身份證、社保卡、IC卡、銀行卡、高拍儀、人臉識別比對等多種功能。
開發文檔下載地址：
產品銷售咨詢：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 失敗
產品咨詢