文档转 HTML

概述

使用流程

由于转换需要时间，文件越大页数越多，转换越久，故默认采用异步的方式获得转换结果。即调用转换接口后会获得token，随后有2种方式查询转换结果：

1. 定时轮询结果，调用“查询结果接口”。详细见：查询结果
2. 回调，设置callbackurl，当转换结束后，系统会回调该URL直接推送转换结果。详细见：回调URL

调用转换接口

v1和v2接口功能相同，调用方式不一样。v2支持同步转换，v1不支持，推荐用v2接口。

v2接口统一为HTTP POST JSON：

• JSON支持输入：文件url；文件Base64字符串；多张图片的url。见：文档转换_v2
• v2版本的API除了异步，还支持同步调用，见：同步调用
• v2版本中的参数如果未出现在v1版本中，v1版本用同样参数也能工作

v1接口包括3种转换方式：

• 单一文档转为HTML，文档是一个下载链接，用HTTP GET方式，见：文档转换GET_v1
• 单一文档转为HTML，文档POST到服务器，用HTTP POST Form Data方式，见：文档转换POST_v1
• 多个图片转为HTML，文档是多个下载链接，用HTTP POST JSON方式，见：多张图片转换POST_v1

调用转换API需要签名，详细见文档附录：阿里签名 调用查询结果API无需签名。

---

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

文档转换_v2

异步url：

https://all2html.market.alicloudapi.com/v2/convert_async

同步url：

https://all2html.market.alicloudapi.com/v2/convert_sync

HTTP方式： POST

Header中的Content-Type传入application/json

Body是JSON格式，支持以下3种输入源文件的方法：

方法1: 文件url，最大1500M：

{"input": ["http://xxx.docx"]}

方法2: 文件Base64字符串，注意需要传入type（源文档类型），Base64字符串最大8M：

{"input": ["base64字符串"], "type": "docx"}

方法3: 多张图片url，注意只能是图片.

{"input": ["http://xxx.jpg", "http://xxx.png"]}

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

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

支持以下源文件格式：

自定义参数:

请求示例:

• 例1: 把word文件转为HTML

{"input": ["http://xxx.docx"]}

• 例2: 把2张图片转为HTML，并识别图中文字，去除图片，转为矢量文字可选的HTML

{"input":["http://xxx.jpg", "http://xxx.png"], "ocr":1, "clean":1, "text":1}

• 例3: 把Excel文件转为HTML，并只包含有内容的单元格，加上水印"度慧科技"

{"input":["http://xxx.xlsx"], "exceluseprintarea":2, "watermark":"度慧科技"}

• 例4: 把 Excel 文件转为 HTML，并将每张工作表调整为一页

{"input":["http://xxx.xlsx"], "excelpagefitmode":2}

返回数据结构【异步】:

result:

返回示例(成功状态)【异步】:

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

返回示例(失败状态)【异步】:

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

同步调用

同步调用的最大返回时间是60秒，如果60秒内转换结束则直接返回结果。否则会返回token，之后和异步方式一样可以调用查询结果接口查询该token的转换结果。所以同步调用如果传入的文件过大，无法保证在60秒内结束，则转为异步流程。

返回数据结构【同步】:

result:

返回示例(成功状态)【同步】:

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

返回示例(超时状态)【同步】:

{
	"code": 40500,
	"msg": "Timeout, query token later",
	"token": "YOUR_CREDENTIAL"
}

查询结果

请求参数:

请求示例:

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

无需签名，无调用次数限制

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

返回数据结构:

result:

返回示例(成功状态):

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

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

返回示例(失败状态):

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

备注：

• 文件url方式支持文件大小 1500M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

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

---

回调URL：

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

当设置了回调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.html",
		"count":10,
		"filesize":17747
	}
}

服务端收到该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

文档转换GET或多张图片转换POST里的url地址包含上述域名则自动支持

---

错误码表：

返回的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

附录：旧v1接口

文档转换GET_v1

将文档下载地址url转换为HTML，type是源文档的type，比如要把docx转为html，type就是docx

