公共 OpenAPIPDF
GET
/openapi/v1/pdf/get_task查询当前 OAuth 应用创建的 PDF 任务状态。任务状态包括 queued、processing、succeeded 和 failed。
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Query Parameters
task_id*string
创建任务时返回的任务 ID。
Format
uuidResponse Body
application/json
curl -X GET "https://example.com/openapi/v1/pdf/get_task?task_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "code": 0, "message": "获取 PDF 任务状态成功", "data": { "task_id": "8dc4a3d8-38f0-4870-9794-62fd00ad04c2", "operation": "optimize", "status": "succeeded", "original_names": [ "input.pdf" ], "result_name": "optimized.pdf", "result_size": 238912, "result_available": true, "created_at": "2026-08-31T10:00:00+08:00", "started_at": "2026-08-31T10:00:01+08:00", "finished_at": "2026-08-31T10:00:03+08:00", "expires_at": "2026-08-31T11:00:03+08:00" }, "time": 1788141603}Empty
Empty
Empty
Empty
创建 PDF 处理任务 POST
上传 PDF 并创建异步处理任务。单个任务上传文件总大小不能超过 100 MiB。 ## 文件要求 - 除 `merge` 外，每个任务必须且只能上传一个 `file` PDF。 - `merge` 使用重复的 `file` 或 `files` 字段上传 2-20 个 PDF，按上传顺序合并。 - `form_fill` 还必须通过 `data` 上传一个 JSON 文件。 ## 操作参数 - `trim` 必须提供 `pages`。 - `watermark` 必须提供 `watermark_text`。 - `encrypt` 必须提供 `owner_password`。 - `pages` 使用 pdfcpu 页面选择语法，例如 `1-3,5`、`odd` 或 `even`。
下载 PDF 任务结果 GET
下载当前 OAuth 应用已完成任务的结果。结果可能是 PDF、ZIP 或 JSON 文件。 成功结果保留一小时，响应通过 Content-Disposition 提供下载文件名。