跳至主要內容

尋找下一個工具

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

開啟測試台 →