DEVELOPER DOCUMENTATION

เชื่อมต่อ OCR API

ส่งเอกสาร ติดตามสถานะ และรับข้อความกลับไปใช้ในระบบของคุณ

สถานะการเชื่อมต่อ

API ยังไม่เปิดใช้งาน ขณะนี้ OCR endpoint ตอบ 501 not_implemented ตัวอย่างด้านล่างแสดงรูปแบบ API ที่ออกแบบไว้ และยังไม่รับประมวลผลหรือคิดค่าบริการ

ProtocolHTTPS
AuthenticationAPI Key
ResponseJSON

การยืนยันตัวตน

ส่ง API Key ผ่าน HTTP header ของทุกคำขอ เก็บ Key ไว้ที่ฝั่งเซิร์ฟเวอร์ของคุณ และไม่ใส่ในโค้ดหน้าเว็บหรือ URL

HTTP header
X-API-Key: YOUR_API_KEY

ส่งเอกสาร

POST/v1/ocr

แนบไฟล์ในฟิลด์ file แบบ multipart/form-data พร้อมรหัสคำขอที่ไม่ซ้ำใน Idempotency-Key

ตัวอย่างคำขอ · cURL
curl --request POST \
  'https://ocr.doconcloud.com/v1/ocr' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  --form 'file=@document.pdf'
เงื่อนไขไฟล์ที่ออกแบบให้รองรับ
รายการเงื่อนไข
รูปแบบเอกสารJPEG, PNG, PDF
ขนาดไฟล์ไม่เกิน 20 MiB ต่อคำขอ
จำนวนหน้า PDFไม่เกิน 100 หน้า

ติดตามสถานะงาน

GET/v1/ocr/status/{job_id}

รูปแบบที่ออกแบบไว้: เมื่อส่งเอกสารสำเร็จจะได้รับ 202 Accepted พร้อม job_id จากนั้นตรวจสถานะด้วย API Key เดียวกับที่ส่งงาน

ตัวอย่างคำขอ · cURL
curl 'https://ocr.doconcloud.com/v1/ocr/status/JOB_ID' \
  --header 'X-API-Key: YOUR_API_KEY'
queuedprocessingsucceeded / failed

สถานะตอบกลับ

สถานะ 501 เป็นผลตอบกลับปัจจุบัน ส่วนสถานะอื่นเป็นข้อกำหนดสำหรับการเปิดบริการ

รหัส HTTP และความหมาย
รหัสความหมาย
202รับงานเข้าประมวลผล
401API Key ไม่ถูกต้อง หมดอายุ หรือถูกยกเลิก
402ยอดเงินหรือวงเงินไม่เพียงพอ
409รหัสคำขอเดิมถูกใช้กับข้อมูลต่างกัน
413 / 415ไฟล์ใหญ่เกินกำหนด หรือรูปแบบไม่รองรับ
429คำขอเกินอัตราที่กำหนด
501ปัจจุบันยังไม่เปิดใช้งานการประมวลผล OCR
ต้องการเชื่อมต่อกับระบบขององค์กร?

ติดต่อทีมงานเพื่อสอบถามรายละเอียดการใช้งาน

ติดต่อทีมงาน ↗