请求参数:

请求示例:

https://all2html.market.alicloudapi.com/v1/convert?url=https%3a%2f%2fxxx%2fxxx.docx

将所在url地址的docx文件转为HTML，type就是源文件的type，这个例子里就是docx

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

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

支持多种文件格式，具体如下（type可传入如下格式）：

支持多种文件格式，具体如下（type可传入如下格式）：

返回数据结构:

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

文档转换POST_v1

直接将单个文档POST到服务器，大小限制8M

请求参数:

请求示例:

https://all2html.market.alicloudapi.com/v1/convert_post

Header中的Content-Type必须是multipart/form-data

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

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

支持多种文件格式，type可传入如下格式：

返回数据结构:

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

多张图片转换POST_v1

将多张图片转换为html，url传入多张图片的地址，传入非图片格式无效

Header中的Content-Type传入application/json

POST Body传入JSON，格式如下：

请求参数BODY:

请求示例:

https://all2html.market.alicloudapi.com/v1/convert

传入的Body为JSON格式，如下：

{"url": ["http://xxx/xxx1.png", "http://xxx/xxx2.png"]}

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

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

例如要把多张图片OCR，变为文字可选的HTML，并且将斜的文字矫正，将图片背景去除，那么JSON就是：

{"url": ["http://xxx/xxx1.png", "http://xxx/xxx2.png"], "ocr":1, "deskew":1, "clean":1}

支持几乎所有图片格式

返回数据结构:

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

概述

2种转换方式

• 单一文档转为HTML，文档是一个下载链接，用HTTP GET方式，见：文档转换GET
• 多个图片转为HTML，文档是多个下载链接，用HTTP POST方式，见：多张图片转换POST

基本用法

由于转换需要时间，文件越大页数越多，转换越久，故系统采用异步的方式获得转换结果。调用转换接口后会获得token，随后有2种方式查询转换结果：

1. 用HTTP GET方式，轮询“查询 query接口”获得结果。详细见：查询 QUERY
2. 设置callbackurl，当转换结束后，系统会回调该URL直接推送转换结果。详细见：回调URL

API调用需要签名，详细见文档附录：百度签名

文档转换GET

将文档下载地址url转换为HTML，type是源文档的type，比如要把docx转为html，type就是docx

请求参数：

请求示例：

https://all2html.api.bdymkt.com/v1/convert?url=https%3a%2f%2fxxx%2fxxx.docx

将所在url地址的docx文件转为HTML，type就是源文件的type，这个例子里就是docx

必须签名才能调用成功，签名见百度签名规则：

https://cloud.baidu.com/doc/APIGW/s/Ljx2m1qc4

支持多种文件格式，具体如下（type可传入如下格式）：

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

多张图片转换POST

将多张图片转换为html，url传入多张图片的地址，传入非图片格式无效

Header中的Content-Type传入application/json

POST Body传入JSON，格式如下：

请求参数BODY：

请求示例：

https://all2html.api.bdymkt.com/v1/convert

传入的Body为JSON格式，如下：

{ "url": [ "http://xxx/xxx1.png","http://xxx/xxx2.png" ]}

必须签名才能调用成功，签名见百度签名规则：

https://cloud.baidu.com/doc/APIGW/s/Ljx2m1qc4

例如要把多张图片OCR，变为文字可选的HTML，并且将斜的文字矫正，将图片背景去除，那么JSON就是：

{ "url": [ "http://xxx/xxx1.png","http://xxx/xxx2.png" ], "ocr": 1, "deskew": 1, "clean": 1 }

支持几乎所有图片格式

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

查询 QUERY

请求参数：

请求示例：

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

无需签名，无调用次数限制

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

返回数据结构：

result:

返回示例(成功状态):

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

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

返回示例(失败状态):

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

注意：

• 上传文件大小不能超过1500M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

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

回调URL：

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

当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

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

Body为JSON格式，内容和Query的结果相同，例如：

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

服务端收到该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 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

错误码表：

附录：百度签名方式

