PDF格式转换高级版 API 简介

说明

Hi，您好，欢迎使用有道智云PDF格式转换高级版 API接口服务。

本文档主要针对需要集成HTTP API的技术开发工程师，详细描述PDF格式转换能力相关的技术内容。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服QQ：1906538062

智云翻译技术交流QQ 1群: 652880659

智云翻译技术交流QQ 2群: 669384425

智云翻译技术交流QQ 3群: 807539209

智云翻译技术交流QQ 4群: 936752411

联系邮箱： zhiyun@corp.youdao.com

温馨提示：

• 本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥；如果您还没有，请按照 新手指南 获取。
• 平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费 0.15 元/页。

注：

1. 基础版和高级版接口完全独立，因此高级版上传的文件，转换进度只能通过高级版 API 查询（基础版同理）。
2. 基础版和高级版 转换任务及结果均仅保留7天，转换成功后请及时获取并保存结果。

接口说明

PDF 格式转换接口提供有道的 PDF 转换服务。您只需要通过调用 PDF 转换 API，传入文档的 Base64 编码，就可以将 PDF 文档格式进行转换。

请求流程：upload->query

BASEURL

https://openapi.youdao.com/file_convert/v2

协议须知

公共响应参数

所有接口都遵循统一的响应格式：

文件上传接口

• 接口地址

POST /upload

• 请求参数 (multipart/form-data)

签名生成方法如下：

sign = sha256(应用ID + input + salt + curtime + 应用密钥)

其中，input的计算方式为：

input = q 字符串（当q 长度小于等于20） 或 input = q 前10个字符前10个字符 + q 长度 + q 后十个字符（当q 长度大于20）

• 响应参数 (data字段结构)

• 响应示例

{
    "code": "0",
    "message": "success",
    "data": {
        "flownumber": "BAE670950ACE4C9E941A81B2959CXXXX"
    },
    "requestId": "1580715c-cf43-44d3-bb80-5dd28d1cXXXX",
    "successful": true
}

查询任务状态接口

• 接口地址

POST /query

• 请求参数 (multipart/form-data)

签名生成方法如下：

sign = sha256(应用ID + input + salt + curtime + 应用密钥)

其中，input的计算方式为：

input = flownumber字符串（当flownumber长度小于等于20）。 或 input = flownumber前10个字符前10个字符 + flownumber长度 + flownumber后十个字符（当flownumber长度大于20）

• 响应参数 (data字段结构)

• 状态码说明

• 响应示例

{
    "code": "0",
    "message": "success",
    "data": {
        "status": 4,
        "statusString": "已完成",
        "resultUrl": "https://xxx.nos-jd.163yun.com/xxx"
    },
    "requestId": "d99436d1-7445-44d3-a8e5-e711774aXXXX",
    "successful": true
}

服务配置

错误代码列表

常用语言 Demo

Python 示例

PDF格式转换 Python3 demo

Java 示例

PDF格式转换 Java demo

Go 示例

PDF格式转换 Go demo