API 文档
接口地址: https://api.gugudata.com/imagerecognition/pdf2format
返回格式: application/json; charset=utf-8
请求方式: POST
请求协议: HTTPS
使用说明: Data 为所选格式的完整字符串。TEXT 为提取文字;HTML 为现有文字布局且不导出图片或外部资源引用;XML 提供解析器字符与布局信息;TAG 保留连续 page 片段,不是带单根的完整 XML 文档。扫描内容不承诺文字识别,不增加 OCR。Query 与 multipart 的一致 type 和凭据保留兼容;冲突值失败。
请求示例: https://api.gugudata.com/imagerecognition/pdf2format?appkey=YOUR_APPKEY
数据预览: https://www.gugudata.com/preview/pdf2format
接口测试: https://api.gugudata.com/imagerecognition/pdf2format/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数(POST 请求参数以 application/x-www-form-urlencoded 格式、文件流以 formdata 格式传递,具体可参见下方示例代码)
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
使用本产品已授权的 AppKey,保留现有有效鉴权方式。 |
| type |
string |
是 |
无 |
text、html、xml 或 tag;按当前格式能力解析,不进行 OCR。 |
| pdffile |
string/binary |
是 |
无 |
上传一个实际 PDF 文件;通过 multipart/form-data 发送文件内容,不是服务器路径或 URL。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
真实、可读的业务参数,不包含凭据。 |
| DataStatus.StatusCode |
integer |
成功 100;参数错误 501;处理、依赖失败或超时 901。 |
| DataStatus.StatusDescription |
string |
业务状态说明。 |
| DataStatus.ResponseDateTime |
string |
接口返回时间。 |
| DataStatus.DataTotalCount |
integer |
实际结果数量。 |
| Data |
string |
所选格式的完整字符串;HTML/XML/TAG 为内容而非可执行页面。 |
{
"DataStatus": {
"RequestParameter": "{\"pdffile\":\"pdf2format-owned.pdf\",\"type\":\"text\"}",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-10-24 15:04:17.920",
"DataTotalCount": 1
},
"Data": "GuGuData PDF sample - page 1中文文档样例:日期 2026-10-23,数量 125。English facts: Sample A 125.50; Sample B 36.25.Error and JSON are valid input words.ItemValueSample A125.50\fGuGuData PDF sample - page 2中文文档样例:日期 2026-10-23,数量 125。English facts: Sample A 125.50; Sample B 36.25.Error and JSON are valid input words.ItemValueSample A125.50\f"
}