HTML 转 Word API：HTML 与 URL 输入、DOCX 输出和版式核对

HTML 转 Word API 可把 HTML 正文或公开网页转为可编辑的 DOCX。请求用 type 指定输入类型，用 content 传正文或地址。可选择公开链接或归属当前应用的私有文件引用。

请求与参数

使用 POST /imagerecognition/html2word，下例的请求格式为 application/x-www-form-urlencoded。示例使用占位凭据 YOUR_APPKEY。

参数	类型	含义
type	必填字符串	HTML 对应直接传入的正文，URL 对应公开网页。
content	必填字符串	完整 HTML 或公开 HTTP/HTTPS 地址。
filename	可选字符串	只传名称，不传扩展名或服务器路径。输出为 DOCX。
storage	public 或 private	默认 public。私有模式由文件所属应用控制下载。

curl -sS 'https://api.gugudata.com/imagerecognition/html2word' \
  -H 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --data-urlencode 'type=HTML' \
  --data-urlencode 'content=<h1>Report</h1><table><tr><th>Item</th><th>Total</th></tr><tr><td>Sample</td><td>125.50</td></tr></table>' \
  --data-urlencode 'filename=report' \
  --data-urlencode 'storage=public'

如何读取响应

字段	类型	处理方式
DataStatus.StatusCode	整数	先检查 HTTP 状态，业务状态 100 表示本次成功。
Data（public）	字符串	公开文件下载 URL。
Data（private）	对象	包含 storage、file_id、file_name、content_type、size_bytes、index。下载时用所属应用获取短期链接。

公开 Demo 与响应摘录

读取日期为 2026-11-09。已读取的公开 Demo 返回 DOCX 下载地址。下方将地址替换为示例域名，完整值以 Demo 当次响应为准。

curl -sS 'https://api.gugudata.com/imagerecognition/html2word/demo'

{
  "DataStatus": {
    "StatusCode": 100,
    "DataTotalCount": 1
  },
  "Data": "https://example.invalid/output.docx"
}

接入时的检查项

场景	检查
表格检查	打开输出 DOCX，核对表格行列、金额与小数位。原页面使用复杂 CSS 时增加一份代表性样本。
图片检查	检查是否保留需要的插图及其可读性。图片可能被重新采样，图表细节以实际输出为准。
可编辑性	选择几段正文和表格单元格验证可编辑。输出是 Word 文档，浏览器布局和 Word 排版可能不同。

拿到 DOCX 后如何验收

公开 Demo 的 DOCX 包中可读取正文结构，当天样本包含 1 张表格、2 个媒体文件。这个检查说明样本含有这些元素。接入自己的模板时，还要逐项核对中文和英文、数字与金额、表格单元格和图片清晰度。复杂模板可以先抽取一页作为试转样本。

GuGuData 官方接口文档

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/fooqiu/article/details/170339589