Hướng Dẫn Tích Hợp RESTful API Của HYSMART OCR Vào Hệ Thống Core Banking & ERP
Tài liệu hướng dẫn kỹ thuật tích hợp API OCR bóc tách giấy tờ tùy thân CCCD, hóa đơn và văn bản hành chính vào hệ thống quản lý nội bộ doanh nghiệp.
Một giải pháp số hóa văn bản AI chỉ thực sự phát huy giá trị tối đa khi dữ liệu sau bóc tách được đổ tự động vào các phần mềm tác nghiệp cốt lõi như Core Banking, hệ thống quản lý văn bản điều hành (ECM), phần mềm quản trị quan hệ khách hàng (CRM) và hoạch định tài nguyên doanh nghiệp (ERP).
1. Chuẩn Kết Nối RESTful API Hiện Đại
Nền tảng HYSMART OCR v2 được thiết kế theo kiến trúc vi dịch vụ (Microservices), cung cấp sẵn cổng API RESTful với tài liệu tương tác tự động chuẩn Swagger/OpenAPI 3.0:
| Endpoint API | Chức Năng Chính | Định Dạng Trả Về |
|---|---|---|
POST /api/v2/ocr/layout |
Phân tích bố cục trang, tách vùng tiêu đề, văn bản và bảng biểu | Tọa độ Bounding Boxes + Text chuẩn JSON |
POST /api/v2/ocr/table |
Bóc tách cấu trúc bảng biểu, giữ nguyên hàng, cột và ô gộp | Bảng ma trận JSON, hỗ trợ xuất Excel binary |
POST /api/v2/ocr/idcard |
Bóc tách tự động thẻ CCCD gắn chip, CMND, hộ chiếu Việt Nam | Số định danh, Họ tên, Ngày sinh, Quê quán, Địa chỉ |
2. Quy Trình Bảo Mật & Xác Thực Kết Nối Doanh Nghiệp
Để đảm bảo giao tiếp giữa các hệ thống an toàn tuyệt đối, hệ thống hỗ trợ:
- Xác thực khóa định danh API Bearer Token với cơ chế phân quyền chi tiết theo ứng dụng.
- Kênh truyền mã hóa mTLS (Mutual TLS 1.3) nội bộ, ngăn ngừa hoàn toàn nguy cơ nghe lén Man-in-the-Middle trong mạng LAN.
- Cơ chế Rate Limit chống tấn công từ chối dịch vụ (DDoS) bảo vệ máy chủ AI luôn vận hành ổn định.
Đội ngũ kỹ sư giải pháp của HYSMART sẵn sàng cung cấp thư viện SDK mẫu (Python, Java, C#, Node.js) và hỗ trợ kỹ thuật trực tiếp để doanh nghiệp tích hợp hệ thống trong vòng 2-3 ngày làm việc.