API Documentation

Domain: https://ocr.sainco.vn

GET /api/user/log_api

Header Value
X-API-Key {api_key}
Query params:
  • start_date (Y-m-d): Ngày bắt đầu lọc lịch sử
  • end_date (Y-m-d): Ngày kết thúc lọc lịch sử
JSON trả về mẫu:
{
    "status": true,
    "total": 2,
    "history": [
        {
        "type": "Nhận diện CCCD",
        "created_at": "2025-08-27 14:10:06"
        },
        {
        "type": "Nhận diện CCCD",
        "created_at": "2025-08-27 14:08:45"
        }
    ]
}
JSON trả về lỗi:
{
  "status": false,
  "message": "Có xảy ra lỗi từ hệ thống"
}

GET /api/user/balance

Header Value
X-API-Key {api_key}
JSON trả về thành công:
{
  "status": true,
  "balance": 1200000
}
JSON trả về lỗi:
{
  "status": false,
  "message": "API key không hợp lệ"
}

POST /api/license-plate

Header Value
X-API-Key {api_key}
Body: images[] (nhiều file ảnh)
Trường Ý nghĩa
images[] Ảnh biển số xe (có thể chọn nhiều ảnh)
Đặc tả các trường trong JSON trả về:
Trường Ý nghĩa
total_plates_detected Tổng số biển số xe phát hiện được từ tất cả ảnh gửi lên
duplicates_removed Số lượng biển số trùng lặp đã được loại bỏ khỏi kết quả
data Danh sách các biển số xe tìm được (mỗi phần tử là 1 biển số, không trùng lặp)
JSON trả về thành công:
{
    "success": true,
    "total_plates_detected": 3,
    "duplicates_removed": 0,
    "data": [
        "70-G1 444.44",
        "70-D1 333.33",
        "70-L1 444.44"
    ]
}
JSON trả về lỗi:
{
  "status": false,
  "message": "Có xảy ra lỗi từ hệ thống"
}

POST /api/info_cccd

Header Value
X-API-Key {api_key}
Body: image (file/base64), key (string)
Trường Ý nghĩa
image Ảnh CCCD (dạng file, hỗ trợ tối đa 2 ảnh: mặt trước và mặt sau)
JSON trả về thành công:
{
  "status": true,
  "data": {
    "full_name": "Nguyễn Văn A",
    "date_of_birth": "01/01/1999",
    "gender": "Nam",
    "nationality": "Việt Nam",
    "cccd_number": "01234567890",
    "hometown": "Q.Gò Vấp, TP.HCM",
    "address": "Q.Gò Vấp, TP.HCM"
  }
}
JSON trả về lỗi:
{
  "status": false,
  "message": "API key không hợp lệ hoặc thiếu ảnh"
}