请求说明

注意事项

接口返回的文件下载链接一般会在次日24点删除，请及时下载保存。
调用接口时，请注意文档中对应接口的参数传递方式，是否需要携带Token，防止参数混淆。
HTTP状态200表示您的HTTP请求成功，不代表文件处理成功。

请求PDF工具列表

该接口用于获取ComPDF API支持的所有PDF工具集合，可以查询各个PDF工具的URL。

请求方式

请求方式：GET
参数传递方式：Query

请求地址

https://api-server.compdf.com/server/v1/tool/support

返回参数

参数	数据类型	说明
sourceTypeName	String	源文件格式
targetTypeName	String	目标文件格式
executeTypeUrl	String	执行任务的类型

java

"code": "200",
"msg": "success",
"data": {
  {
    "sourceTypeName": "pdf",
    "targetTypeName": "docx",
    "executeTypeUrl": "pdf/docx"
  },
  {
    "sourceTypeName": "pdf",
    "targetTypeName": "jpg",
    "executeTypeUrl": "pdf/jpg"
  },
  {
    "sourceTypeName": "doc",
    "targetTypeName": "pdf",
    "executeTypeUrl": "doc/pdf"
  }
  ......
}

文件处理

这是简化的流程接口，根据您选择的 PDF 工具类型和参数，进行快速的任务处理。

请求方式：

请求方式：POST。
传参方式：Body (form-data)。

Path参数：

参数名	数据类型	描述	是否必填
executeTypeUrl	String	工具类型	是

请求参数：

参数名	数据类型	描述	是否必填
file	Array(File)	上传的文件（最多支持五个）	是
password	String	密码	否
parameter	String	文件处理参数	否
image	File	水印图片（添加图片水印时需添加）	否
language	Integer	接口错误提示语言（1、English，2、中文）	否

Parameter 字段只针对目前支持设置处理参数的功能。如没有设置参数，则会用默认值。不同功能类型对应的 JSON 格式以及字段解释见具体工具指南。

请求地址：

https://api-server.compdf.com/server/v1/process/{executeTypeUrl}

返回参数：

返回参数	数据类型	描述
taskId	String	任务id
taskFileNum	Integer	任务文件个数
taskSuccessNum	String	成功个数
taskFailNum	String	失败个数
taskStatus	String	任务状态
assetTypeId	String	使用资产类型
taskCost	String	任务费用
taskTime	Long	任务持续时间 (ms)
sourceType	Long	源文件格式
targetType	Long	目标文件格式
fileInfoDTOList	List	任务文件信息

java

"code": "200",
"msg": "success",
"data": {
    "taskId": "f416dbcf-0c10-4f93-ab9e-a835c1f5dba1",
    "taskFileNum": 1,
    "taskSuccessNum": 1,
    "taskFailNum": 0,
    "taskStatus": "TaskFinish",
    "assetTypeId": 0,
    "taskCost": 1,
    "taskTime": 1,
    "sourceType": "pdf",
    "targetType": "docx",
    "fileInfoDTOList": [
      {
        "fileKey": "ba13a2a8-1278-43d4-a9a6-7ecc28a0804f",
        "taskId": "f416dbcf-0c10-4f93-ab9e-a835c1f5dba1",
        "fileName": "test.pdf",
        "downFileName": "test.docx",
        "fileUrl": "<fileUrl>",
        "downloadUrl": "<downloadUrl>",
        "sourceType": "pdf",
        "targetType": "docx",
        "fileSize": 24475,
        "convertSize": 6922,
        "convertTime": 8,
        "status": "<status>",
        "failureCode": "",
        "failureReason": "",
        "fileParameter": "{    \"pageOptions\": \"3\"}"
      }
    ]
}

备注：

taskStatus ：任务处理状态

状态内容	状态描述
TaskStart	任务创建成功
TaskWaiting	任务等待处理
TaskProcessing	任务开始处理中
TaskFinish	任务处理完成
TaskOverdue	任务等待处理超时