参考链接：

https://cloud.baidu.com/doc/APIGW/s/Ljx2m1qc4

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

简单身份认证（AppCode）

简单认证（AppCode）调用API，将AppCode放在Header中

在请求Header中添加一个X-Bce-Signature参数。

示例：

X-Bce-Signature: AppCode/YOUR_APPCODE

签名认证

比较复杂，推荐用百度自己的SDK来调用，参考链接：https://cloud.baidu.com/doc/Reference/s/njwvz1yfu

概述

3种转换方式

• 单一文档转为HTML，文档是一个下载链接，用HTTP GET方式，见：文档转换GET
• 单一文档转为HTML，文档POST到服务器，用HTTP POST方式，见：文档转换POST
• 多个图片转为HTML，文档是多个下载链接，用HTTP POST方式，见：多张图片转换POST

基本用法

由于转换需要时间，文件越大页数越多，转换越久，故系统采用异步的方式获得转换结果。调用转换接口后会获得token，随后有2种方式查询转换结果：

1. 用HTTP GET方式，轮询“查询 query接口”获得结果。详细见：查询 QUERY
2. 设置callbackurl，当转换结束后，系统会回调该URL直接推送转换结果。详细见：回调URL

API调用需要签名，详细见华为官方签名：

https://support.huaweicloud.com/usermanual-apig/apig-ug-0011.html

文档转换GET

将文档下载地址url转换为HTML，type是源文档的type，比如要把docx转为html，type就是docx

请求参数：

请求示例：

http://all2html.apistore.huaweicloud.com/v1/convert?url=https%3a%2f%2fxxx%2fxxx.docx&type=docx

将所在url地址的docx文件转为HTML，type就是源文件的type，这个例子里就是docx

必须签名才能调用成功，签名见华为签名规则：

支持多种文件格式，具体如下（type可传入如下格式）：

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

文档转换POST

直接将单个文档POST到服务器，大小限制12M

请求参数：

请求示例：

http://all2html.apistore.huaweicloud.com/v1/convert_post

Header中的Content-Type必须是multipart/form-data

必须签名才能调用成功，签名见华为签名规则：

支持多种文件格式，具体如下（type可传入如下格式）：

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

多张图片转换POST

将多张图片转换为html，url传入多张图片的地址，传入非图片格式无效

Header中的Content-Type传入application/json

POST Body传入JSON，格式如下：

请求参数BODY：

请求示例：

http://all2html.apistore.huaweicloud.com/v1/convert

传入的Body为JSON格式，如下：

{ "url": [ "http://xxx/xxx1.png","http://xxx/xxx2.png" ]}

必须签名才能调用成功，签名见华为签名规则：

例如要把多张图片OCR，变为文字可选的HTML，并且将斜的文字矫正，将图片背景去除，那么JSON就是：

{ "url": [ "http://xxx/xxx1.png","http://xxx/xxx2.png" ], "ocr": 1, "deskew": 1, "clean": 1 }

支持几乎所有图片格式

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

查询 QUERY

请求参数：

请求示例：

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

无需签名，无调用次数限制

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

返回数据结构：

result:

返回示例(成功状态):

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

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

返回示例(失败状态):

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

注意：

• 上传文件大小不能超过1500M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

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

回调URL：

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

当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

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

Body为JSON格式，内容和Query的结果相同，例如：

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

服务端收到该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 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

错误码表：

概述

3种转换方式

• 单一文档转为HTML，文档是一个下载链接，用HTTP GET方式，见：文档转换GET
• 单一文档转为HTML，文档POST到服务器，用HTTP POST方式，见：文档转换POST
• 多个图片转为HTML，文档是多个下载链接，用HTTP POST方式，见：多张图片转换POST

基本用法

由于转换需要时间，文件越大页数越多，转换越久，故系统采用异步的方式获得转换结果。调用转换接口后会获得token，随后有2种方式查询转换结果：

1. 用HTTP GET方式，轮询“查询 query接口”获得结果。详细见：查询 QUERY
2. 设置callbackurl，当转换结束后，系统会回调该URL直接推送转换结果。详细见：回调URL

