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 測試台完成驗證並安全地測試。
開啟測試台 →