项目简介
本项目是一个PDF签章工具库,为签章解决方案提供了完整的接口调用功能。借助该库,用户能够方便地进行PDF文件的打开、下载、保存、签章验证、印章获取以及各种签章操作,有效解决PDF文件签章相关的需求。
项目的主要特性和功能
- 文件操作功能:支持打开PDF文件并获取文件ID,获取文件下载地址,将文件保存为Base64字符串、本地文件或远端服务器,以及关闭文件释放内存。
- 签章验证功能:可验证PDF中指定签名域的印章或所有印章,返回详细的验章结果信息。
- 印章管理功能:能获取USB Key中印章列表,提供印章的详细信息。
- 签章操作功能:支持坐标签章、关键字签章和骑缝签章三种签章方式,满足不同的签章需求。
- 请求配置功能:提供单次请求配置和全局请求配置,可设置重试、超时等参数。
安装使用步骤
安装
假设用户已经下载了本项目的源码文件,可根据以下不同环境进行安装:
- 浏览器中使用:
html
- npm中使用:
bash
npm install --save @byzk/pdf-signature-utils
- yarn中使用:
bash
yarn add @byzk/pdf-signature-utils
使用示例
以下是一些常见操作的使用示例: - 打开文件: ```javascript // 浏览器中使用示例
// CommonJS规范中使用 const pdfSignatureUtils = require('@byzk/pdf-signature-utils').default; pdfSignatureUtils.fileOpen({ name:'测试文件.pdf', rawHtmlEle:document.getElementById("uploadinput") }).then(function (fileId) { console.info(fileId); }).catch(function (err) { console.log(err); });
// ES6规范中使用
import {fileOpen} from "@byzk/pdf-signature-utils";
fileOpen({
name:'测试文件.pdf',
rawHtmlEle:document.getElementById("uploadinput")
}).then(function (fileId) {
console.info(fileId);
}).catch(function (err) {
console.log(err);
});
- **获取文件下载地址**:
javascript
// 假设已有文件ID
const fileId = 'your_file_id';
pdfSignatureUtils.fileDownloadUrlGet(fileId).then(function (downloadUrl) {
console.info(downloadUrl);
}).catch(function (err) {
console.log(err);
});
- **坐标签章**:
javascript
// 假设已有文件ID和印章ID
const fileId = 'your_file_id';
const sealId = 'your_seal_id';
const positions = [
{
pageNo: 1,
x: 10,
y: 20
}
];
const password = 'your_usbkey_password';
pdfSignatureUtils.signatureByPosition(fileId, sealId, positions, password).then(function (newFileId) {
console.info(newFileId);
}).catch(function (err) {
console.log(err);
});
```
更多详细的API使用方法和参数说明,请参考项目中的API简介部分。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】