API调用需要签名，详细见文档附录：腾讯签名规则

由于腾讯云网关迁移的关系，故新老用户拿到的 SecretID 不同，老用户SecretID以AKID开头的，请使用V1域名和签名。新用户使用v2域名和签名。 注意：v1和v2调用api的域名不一样。

文档转换GET

将文档下载地址url转换为HTML，type是源文档的type，比如要把docx转为html，type就是docx

请求参数：

请求示例：

v2域名:

https://ap-shanghai.cloudmarket-apigw.com/service-o8jszuu9/v1/convert?url=https%3a%2f%2fxxx%2fxxx.docx

v1域名:

https://service-o8jszuu9-1256652084.sh.apigw.tencentcs.com/release/v1/convert?url=https%3a%2f%2fxxx%2fxxx.docx

将所在url地址的docx文件转为HTML，type就是源文件的type，这个例子里就是docx

必须签名才能调用成功，签名见腾讯签名规则：

支持多种文件格式，具体如下（type可传入如下格式）：

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

文档转换POST

直接将单个文档POST到服务器，大小限制10M

请求参数：

请求示例：

v2域名:

https://ap-shanghai.cloudmarket-apigw.com/service-o8jszuu9/v1/convert_post

v1域名:

https://service-o8jszuu9-1256652084.sh.apigw.tencentcs.com/release/v1/convert_post

Header中的Content-Type必须是multipart/form-data

必须签名才能调用成功，签名见腾讯签名规则：

支持多种文件格式，具体如下（type可传入如下格式）：

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

多张图片转换POST

将多张图片转换为html，url传入多张图片的地址，传入非图片格式无效

Header中的Content-Type传入application/json

POST Body传入JSON，格式如下：

请求参数BODY：

请求示例：

v2域名:

https://ap-shanghai.cloudmarket-apigw.com/service-o8jszuu9/v1/convert

v1域名:

https://service-o8jszuu9-1256652084.sh.apigw.tencentcs.com/release/v1/convert

传入的Body为JSON格式，如下：

{ "url": [ "http://xxx/xxx1.png","http://xxx/xxx2.png" ]}

必须签名才能调用成功，签名见腾讯签名规则：

例如要把多张图片OCR，变为文字可选的HTML，并且将斜的文字矫正，将图片背景去除，那么JSON就是：

{ "url": [ "http://xxx/xxx1.png","http://xxx/xxx2.png" ], "ocr": 1, "deskew": 1, "clean": 1 }

支持几乎所有图片格式

返回数据结构：

result:

返回示例(成功状态):

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

返回示例(失败状态):

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

查询 QUERY

请求参数：

请求示例：

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

无需签名，无调用次数限制

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

返回数据结构：

result:

返回示例(成功状态):

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

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

返回示例(失败状态):

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

注意：

• 上传文件大小不能超过1500M。
• 最大转换时长：1小时，超过时间未完成则自动失败。
• 转换完成后，下载链接有效时间：1小时。

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

回调URL：

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

当设置了回调URL，转换结束后（无论成功失败），系统都会尝试调用该URL，具体如下：

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

Body为JSON格式，内容和Query的结果相同，例如：

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

服务端收到该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 响应、本地没有文件内容，多半是未跟随跳转，按上面说明打开对应选项即可。

---

错误码表：

附录：腾讯签名方式

腾讯云市场接口分V1和V2

新老用户拿到的 SecretID 不同，老用户SecretID以AKID开头的，请使用V1对应签名。新用户使用V2对应签名。新购用户都是V2签名。

V2签名：

https://cloud.tencent.com/document/product/306/57449

建议使用腾讯提供的各种语言的SDK，例如Java：

https://cloud.tencent.com/document/product/306/57449#Java

V1签名：

参考链接：

https://cloud.tencent.com/document/product/628/11782

建议使用腾讯提供的各种语言的SDK，例如Java：

https://cloud.tencent.com/document/product/628/42184