DocOnCloud OCR API

API สำหรับนักพัฒนาเพื่อเชื่อมต่อระบบ OCR ภาษาไทยเข้ากับแอปพลิเคชันของคุณ รองรับการอ่านบัตรประชาชน, ใบเสร็จ, และเอกสารทั่วไป ด้วยความแม่นยำสูง พร้อมโครงสร้างข้อมูล JSON ที่นำไปใช้งานต่อได้ทันที

Authentication

ในเวอร์ชัน Demo นี้ API เปิดให้ทดสอบฟรีโดยไม่ต้องใช้ Key (Rate limit: 60 requests/min)

Authorization: Bearer YOUR_API_KEY

OCR Process

POST /api/ocr

Request Body (Multipart/Form-Data)

Parameter	Type	Required	Description
file	File	Yes	ไฟล์รูปภาพ (jpg, png) หรือ pdf ขนาดไม่เกิน 20MB
doc_type	String	No	ประเภทเอกสาร (default: 'auto') Options: id_card, invoice, receipt, delivery_note, bank_slip, gov_order, general

Example Request (cURL)

curl -X POST https://api.doconcloud.com/api/ocr \
  -H "Authorization: Bearer YOUR_KEY" \
  -F "file=@/path/to/receipt.jpg" \
  -F "doc_type=auto"

Success Response (JSON)

{
  "status": "success",
  "metadata": {
    "doc_type": "receipt",
    "detected_type": "receipt",
    "pages": 1,
    "processing_time_sec": 0.85,
    "api_version": "v2.8"
  },
  "text": "ใบเสร็จรับเงิน\nร้านค้า ABC..."
}

Error Codes

Code	Description
400	Bad Request (เช่น ไฟล์ไม่ถูกต้อง, ไม่มีไฟล์แนบ)
401	Unauthorized (API Key ไม่ถูกต้อง)
413	Payload Too Large (ไฟล์ใหญ่เกิน 20MB)
500	Internal Server Error (ระบบประมวลผลขัดข้อง)