协议/授权书/合同文档自动签章

接口标识: docautoseal 价格: 0.3 元/次 VIP免费

接口介绍
接口文档
在线测试

接口简介

文档自动签章API，支持将公章或签名图片自动叠加到PDF、DOCX、DOC文档的指定位置。输入待签章文档和签章PNG图片，通过智能文字定位技术，自动搜索目标文字（如「签字/盖章」）并将签章放置在旁边。支持甲方/乙方左右位置区分，适用于合同签署、公文盖章、协议签章等场景。签章尺寸标准（公章40mm/签名30mm），输出PDF格式，提供下载链接。

详细介绍

## 接口介绍

文档自动签章API提供将公章或签名图片自动叠加到文档指定位置的能力。输入待签章文档和签章图片，系统自动搜索目标文字并精确定位签章位置，适用于合同签署、公文盖章、协议签章等场景。

## 功能特点

- **多格式支持**：支持 PDF、DOCX、DOC 格式文档输入
- **智能定位**：通过搜索文档中的目标文字（如"签字/盖章"）自动定位签章位置
- **左右区分**：支持甲方/乙方位置筛选，多份协议场景下精确选择签章位置
- **标准尺寸**：签章按标准物理尺寸叠加（公章直径 40mm，签名宽 30mm）
- **输出格式**：输出统一为 PDF 格式，确保签章位置精确

## 使用步骤

### 第一步：提取标准化签章图片

调用 `sealconvertpng` 接口，从公章/签名图片中提取标准尺寸的签章 PNG：

```
POST /api/sealconvertpng
seal_file: 原始公章/签名图片 URL
seal_type: seal（公章）或 sign（签名）
```

返回标准化后的签章 PNG 下载链接。

### 第二步：调用文档自动签章

将第一步获得的签章 PNG 作为 `seal_file` 参数传入：

```
POST /api/docautoseal
doc_file: 待签章文档 URL
seal_file: 签章 PNG URL（来自 sealconvertpng 的输出）
seal_type: seal（公章）或 sign（签名）
doc_area: 目标文字（默认"签字/盖章"）
doc_place: left 或 right
```

### 第三步：下载签章后的文档

响应中的 `doc_dourl` 即为签章后文档的下载地址，有效期 24 小时。

## 响应示例

```json
{
    "code": 0,
    "desc": "成功",
    "data": {
        "doc_type": "pdf",
        "doc_dourl": "https://www.phpwc.cn/uploads/convert/docautoseal_1728888000.pdf",
        "file_size": 256789
    },
    "request_id": "req_abc123def456"
}
```

## 错误码

| code | 说明 |
|------|------|
| 0 | 成功 |
| 40002 | 参数错误（缺少必填参数或参数值无效） |
| 40012 | 文件下载失败（URL 无效或不可访问） |
| 50020 | 文档签章失败（内部处理异常） |

## 注意事项

- 签章图片需先通过 `sealconvertpng` 接口提取为标准尺寸 PNG，直接传入未标准化的图片可能导致签章尺寸不符合要求
- 支持 PDF、DOCX、DOC 三种文档格式输入，输出统一为 PDF 格式
- `doc_place` 参数用于在文档中存在多处相同目标文字时区分左右位置（如甲方在左、乙方在右）
- 若文档中未找到目标文字，签章将放置在 `doc_place` 指定的默认位置
- 签章后的文档下载链接有效期为 24 小时，请及时下载

接口地址： https://www.phpwc.cn/api/docautoseal

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`doc_file`	string	必填	-	要签章的文档，支持PDF/DOCX/DOC，公网URL / Base64(data:开头) / 文件ID(fileid_开头)
`seal_file`	string	必填	-	签章PNG图片（可调用 sealconvertpng 接口提取），公网URL / Base64 / 文件ID
`seal_type`	string	选填	`seal`	签章类型：seal（公章）、sign（签名）
`doc_place`	string	选填	`right`	默认放置位置：left（左侧）、right（右侧），当doc_area文字未找到时生效
`doc_area`	string	选填	`签字/盖章`	要搜索的目标文字，签章将放在文字旁边
`offset_zy`	string	选填	-	签章左右偏移量（选填），如 +24 向右偏移 24pt，-20 向左偏移 20pt
`offset_sx`	string	选填	-	签章上下偏移量（选填），如 +12 向下偏移 12pt，-12 向上偏移 12pt

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`doc_type`	string	输出文档格式（与输入一致）
`doc_dourl`	string	签章后文档的下载地址
`file_size`	string	输出文件大小（字节）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试