获取资产详情

获取当前用户剩余资产

请求方式

请求方式：GET
参数传递方式：Query

请求地址https://api-server.compdf.com/server/v1/asset/info

返回参数

返回参数	数据类型	说明
tenantAsset	Array	资产信息
assetTypeName	String	资产类型
asset	Integer	资产余额
withholdingAsset	Integer	预扣资产总额

java

"code": "200",
"msg": "success",
"data": {
    "tenantAsset": [
      {
        "assetTypeName": "SUBSCRIPTIONS",
        "asset": 12,
        "withholdingAsset": 0
      },
      {
        "assetTypeName": "PACKAGES",
        "asset": 1,
        "withholdingAsset": 0
      }
    ]
}

获取任务列表

请求当前用户文件传输任务列表。

请求方法

请求方法：GET
参数传递方式：Query

请求参数

page:Pagination - 当前页数，非必填，不填默认为1。
size:Pagination - 每页显示项数，非必填，不填默认为10。

参数	数据类型	说明	必填项
page	Long	当前页数	否（不填默认为1）
size	Long	页数	否（不填默认为10）

请求地址

https://api-server.compdf.com/server/v1/task/list

返回参数

参数	数据类型	说明
createdBy	String	创始人
updatedBy	String	更新者
creationTime	LocalDateTime	创建时间
updateTime	LocalDateTime	更新时间
id	Long	任务主键 id
taskId	String	任务 id
taskUrl	taskUrl	任务原始文件夹
taskLoadUrl	String	任务转换文件夹
taskFileNum	Integer	任务文件数
taskSuccessNum	Integer	成功次数
taskFailNum	Integer	失败次数
taskStatus	String	任务状态
assetTypeId	Integer	使用资产类型
taskCost	Integer	任务成本
taskTime	Long	任务持续时间
callbackUrl	String	回调地址
server	String	服务器地址
sourceType	String	源文件格式
targetType	String	目标文件格式
tenantId	Long	租户 ID

java

{
    "records": [
      {
        "createdBy": null,
        "updatedBy": null,
        "creationTime": "2022-08-31 15:06:20",
        "updateTime": "2022-08-31 15:14:44",
        "id": 771751854513061888,
        "taskId": "a300c232-0a2d-4e3c-95f2-cfb4604b2018",
        "taskUrl": "",
        "taskLoadUrl": "",
        "taskFileNum": 3,
        "taskSuccessNum": 0,
        "taskFailNum": 0,
        "taskStatus": "TaskFinish",
        "assetTypeId": 0,
        "taskCost": 3,
        "taskTime": 0,
        "callbackUrl": "",
        "server": "",
        "sourceType": "pdf",
        "targetType": "docx",
        "tenantId": 1
      },
      {
        "createdBy": null,
        "updatedBy": null,
        "creationTime": "2022-08-31 15:25:24",
        "updateTime": "2022-08-31 15:26:17",
        "id": 771756653954465793,
        "taskId": "e74d60a6-fbd3-4d7d-9efa-0dc70297ee0b",
        "taskUrl": "",
        "taskLoadUrl": "",
        "taskFileNum": 3,
        "taskSuccessNum": 3,
        "taskFailNum": 0,
        "taskStatus": "TaskFinish",
        "assetTypeId": 0,
        "taskCost": 3,
        "taskTime": 3,
        "callbackUrl": "",
        "server": "",
        "sourceType": "pdf",
        "targetType": "docx",
        "tenantId": 1
      }
    ],
    "total": 528,
    "size": 2,
    "current": 1,
    "orders": [],
    "optimizeCountSql": true,
    "searchCount": true,
    "countId": null,
    "maxLimit": null,
    "pages": 264
}

请求说明 ​

注意事项 ​

请求PDF工具列表 ​

文件处理 ​

获取资产详情 ​

获取任务列表 ​

请求说明

注意事项

请求PDF工具列表

文件处理

获取资产详情

获取任务列表