九云图文档转换API_PDF_H5_企业管理

用API让世界更简单

搜索

发布需求

基础软件网站建设上云服务安全服务企业应用公司服务 AI API

API商城 > 企业管理 > 九云图文档转换API_PDF_H5

九云图文档转换API_PDF_H5

把各类文档转换成PDF、HTML5（SVG）、WORD、图片、在线预览H5、JSON（文档解析）、HTML、SVG、PPT等格式。

价格

￥ /10次（0元调用每位用户仅限购买一次）

规格:

普通版

周期:

10次

1000次

15000次

20000次

时长:

1年

自购买之日起1年有效

立即购买

加入购物车

同意《云市场服务协议》和《商品服务协议》

API参数

产品详情

客户案例

使用指南

产品价格

用户评价(0)

API参数

创建文档转换任务CreateJobs

查询转换结果GetJob

等待转换结果WaitJob

调用地址:

http,https://api9yuntu.api.bdymkt.com/v2/jobs

请求方式:

POST

支持格式:

application/json;charset=UTF-8

调用工具:

去调试

请求参数（Headers）

请求参数（Query）

请求参数（Body）

名称
类型
是否必须
示例值
描述

tasks
object
false
--
--

ConvertFile
object
false
--
--

input
array
false
--
--

output_format
string
false
pdf
--

operation
string
false
convert
--

ImportFile
object
false
--
--

url
string
false
https://yuntu-download.oss-cn-hangzhou.aliyuncs.com/demo/%E4%B9%9D%E4%BA%91%E5%9B%BEAPI%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.pdf
--

operation
string
false
import/url
--

ExportResult
object
false
--
--

input
array
false
--
--

operation
string
false
export/url
--

tag
string
false
--
--

type
string
false
string
--

请求参数（Path）

请求示例

java

python

curl

php

nodejs

示例代码使用, 需要使用Maven加入依赖

<dependency>
    <groupId>com.baidubce</groupId>
    <artifactId>api-explorer-sdk</artifactId>
    <version>1.0.3.1</version>
</dependency>

                                    
                                        
import com.baidubce.http.ApiExplorerClient;
import com.baidubce.http.AppSigner;
import com.baidubce.http.HttpMethodName;
import com.baidubce.model.ApiExplorerRequest;
import com.baidubce.model.ApiExplorerResponse;

// 创建文档转换任务CreateJobs Java示例代码
public class RequestDemo {
    public static void main(String[] args) {
        String path = "http://gwgp-faqtfqxjlt7.n.bdcloudapi.com/v2/jobs";
        ApiExplorerRequest request = new ApiExplorerRequest(HttpMethodName.POST, path);
        request.setCredentials("您的 access key", "您的 secret key");

        request.addHeaderParameter("Content-Type", "application/json;charset=UTF-8");
        
        
        

        ApiExplorerClient client = new ApiExplorerClient(new AppSigner());

        try {
          ApiExplorerResponse response = client.sendRequest(request);
          // 返回结果格式为Json字符串
          System.out.println(response.getResult());
        } catch (Exception e) {
          e.printStackTrace();
        }
    }
}
                                    

                                    点击复制代码

正常返回示例

                                    {
    "data": {
        "code": "",
        "created_at": "2021-09-26T15:25:20.279",
        "ended_at": "",
        "id": "fg4g3lt0YeHjZk54VbqsW",
        "links": {},
        "message": "",
        "percent": 0,
        "started_at": "",
        "status": "processing",
        "tag": "",
        "tasks": [
            {
                "code": "",
                "copy_of_task_id": "",
                "created_at": "2021-09-26T15:25:20.279",
                "credits": "",
                "depends_on_task_ids": [
                    "CwV1DEB2wi5bhyFOdVE7bC"
                ],
                "ended_at": "",
                "engine": "",
                "engine_version": "",
                "footerImage": "",
                "headerImage": "",
                "host_name": "",
                "id": "GWth2HYfjAUnkj90EBkB6w",
                "input": [
                    "ImportFile"
                ],
                "job_id": "",
                "links": {},
                "message": "",
                "name": "ConvertFile",
                "operation": "convert",
                "output_disposition": "",
                "output_format": "pdf",
                "pageCount": 0,
                "pages": "",
                "percent": 0,
                "priority": 0,
                "protected_mode": "",
                "qrcode_position": "",
                "qrcode_url": "",
                "result": {},
                "retry_of_task_id": "",
                "started_at": "",
                "status": "waiting",
                "storage": "",
                "timeout": -1,
                "token": "",
                "urlArray": [],
                "user_id": 0,
                "water_image": "",
                "water_opacity": "",
                "water_text": ""
            },
            {
                "code": "",
                "copy_of_task_id": "",
                "created_at": "2021-09-26T15:25:20.279",
                "credits": "",
                "depends_on_task_ids": [],
                "ended_at": "",
                "engine": "",
                "engine_version": "",
                "footerImage": "",
                "headerImage": "",
                "host_name": "",
                "id": "CwV1DEB2wi5bhyFOdVE7bC",
                "input": [],
                "job_id": "",
                "links": {},
                "message": "",
                "name": "ImportFile",
                "operation": "import/url",
                "output_disposition": "",
                "output_format": "",
                "pageCount": 0,
                "pages": "",
                "percent": 0,
                "priority": 0,
                "protected_mode": "",
                "qrcode_position": "",
                "qrcode_url": "",
                "result": {},
                "retry_of_task_id": "",
                "started_at": "",
                "status": "waiting",
                "storage": "",
                "timeout": -1,
                "token": "",
                "urlArray": [
                    "https://yuntu-download.oss-cn-hangzhou.aliyuncs.com/demo/%E4%B9%9D%E4%BA%91%E5%9B%BEAPI%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.pdf"
                ],
                "user_id": 0,
                "water_image": "",
                "water_opacity": "",
                "water_text": ""
            },
            {
                "code": "",
                "copy_of_task_id": "",
                "created_at": "2021-09-26T15:25:20.279",
                "credits": "",
                "depends_on_task_ids": [
                    "GWth2HYfjAUnkj90EBkB6w"
                ],
                "ended_at": "",
                "engine": "",
                "engine_version": "",
                "footerImage": "",
                "headerImage": "",
                "host_name": "",
                "id": "CrOnXhjy7iSkszeQ2PvHjz",
                "input": [
                    "ConvertFile"
                ],
                "job_id": "",
                "links": {},
                "message": "",
                "name": "ExportResult",
                "operation": "export/url",
                "output_disposition": "",
                "output_format": "",
                "pageCount": 0,
                "pages": "",
                "percent": 0,
                "priority": 0,
                "protected_mode": "",
                "qrcode_position": "",
                "qrcode_url": "",
                "result": {},
                "retry_of_task_id": "",
                "started_at": "",
                "status": "waiting",
                "storage": "",
                "timeout": -1,
                "token": "",
                "urlArray": [],
                "user_id": 0,
                "water_image": "",
                "water_opacity": "",
                "water_text": ""
            }
        ],
        "token": ""
    }
}

