智能印章

概述

对 Word、PDF、PPT、Excel、图片等常见文件加盖印章。可输出 PDF、JPG、PNG 或 OFD。按次计费、不按页数。本商品提供两个独立接口，请按场景选用：

• 文档自动盖章：全自动在签章栏（如「甲方（公章）」「法人名章处」），把对应印章盖到页面上。
• 文档加盖骑缝章：把印章从左到右切开，盖到每一页右侧。装订后可对上完整印章。

使用流程

1. 按需求调用文档自动盖章或文档加盖骑缝章，提交源文件、印章图片和输出参数。
2. 接口立即返回 token，表示任务已创建成功。
3. 后续通过以下任一方式获取结果： 调用查询结果接口轮询任务状态；或在 options 中传入 callbackUrl，等待系统回调，详细见回调URL。

调用上述 API 需要签名，详细见文档附录：阿里签名。

---

阿里云支持从OSS内网直接下载文件，节约流量，见：阿里云独有部分

文档自动盖章

https://sealfile.market.alicloudapi.com/autoseal

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式

必须签名才能调用成功，签名见阿里签名规则:

https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/use-cases/call-apis

支持的输出格式

pdf、jpg、png、ofd。输出 jpg / png 时固定每页一张图。

支持的输入格式

源文件支持下列格式。印章必须是图片，见下方请求参数中的 stampUrl。不支持 inputFormat=url（网页抓取）。

请求参数

url 与 stampUrl 可分别使用 URL 或 Base64，允许混合，例如源文件用 URL、印章用 Base64；stampUrl 数组内也可 HTTP 与 Base64 混用。Base64总计最大8M。

盖章说明

• 盖什么：页面上的签章栏，例如「（公章）」「盖章处」、签章格、「法人名章处」。封面、条款正文、仅含公司介绍的附件默认不盖。
• 盖哪枚：多枚章时系统按签章栏自动对应。调用方只传印章图。
• 盖多大：公章 / 名章大小由系统按栏位自动选择。
• 找不到盖章处：任务成功，返回未盖章文件。
• 不是：数字签名。
• 页数上限：500 页。超出则任务失败。

印章要求

• 格式：必须是图片。建议使用红色印油的公章 / 名章图。支持透明底与非透明图；非透明图必须白底。
• 无可见印油：全白、全透明或印油过浅时任务失败，不会用空白图盖上去。
• 数量：1～20 枚。多枚时请按合同当事方准备对应的公章；同一方若还需法人名章，把名章图一并放入数组。

多数场景只需传 url、stampUrl 与 outputFormat。需要精细控制源文件转换时，可在 options 中传入页码范围、密码、回调 URL、输出文件名等，参数含义见 options 参数。

请求示例

• 例1: PDF 自动盖两枚公章，输出 PDF

{
  "url": "http://xxx.pdf",
  "stampUrl": ["http://xxx/company-a.png", "http://xxx/company-b.png"],
  "outputFormat": "pdf"
}

• 例2: Word 自动盖章（不传 inputFormat，由 URL 扩展名自动识别）

{"url": "http://xxx.docx", "stampUrl": "http://xxx/seal.png", "outputFormat": "pdf"}

• 例3: 源文件 URL，印章用 Base64

{
  "url": "http://xxx.pdf",
  "stampUrl": "base64图片",
  "outputFormat": "pdf"
}

• 例4: 源文件 Base64，印章用 URL

{
  "url": "base64字符串",
  "stampUrl": "http://xxx/seal.png",
  "inputFormat": "pdf",
  "outputFormat": "pdf"
}

• 例5: 源文件 HTTP，印章数组中 HTTP 与 Base64 混合

{
  "url": "http://xxx.pdf",
  "stampUrl": ["http://xxx/company-a.png", "base64图片"],
  "outputFormat": "pdf"
}

• 例6: 公章 + 法人名章

{
  "url": "http://xxx.pdf",
  "stampUrl": ["http://xxx/official-seal.png", "http://xxx/name-seal.png"],
  "outputFormat": "pdf"
}

• 例7: 输出 PNG，并指定结果文件名

{
  "url": "http://xxx.pdf",
  "stampUrl": "http://xxx/seal.png",
  "outputFormat": "png",
  "options": {"outputFileName": "autosealed"}
}

