API Reference · Key Extraction v3

Files

อัปโหลดไฟล์ต้นทางก่อนสร้างงาน v3 ไม่รับ URL หรือ base64 ในตัว job การอัปโหลดเป็น atomic — ถ้าไฟล์ใดไม่ผ่าน จะไม่เก็บไฟล์ใดเลย

Upload files

POSThttps://backend.aksonocr.com/api/v3/key-extract/files

	ค่า
HTTP	201
Auth	`X-API-Key`
Body	multipart/form-data · ฟิลด์ files (ซ้ำได้)

Form fields

ฟิลด์	ชนิด	จำเป็น	รายละเอียด
`files`	file[]	ใช่	JPEG, PNG, WebP, HEIC, HEIF, PDF — สูงสุด 50 ไฟล์, 25 MB/ไฟล์, 100 MB รวม

MIME ตรวจจาก magic bytes ไม่เชื่อชื่อไฟล์หรือ Content-Type ของ client

ตัวอย่าง

curl -sS -X POST 'https://backend.aksonocr.com/api/v3/key-extract/files' \
  -H 'X-API-Key: <YOUR_API_KEY>' \
  -F '[email protected]' \
  -F '[email protected]'

Response 201

json

{
  "files": [
    {
      "id": "file_01J9...",
      "filename": "page-1.jpg",
      "media_type": "image/jpeg",
      "size_bytes": 481233,
      "sha256": "c9e4...",
      "pages": 1,
      "expires_at": "2026-09-07T10:00:00Z"
    }
  ],
  "request_id": "req_01J..."
}

ฟิลด์	รายละเอียด
`id`	file_id ที่ใช้ใน jobs.inputs
`pages`	จำนวนหน้า (รูป = 1)
`expires_at`	หมดอายุถ้าไม่มี job ยึด (lease)

Delete file

DELETEhttps://backend.aksonocr.com/api/v3/key-extract/files/{file_id}

สำเร็จได้ 204 และ idempotent ถ้าไฟล์ไม่มีอยู่แล้ว ถ้ามีงานที่ยังไม่จบยึดไฟล์อยู่ จะได้ 409 file_in_use

Errors

HTTP	code	เมื่อไหร่
400	`invalid_request`	ไม่มีไฟล์ หรือฟอร์มผิด
413	`payload_too_large`	เกินขนาดไฟล์หรือรวมอัปโหลด
415	`unsupported_media_type`	ชนิดไฟล์ไม่รองรับ
409	`file_in_use`	ลบขณะมี job ยึดไม่ได้

ภาพรวม Key Extraction

Jobs