领取MOLI红包
CANNFINITY中文网

调用PDF转Word接口

发布日期:2025-01-04 17:01    点击次数:140
文档介绍了PDF转Word接口的调用方式,调用前,请先阅读API使用指南。返回参数名称类型描述示例值RequestIdstring请求唯一ID43A29C77-405E-4CC0-BC55-EE694AD0****Dataobject返回数据 {"Id": "docmind-20220712-b15f****"} +Idstring业务订单号,用于后续查询接口进行查询的唯一标识docmind-20220712-b15f****Codestring状态码200Messagestring详细信息message示例本接口支持本地文档上传和传入文档URL这两种调用方式。以Java SDK为例,本地文档上传调用方式的请求示例代码如下,调用submitConvertPdfToWordJobAdvance接口,通过fileUrlObject参数实现本地文档上传。JavaNode.jsPythonC#Go以Java SDK为例,传入文档URL调用方式的请求示例代码如下,调用submitConvertPdfToWordJob接口,通过fileUrl参数实现传入文档URL。请注意,您传入的文档URL必须为公网可访问下载的公网URL地址,无跨域限制,URL不带特殊转义字符。JavaNode.jsPythonC#GoPHP正常返回示例JSON格式{ "RequestId": "43A29C77-405E-4CC0-BC55-EE694AD0****", "Data": { "Id": "docmind-20220712-b15f****" } }步骤二:轮询文档转换结果查询服务GetDocumentConvertResult接口调用查询接口的入参ID就是前面异步任务提交接口返回的出参ID,查询结果有处理中、处理成功、处理失败三种情况。建议每10秒轮询一次,最多轮询120分钟。若明确返回Completed为true或者超过轮询最大时间,则终止轮询。请求参数名称类型必填描述示例值Idstring是需要查询的业务订单号,订单号从提交接口的返回结果中获取docmind-20220712-b15f****返回参数名称类型描述示例值RequestIdstring请求唯一ID43A29C77-405E-4CC0-BC55-EE694AD0****Completedboolean异步任务是否处理完成,false表示任务仍在处理中,true代表任务处理完成,有处理成功或处理失败的明确结果trueStatusstring异步任务处理完成的状态,最终处理结束后的状态。Success为处理成功,Fail为处理失败SuccessDataobject文档转换的结果,具体参数详情见下表是个列表Codestring状态码200Messagestring详细信息messageUrlString转换后的文件URL地址https://example.com/example.pdfSizeInteger转换后的文件大小,单位为字节。1345488TypeString转换后的文件后缀名,pdf转word是docxpdfMd5String转换后的文件md5值,调用者可以用于校验2d49eb7705f9f93ed857874db247****以Java SDK为例,调用文档智能解析接口的结果查询类API示例代码如下,调用getDocumentConvertResult接口,通过ID参数传入查询流水号。JavaNode.jsPythonC#GoPHP查询结果有处理中、处理成功、处理失败三种情况,分别说明每种情况的返回结果示例。处理中的返回结果如下所示:{ "RequestId": "2AABD2C2-D24F-12F7-875D-683A27C3****", "Completed": false, "Code": "DocProcessing", "Message": "Document processing", "HostId": "ocr-api.cn-hangzhou.aliyuncs.com", "Recommend": "https://next.api.aliyun.com/troubleshoot?q=DocProcessing&product=docmind-api" }处理中Completed会返回false,表示任务没有处理结束,仍在处理中。这种情况需要继续轮询,直到明确返回Completed为true或者超过轮询最大时间。处理失败的返回结果如下所示:{ "RequestId": "A8EF3A36-1380-1116-A39E-B377BE27****", "Completed": true, "Status": "Fail", "Code": "UrlNotLegal", "Message": "Failed to process the document. The document url you provided is not legal.", "HostId": "docmind-api.cn-hangzhou.aliyuncs.com", "Recommend": "https://next.api.aliyun.com/troubleshoot?q=IDP.UrlNotLegal&product=docmind-api" }处理失败Completed会返回true,表示任务处理结束,同时会返回Status为字符串的Fail,表示处理成功失败,同时会返回失败Code和详细原因Message。访问错误码可以查看错误码详细介绍。处理成功的返回结果如下所示:{ "Status": "Success", "RequestId": "73134E1A-E281-1B2C-A105-D0ECFE2D****", "Completed": true, "Data": [ { "Type": "docx", "Size": 7940, "Url": "-api-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/convert/docmind-20220902-57de****/example.docx?Expires=1662190830&OSSAccessKeyId=XX&Signature=YY", "Md5": "36256a4c2db8e31e056aeeb8b871****" } ] }处理成功Completed会返回true,表示任务处理结束,同时会返回Status为字符串的Success,表示处理成功。具体的处理结果在Data节点中,Data节点是个列表,该节点只会有1个元素,接下来介绍下Data节点中每个元素的具体格式:Type表示转换后文档的文档类型,例如该pdf转word接口返回的是docx格式的word文档。URL表示转换后文档的下载链接,每次查询请求返回的URL下载链接的有效期为60分钟,超期后该URL会失效,需要重新调用查询接口拿到新的URL下载链接。Size表示转换后文档的文件大小,单位是字节,可以用于对用户下载的转换后文档做合法性校验,比较下载的转换后文档的文件大小和接口返回的Size是否相等。Md5表示转换后文档的文件Md5摘要值,可以用于对用户下载的转换后文档做合法性校验,比较下载的转换后文档的Md5摘要值和接口返回的Md5是否相等。

栏目分类