• 例8: 输出 OFD

{"url": "http://xxx.pdf", "stampUrl": "http://xxx/seal.png", "outputFormat": "ofd"}

• 例9: 设置回调

{
  "url": "http://xxx.pdf",
  "stampUrl": "http://xxx/seal.png",
  "outputFormat": "pdf",
  "options": {
    "callbackUrl": "https://api.example.com/callback"
  }
}

返回数据结构

result:

返回示例(成功状态)：

{
    "code":10000,
    "msg":"",
    "result":{"token":"YOUR_CREDENTIAL"}
}

返回示例(失败状态)：

{
    "code":40001,
    "msg":"ParmNotRight"
}

能力说明

• url、stampUrl 均可为 URL 或 Base64，可混合使用。
• stampUrl 可以是字符串或字符串数组，最多 20 枚章。必须是图片。Base64 印章若不是图片，提交时会返回参数错误。
• 输出 jpg / png 时固定每页一张图。
• 本接口不进行 OCR，不会把扫描件识别成可搜索文字。

文档加盖骑缝章

https://sealfile.market.alicloudapi.com/sealfile

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式

必须签名才能调用成功，签名见阿里签名规则:

https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/use-cases/call-apis

支持的输出格式

支持的输入格式

源文件支持下列格式。印章图片见下方请求参数中的 stampUrl。

请求参数

url 与 stampUrl 可分别使用 URL 或 Base64，允许混合，例如源文件用 URL、印章用 Base64。stampUrl 也可传字符串数组，一次加盖最多 5 枚骑缝章。Base64总计最大8M。

印章要求

• 格式：必须是图片，常见如 png、jpg、jpeg、gif、webp、bmp、tif。支持透明底与非透明图；非透明图必须白底。建议使用透明底 PNG。
• 怎么盖：系统按 PDF 页数把每枚印章从左到右均分成若干条，第 N 页贴第 N 条。1 枚章贴在每页右侧垂直居中；2～5 枚章按数组顺序从上往下均匀排列在右边缘。单页文档会在右侧加盖完整印章。
• 宽度：每枚印章图片的像素宽度必须 ≥ 文档页数（均分后每一条至少 1 像素），否则任务失败。例如 20 页的文档，印章宽度至少 20 像素。
• 建议：请使用较宽的横向印章，切开后每一条仍能看清。过窄或接近页数的宽度虽然能通过校验，但盖上后几乎看不见。

多数场景只需传 url、stampUrl 与 outputFormat。需要精细控制时，可在 options 中传入可选参数，例如：

• Office / PDF / 图片 / 网页文件 / EPUB / CAD：页码范围、密码、审阅标记、Excel 页边距与工作表、PPT 讲义布局、图片纠偏与背景、网页视口与边距、CAD 图层与品质等
• 输出控制：文件名、回调 URL、PDF 压缩/加密/线性化、图片最大边长、水印等

请求示例

• 例1: Word 加盖骑缝章，输出 PDF

{"url": "http://xxx.docx", "stampUrl": "http://xxx/seal.png", "outputFormat": "pdf"}

• 例2: PDF 加盖骑缝章（不传 inputFormat，由 URL 扩展名自动识别）

{"url": "http://xxx.pdf", "stampUrl": "http://xxx/seal.png", "outputFormat": "pdf"}

• 例3: Word 加盖骑缝章，输出 PNG（每页一张图）

{"url": "http://xxx.docx", "stampUrl": "http://xxx/seal.png", "outputFormat": "png"}

• 例4: PDF 加盖骑缝章，输出 OFD

{"url": "http://xxx.pdf", "stampUrl": "http://xxx/seal.png", "outputFormat": "ofd"}

• 例5: 源文件 Base64，印章用 URL

{
  "url": "base64字符串",
  "stampUrl": "http://xxx/seal.png",
  "inputFormat": "docx",
  "outputFormat": "pdf"
}

• 例6: 源文件 URL，印章用 Base64

{
  "url": "http://xxx.docx",
  "stampUrl": "base64图片",
  "outputFormat": "pdf"
}

• 例7: 源文件和印章都用 Base64，并指定结果文件名

