SEAL API测试

请求构建

Word .docx 文件

docx_name?上传的 .docx 文件名（含扩展名）。后端用这个名字决定输出文件名（xxx_signed.docx），并校验扩展名必须是 .docx。

match_mode?决定如何找到签名图片。
• upload: 手动上传图片
• id: 按人员 ID 从数据库查
• name: 按姓名从数据库查
• auto: 扫描文档里 SET USER_姓名域代码自动匹配

auto 空 stamps 扫描全部?仅当 match_mode=auto 时生效。
• true: 忽略下方 marker 列表，扫描文档里全部 USER_ 标记
• false: 只处理下方 marker 列表里指定的标记

use_global_align?true=所有盖章项共用下方全局对齐参数；false=每个盖章项用自己的对齐参数（可各不相同）。

全局 align_h?图片在段落内的水平对齐方式。预留接口（当前版本未启用）。

全局 align_v?图片在段落内的垂直对齐方式。预留接口（当前版本未启用）。

use_global_height?true=所有盖章项缩放到统一高度（下方全局 height）；false=每个盖章项用自己配置的高度（可各不相同）。
留空 height = 自动根据插入位置字号/行高推算。

全局 height(cm)?签名图等比例缩放后的最终高度，单位厘米。范围 0.1~10。
留空 = 自动尺寸（推荐）：根据插入位置的字号（2 倍）或段落行高（95%）自动推算。
填了具体值 = 强制使用该高度，但若超过段落行高/单元格宽度仍会等比缩小。

use_global_noise?true=所有盖章项共用下方全局噪声参数；false=各自配置（可各不相同）。

全局 noise_level?0~10，在笔画边缘撒随机噪点模拟印章/签字不均匀感（防伪）。0=关闭。数值越大噪点越密。仅在笔画边缘 ±2 像素范围内、且只撒到透明像素上，不会糊掉笔画。

use_global_rotate?true=所有盖章项共用下方全局旋转参数；false=各自配置（可各不相同）。

全局 rotate_min?随机旋转角度的最小值（度，-180~180）。rotate_min 和 rotate_max 都是 0 则不旋转。如 -3 表示可能左旋到 -3°。旋转后由"紧致裁剪"切掉新增的透明边。

全局 rotate_max?随机旋转角度的最大值（度，-180~180）。如 3 表示可能右旋到 3°。两个都是 0 则不旋转。

放宽段落布局?true（默认）：当签名位置段落有固定行高（lineRule=exact）或表格行有固定行高（hRule=exact）小于签名高度时，自动把约束改为 atLeast 并上调数值，让签名按设定尺寸完整显示，避免被 Word 硬裁剪。仅作用于段落直接格式，不修改样式。false=严格保留原文档布局，签名被缩放到约束内（可能很小）。

盖章项

完整请求与响应

请求 JSON

响应

签名图片预览（原图 vs 处理后）

选择一个盖章项，预览原图与最终插入文档的处理后图片（走完整流水线：二值化/抠白/裁剪/缩放/噪声/旋转/紧致裁剪）。

选择盖章项

当前匹配模式

解析后姓名 / ID

原签名图

待加载

处理后（实际插入到文档）

待加载

OA Action 兼容

成功响应为 HTTP 200、Word MIME 和原始 .docx 二进制；失败响应为非 2xx 和 JSON。OA Action 将成功字节写入具体 Action 配置的附件或文档字段。

批量文件处理

Word 根目录路径

递归子文件夹

自动签名

规则文件路径

正则规则

常用提示

测试与预览

测试文本

匹配结果

批量结果

文件	状态	标记	输出	告警

OA/API 请求监控

状态

搜索 trace_id / IP

请求列表

时间	IP	trace_id	状态	响应	耗时

请求详情

图片数据库

ID	姓名	is_signature	图片大小	操作

新增 / 编辑

user_id

user_name

is_signature

图片

批量导入图片

选择图片

自动 ID 前缀

起始序号

序号位数

默认 is_signature

文件	姓名	大小	状态

请求构建

盖章项

完整请求与响应

签名图片预览（原图 vs 处理后）

OA Action 兼容

批量文件处理

正则规则

测试与预览

批量结果

OA/API 请求监控

请求列表

请求详情

图片数据库

新增 / 编辑

批量导入图片

原图 / 处理后预览