最近开发了一个restfulapi接口,这个接口支持把文档转换成pdf格式,主要支持doc,docx,xls,xlsx,ppt,pptx 这六种格式的文件转换成pdf文件。
具体用法如下:需要测试的小伙伴可以使用chrome浏览器的插件Restlet Client测试,该插件可以在chrome的商店找到。
1.上传文档接口 https://api.iamdev.me/docConvert/convertPDF
请求方法 POST
header请求头说明
header的名字 | 说明 | 数值 |
---|---|---|
fileName | 转换后的文件名字 | 例如:test.pdf |
content-type | 转换文件的类型 | 支持ppt,pptx等文件的content-type,具体看下表 |
支持的转换文件类型和对应的content-type
content-type(mime码) | 文件后缀 |
---|---|
application/msword | doc |
application/vnd.openxmlformats-officedocument.wordprocessingml.document | docx |
application/vnd.ms-excel | xls |
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | xlsx |
application/vnd.ms-powerpoint | ppt |
application/vnd.openxmlformats-officedocument.presentationml.presentation | pptx |
RequestBody
请求body为对应的文档文件。
示例代码:以java为例
String API_URL = "https://api.iamdev.me/docConvert/convertPDF";
File docFile = new File("test.docx");
OkHttpClient client = new OkHttpClient();
RequestBody requestBody = RequestBody.create(uploadFile, "application/vnd.openxmlformats-officedocument.wordprocessingml.document");
Request request = new Request.Builder().url(API_URL).header("fileName", "test.pdf").put(requestBody).build();
Response response = client.newCall(request).execute();
ResponseBody
参数 | 参数说明 |
---|---|
errorCode | errorCode为0表示无错误 |
message | 错误信息 |
data | 获取转换后pdf的文件id |
示例:
{
"errorCode": 0,
"message": null,
"data": "2c91808a6cde34b********8850000"
}
注意事项:
1.请不要使用form表单上传,请直接以整个文件作为上传的body
2.请上传真实的文件,非文档相关的文件无法转换,单文档最大支持10MB
2.下载pdf接口 https://api.iamdev.me/docConvert/downloadPDF
请求GET
请求参数
参数 | 参数说明 |
---|---|
id | 文件id |
示例:
https://api.iamdev.me/docConvert/downloadPDF?id=2c91808a6cde34b********8850000
注意:
在上传文档之后,请尽快下载获取转换后的pdf,服务器仅保存10分钟。