{
  "url": "base64字符串",
  "stampUrl": "base64图片",
  "inputFormat": "pdf",
  "outputFormat": "pdf",
  "options": {"outputFileName": "sealed"}
}

• 例8: 一次加盖多枚骑缝章（最多 5 枚，按数组顺序从上往下）

{
  "url": "http://xxx.pdf",
  "stampUrl": ["http://xxx/seal-a.png", "http://xxx/seal-b.png"],
  "outputFormat": "pdf"
}

• 例9: 设置回调

{
  "url": "http://xxx.docx",
  "stampUrl": "http://xxx/seal.png",
  "outputFormat": "pdf",
  "options": {
    "callbackUrl": "https://api.example.com/callback"
  }
}

• 例10: 只盖 PDF 第 1、3、5-7 页

{
  "url": "http://xxx.pdf",
  "stampUrl": "http://xxx/seal.png",
  "outputFormat": "pdf",
  "options": {"pageRanges": "1,3,5-7"}
}

• 例11: 输出 JPG，限制图片最大边长

{
  "url": "http://xxx.pdf",
  "stampUrl": "http://xxx/seal.png",
  "outputFormat": "jpg",
  "options": {"imageMaxDimension": 800}
}

返回数据结构

result:

返回示例(成功状态)：

{
    "code":10000,
    "msg":"",
    "result":{"token":"YOUR_CREDENTIAL"}
}

返回示例(失败状态)：

{
    "code":40001,
    "msg":"ParmNotRight"
}

能力说明

• 印章的格式、宽度和盖章方式见上方印章要求。
• url、stampUrl 均可为 URL 或 Base64，可混合使用。
• stampUrl 可以是字符串或字符串数组，最多 5 枚章。必须是图片。Base64 印章若不是图片，提交时会返回参数错误。
• 输出 jpg / png 时固定每页一张图。
• 本接口不进行 OCR，不会识别成可搜索文字。

查询结果

调用方式： GET（无需签名）

https://api.duhuitech.com/q?token=YOUR_TOKEN

请求参数：

由于转换需要时间，文件越大页数越多，转换越久，故需要轮询查询接口来获得结果。查询频率可以是1s一次，也可以更长一些。 查询后先看status，如果是Done或Failed，则转换结束，停止轮询。如果是Doing或Pending，则继续轮询。

返回数据结构：

result:

结果读取规则：

1. 先看 status。
2. 若 status=Done：
   • outputFormat 为 jpg / png：读取 fileurls（数组；即使只有一页也是数组）。
   • outputFormat 为 pdf / ofd：读取 fileurl（单个字符串）。
3. 若 status=Failed：读取 reason。
4. 若 status=Doing 或 Pending：可读取 progress，继续轮询。

返回示例(进行中)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"progress":0.02,
		"status":"Doing"
	}
}

返回示例(成功，单文件，如 PDF / OFD)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.pdf",
		"count":10,
		"filesize":17747
	}
}

返回示例(成功，输出图片，多页)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png",
			"https://file.duhuitech.com/o/xxx/3.png"
		],
		"count":3,
		"filesize":1649699
	}
}

返回示例(成功，输出图片，仅一页也返回数组)：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.jpg"
		],
		"count":1,
		"filesize":20480
	}
}

返回示例(失败状态)：

{
	"code":40000,
	"msg":"No such token"
}

或：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Failed",
		"reason":"convert failed"
	}
}

参数列表 options

注意事项：整数参数使用标准 JSON 数字，布尔使用 JSON true / false，枚举使用语义字符串（如 source / landscape / portrait）。未知字段、类型错误、枚举或范围错误会返回参数错误。

输出 jpg / png 时固定每页一张图。

文字水印（watermarkText 等）是额外叠在页面上的文字，与自动盖章、骑缝章都不是同一件事。

输入 Office 文件相关（inputFormat 为 Word / PPT / Excel / WPS 等）

输入 PDF 相关（inputFormat=pdf）

输入图片相关（inputFormat 为 jpg/png/img 等）

输入网页文件 / Markdown 相关（inputFormat 为 html / md 等）

下列参数适用于传入 HTML、Markdown 等网页类文件。

输入 EPUB 相关（inputFormat=epub 等）

输入 CAD 文件相关（inputFormat 为 dwg / dxf 等）

---

通用输出

