API Reference · Key Extraction v3
Files
อัปโหลดไฟล์ต้นทางก่อนสร้างงาน v3 ไม่รับ URL หรือ base64 ในตัว job การอัปโหลดเป็น atomic — ถ้าไฟล์ใดไม่ผ่าน จะไม่เก็บไฟล์ใดเลย
Upload files
POST
https://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
ตัวอย่าง
import requestsr = requests.post("https://backend.aksonocr.com/api/v3/key-extract/files",headers={"X-API-Key": "<YOUR_API_KEY>"},files=[("files", open("page-1.jpg", "rb")),("files", open("page-2.jpg", "rb")),],)r.raise_for_status()print([f["id"] for f in r.json()["files"]])
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
DELETE
https://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 ยึดไม่ได้ |