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 测试台完成认证并安全地测试。
打开测试台 →