输出 PDF 相关（outputFormat=pdf）

输出图片相关（outputFormat=jpg / png）

图片格式由 outputFormat 决定。输出时固定每页一张图。

输出水印相关

文字水印会叠在页面内容上，与自动盖章、骑缝章相互独立。

备注：

• 输入文件 URL 方式支持文件最大 1500M；Base64 方式最大 8M。url 与 stampUrl 均适用。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

上述最后2项有延长需求请联系客服：

---

回调URL：

用途： 客户可以自行部署服务器，系统转换结束后会调用客户提供的回调URL，直接发送转换结果，从而无需再轮询查询结果。

在转换请求的 options 中传入 callbackUrl。当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

以POST方式调用该URL，Header头中Content-Type: application/json

Body为JSON格式，内容和查询结果的结果相同。例如单文件：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurl":"https://file.duhuitech.com/o/xxx/xxx.pdf",
		"filesize":17747,
		"count":1
	}
}

输出图片时同样返回 fileurls：

{
	"code":10000,
	"msg":"",
	"token":"YOUR_CREDENTIAL",
	"result":
	{
		"status":"Done",
		"fileurls":[
			"https://file.duhuitech.com/o/xxx/1.png",
			"https://file.duhuitech.com/o/xxx/2.png"
		],
		"count":2,
		"filesize":120000
	}
}

服务端收到该POST后需在10秒内返回HTTP STATUS CODE 200，视为调用成功，否则系统认为回调失败，会再次尝试。规则如下：

系统共计最多会调用3次回调URL，如果第一次失败，则等待3秒后尝试第二次，如果第二次失败，则等待5秒后尝试第三次，如果第三次失败，则不再尝试。

回调URL超时时间10秒。

---

关于下载转换后的文件需支持302跳转

接口返回的下载地址（如 fileurl / fileurls）会经 HTTP 302 跳转到实际文件。浏览器会自动跟随。

以下方式默认会跟随跳转，一般无需额外配置：

wget、Python requests / urllib、Node.js axios / got / fetch、Java OkHttp / HttpURLConnection、Go net/http、C# HttpClient、PHP file_get_contents、Objective-C / Swift NSURLSession / URLSession（含 Alamofire）

少数默认不跟随，需手动打开：

• curl：加 -L，如 curl -L -o out.bin "下载地址"
• Java java.net.http.HttpClient：设置 .followRedirects(HttpClient.Redirect.NORMAL)
• PHP curl 扩展：设置 CURLOPT_FOLLOWLOCATION => true

若只拿到 302 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

阿里云独有部分：

支持从阿里云OSS内网直接下载文件，目前支持的是上海地区的阿里云OSS内网：

oss-cn-shanghai-internal.aliyuncs.com

请求里的文件 URL 包含上述域名则自动支持。url 与 stampUrl 均可使用。

---

错误码表：

返回的code如果是10000，代表成功，其余是失败

附录：阿里签名方式

参考链接：

https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/use-cases/call-apis

在调用API商品时，首先您需要了解采用哪种API认证方式，云市场API商品的认证方式主要有以下两种方式。两种方式可同时使用，您可以根据不同情况来选择。

• 简单身份认证（AppCode）

• 签名认证

简单身份认证（AppCode）

简单认证（AppCode）调用API，有两种方式，一种是将AppCode放在Header中进行调用，一种是将AppCode放在Query参数中进行调用。

方式一：将AppCode放在Header中

在请求Header中添加一个Authorization参数。

Authorization字段的值的格式为APPCODE ＋ 半角空格 ＋APPCODE值。格式如下：

Authorization:APPCODE AppCode值

示例：

Authorization:APPCODE YOUR_CREDENTIAL

方式二：将AppCode放在Query中

在请求Query中添加AppCode参数（同时支持appcode , appCode , APPCODE , APPCode四种写法）。

AppCode参数的值为AppCode的值。

示例：

http://www.aliyum.com?AppCode=YOUR_CREDENTIAL

参考链接：https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/user-guide/call-an-api-operation-by-using-an-appcode

签名认证

比较复杂，推荐用阿里自己的SDK来调用，参考链接：https://help.aliyun.com/zh/api-gateway/traditional-api-gateway/user-guide/use-digest-authentication-to-call-an-api