본문으로 건너뛰기

다음 도구 찾기

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 플레이그라운드에서 인증하고 안전하게 테스트하세요.

플레이그라운드 열기 →