跳到主要内容

查找下一个工具

API/参考/创建处理作业
POST/api/v1/jobs

创建处理作业

提交异步处理操作,并获得稳定的作业标识符。

认证

API 密钥

权限范围

jobs:create

契约

API v1

请求

curl -X POST 'https://api.maxscanner.app/api/v1/jobs' \
  -H 'Authorization: Bearer $MAXSCANNER_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: unique-request-id' \
  -d '{ "filename": "invoice.docx", "inputFormat": "docx", "format": "pdf", "sourceKey": "users/USER/uploads/invoice.docx" }'

请求体

{ "filename": "invoice.docx", "inputFormat": "docx", "format": "pdf", "sourceKey": "users/USER/uploads/invoice.docx" }

响应

{ "jobId": "job_123", "status": "queued", "statusUrl": "/api/v1/jobs/job_123" }

实现说明

  • 使用 Idempotency-Key 安全地重试。
  • 当工作节点满载时,作业可能会一直排队。

试用此端点

在将端点接入应用之前,先用 API 测试台完成认证并安全地测试。

打开测试台 →