失败返回示例

错误码定义

产品详情

九云图 API 按文档转换次数收费，所支持文档最大不能超过 500 兆，格式包括：.dwg, .dwt, .dws, .dxf, .rtf, .doc, .docx, .dot, .dotx, .xls, .xlsx, .ppt, .pptx, .pps, .ppsx, .dps, .wps, .wpt, .et, .wpp, .png, .jpg, .gif, .tif, .bmp, .pdf, .txt, .java, .js, .c, .cpp, .html, .htm, .jsp, .css, .xml, .properties, .log。

API使用说明：
1.API接口：
CreateJobs：创建文档转换任务。
WaitJob：获取文档转换结果，只需调用一次即可，请求会等待转换结果直至返回成功或失败，等待时间随转换时间变化。
GetJob：获取文档转换结果，主动查询文档转换状态，推荐使用轮询查看转换结果。

2.接口调用
2.1创建转换任务（CreateJobs）
请求方式：POST
请求体（Body示例）：
{
"tasks": {
"ConvertFile": {
"input": ["ImportFile"],
"output_format": "pdf",
"operation": "convert"
},
"ImportFile": {
"url": "https://image2.9yuntu.cn/resources/api/%e4%b9%9d%e4%ba%91%e5%9b%beAPI%e4%bd%bf%e7%94%a8%e8%af%b4%e6%98%8e.docx",
"operation": "import/url"
},
"ExportResult": {
"input": ["ConvertFile"],
"operation": "export/url"
}
},
"tag": ""
}
请求体说明：
【tasks】上方的示例包括三项task：ImportFile，ConvertFile 和ExportResult。您可以根据需要重命名这些task，但是task名称中只能使用字母数字字符-和_。每个task都有一个operation，用于指定task需要执行的操作（例如：convert，import/url或export/url）。

【operation】您必须指定创建的task需要执行的操作：
"convert" —— 文档转换。
"import/url" —— 输入需转换的文档地址。
"export/url" —— 输出转换好的文档地址。

【input】本task依赖的task名称。可以将多个task名称作为数组提供。

【tag】标识转换任务的任意字符串。没有任何效果，可用于将其与您应用程序中的ID相关联。

【url】需转换的文档地址。

【output_format】转换后的文档类型：
"pdf" —— 转换成pdf文件，支持下载。
"protected-pdf" —— 转换成防复制的pdf文件，支持下载。
"docx" —— 转换成word文件，支持下载。
"pptx" —— 转换成ppt文件，支持下载。
"webview" —— 转换成在线文档，支持移动端预览，支持转发分享朋友圈，不支持下载。
"html(svg)" —— 转换成完整文档HTML，不包含任何脚本和外链，图片均以 svg 或 base64 形式内嵌，支持下载。【等等】
"html-array" —— 转换成分页HTML，支持下载。
"longimage"—— 转换成长条图片，支持下载。
"image-array"—— 转换成分页图片，支持下载。
"json" —— 输出json格式的数据，可用于自定义前端页面开发。
"svg-array" —— 转换成svg，支持下载。

2.2等待转换结果（WaitJob）
请求方式GET
请求参数（Path）：
jobId：调用CreateJobs接口获得jobId。

2.3主动查询转换结果（GetJob）
请求方式GET
请求参数（Path）：
jobId：调用CreateJobs接口获得jobId。

2.4响应参数：
status：
文档转换的状态：
"waiting" —— 文档转换任务创建成功，请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"processing" —— 文档转换处理中，请调用WaitJob查看结果或者调用GetJob轮询查看结果。
"finished" —— 文档转换成功，转换结果位于tasks对象中。
"failed" —— 文档转换失败，请重试。

客户案例

为用户提供可靠、稳定的服务

使用指南