Integration API Reference

The TitanGrid backend provides a strictly authenticated REST API built with Django REST Framework (DRF). This layer facilitates interaction between the presentation frontend, mobile applications, and external reporting integrations.

All endpoints require bearer token authorization.

1. Core Ingestion Endpoint

Used by external multi-vendor network translators to stream normalized events directly into the core validation queue.

Operation Details

• Endpoint: POST /api/biometric/ingest/
• Headers: Content-Type: application/json and Authorization: Token YOUR_SECRET_KEY
• Action: The system receives the flat JSON object, validates the device serial against the registered hardware table, checks the employee code against active personnel, and commits the transaction to the immutable AttendanceLog.

{
  "device_serial": "DS-K1T671M-12345",
  "employee_code": "EMP-9042",
  "timestamp": "2026-06-07T06:14:00Z",
  "verification_type": "face"
}

{
  "status": "success",
  "ledger_id": 89342,
  "message": "Transaction committed to immutable log."
}

2. Dynamic Timesheet Gateway

Fetches the dynamically computed data matrices used to populate the premium A4 printable timesheet preview screen on the frontend.

Operation Details

• Endpoint: GET /api/attendance-records/report-employee-timesheet/
• Query Parameters: ?employee_id=EMP-9042&start_date=2026-06-01&end_date=2026-06-07
• Action: The background engine queries the AttendanceRecord matrix. It calculates total grace periods, identifies late punches, formats the math into readable hour/minute strings, and bundles the history into an array for the React frontend to map over.

GET /api/attendance-records/report-employee-timesheet/

Params:
- employee_id: "EMP-9042"
- start_date: "2026-06-01"
- end_date: "2026-06-07"

{
  "meta": {
    "employee_name": "Martin Jacob",
    "department_name": "Human Resources"
  },
  "summary": {
    "total_late_formatted": "0h 14m",
    "total_worked_formatted": "39h 45m"
  },
  "records": [
    {
      "work_date": "2026-06-05",
      "shift_name": "Day Shift",
      "clock_in": "08:14",
      "clock_out": "17:00",
      "late_minutes": 14,
      "is_late": true
    }
  ]
}