Word 转 HTML API：DOCX 上传、公开 URL 与内联 HTML

咕咕数据 Word 转 HTML API 接收单个未加密的 DOC 或 DOCX，可上传本地文件，也可传入公开文件 URL。两种输入都返回 HTML 内容，并按 storage 提供公开下载地址或私有文件引用。

请求与参数

请求方法为 POST，示例使用 AppKey 请求头。替换本地占位凭据后再执行。

字段	类型	必填	说明
file	multipart 文件	与 url 二选一	上传单个 DOC 或 DOCX
url	表单字符串	与 file 二选一	公开 HTTP/HTTPS 文档地址
storage	表单或查询字符串	否	public 为默认值，private 返回文件引用

curl -fsS 'https://api.gugudata.com/imagerecognition/word-to-html' \
  -H 'AppKey: YOUR_APPKEY' \
  -F 'file=@./source.docx' \
  -F 'storage=private'

公开地址的输入可改用 --data-urlencode "url=https://example.com/source.docx" 与 --data-urlencode "storage=private"，并移除所有 -F 参数。URL 必须在公网可访问。上传请求与远程文件读取均受 100 MiB 限制。

响应与公开样例

先检查 HTTP 请求是否成功，再读取业务状态 DataStatus.StatusCode。业务码 100 时按下表读取结果。

字段	类型	用途
Data.html_content	字符串	可直接读取的 HTML 文档
Data.html_url	字符串	public 模式的文件地址
Data.html_file	对象	private 模式的文件引用，含 file_id

下方是 2026 年 11 月 11 日公开 Demo 的响应节选，可直接请求样例核对实际结果。

curl -fsS 'https://api.gugudata.com/imagerecognition/word-to-html/demo'

{
  "DataStatus": {
    "StatusCode": 100,
    "DataTotalCount": 1
  },
  "Data": {
    "html_url": "https://api.gugudata.com/assets/demos/word-to-html/v1/result.html",
    "html_content": "<html>\n<head><meta charset=\"utf-8\"/>\n\n<meta content=\"Microsoft Word 15 (filtered)\" name=\"Generator\"/…"
  }
}

接入验收

场景	核对内容
网页预览	先核对段落、表格和图片。第三方文档生成的 HTML 应净化或隔离后再渲染。
版式验收	用自己的 DOC、DOCX 样例检查页眉、分页和复杂表格，记录实际结果。
私有交付	保存 file_id，按官网文档生成临时下载链接。把短链按临时凭据管理。

完整参数、返回结构与接口说明见咕咕数据官方 API 文档。

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

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