API Reference

Ocriva มี RESTful API สำหรับเชื่อมต่อการประมวลผลเอกสารเข้ากับแอปพลิเคชันของคุณ

Base URL

https://api.ocriva.com

Authentication

ทุก API request ต้องมีการยืนยันตัวตนผ่าน Bearer token (JWT) หรือ API Token

ใช้ JWT

curl -X POST https://api.ocriva.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "your-password"}'

ใช้ API Token

curl https://api.ocriva.com/upload/YOUR_ORG_ID/file \
  -H "Authorization: Bearer YOUR_API_TOKEN"

ใช้ API Key (แนะนำสำหรับ Open API)

สำหรับการเชื่อมต่อจากระบบภายนอก สามารถใช้ API key ได้โดยตรง:

curl https://api.ocriva.com/v1/openapi/projects \
  -H "X-API-Key: ocr_your_api_key"

ดูรายละเอียดเพิ่มเติมที่ ภาพรวม Open API

Endpoints

อัปโหลดไฟล์

POST /upload/:organizationId/file

อัปโหลดแบบ Batch

POST /batch/:organizationId/upload

อัปโหลดหลายไฟล์พร้อมกัน (สูงสุด 50 ไฟล์)

ประวัติการประมวลผล

GET /processing-history?projectId=<id>&status=<status>&page=1&limit=20

Templates

GET /templates?projectId=<id>
POST /templates

Open API

สำหรับการเชื่อมต่อจากระบบภายนอก Ocriva มี Open API พร้อมการยืนยันตัวตนด้วย API key โดยตรง:

• ภาพรวมและการยืนยันตัวตน — Base URL, วิธีการ auth, rate limiting, error handling
• อัปโหลด — อัปโหลดไฟล์เพื่อประมวลผล
• Templates — จัดการ extraction templates
• Projects — รายการ projects
• ประวัติการประมวลผล — ดูผลลัพธ์และ export ข้อมูล
• Batch Operations — อัปโหลดและ export แบบ batch

Error Handling

{
  "statusCode": 400,
  "message": "รายละเอียดข้อผิดพลาด",
  "error": "Bad Request"
}