📋 Attendance System API

<?php
// Submit multiple attendance records
$biometricData = [
    [
        'status' => 300,
        'datetime' => '2025-09-15T12:40:00Z',
        'employeeIDNumber' => 'W00065',
        'biometricName' => 'Gate 7/8',
        'scanId' => 'SCAN-ID-493'
    ],
    [
        'status' => 300,
        'datetime' => '2025-09-15T12:45:00Z',
        'employeeIDNumber' => 'W00062',
        'biometricName' => 'Gate 7/8',
        'scanId' => 'SCAN-ID-473'
    ]
];

$payload = json_encode(['biometricData' => $biometricData]);

$ch = curl_init('https://api.clms.co.tz/api/submit-attendance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo "Processed: " . $result['data']['processed'] . "\n";
echo "Successful: " . $result['data']['successful'] . "\n";
echo "Failed: " . $result['data']['failed'] . "\n";
?>

// Submit multiple attendance records
const biometricData = [
    {
        status: 300,
        datetime: '2025-09-15T12:40:00Z',
        employeeIDNumber: 'W00065',
        biometricName: 'Gate 7/8',
        scanId: 'SCAN-ID-493'
    },
    {
        status: 300,
        datetime: '2025-09-15T12:45:00Z',
        employeeIDNumber: 'W00062',
        biometricName: 'Gate 7/8',
        scanId: 'SCAN-ID-473'
    }
];

const response = await fetch('https://api.clms.co.tz/api/submit-attendance', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ biometricData })
});

const result = await response.json();
console.log(`Processed: ${result.data.processed}`);
console.log(`Successful: ${result.data.successful}`);
console.log(`Failed: ${result.data.failed}`);

import requests

# Submit multiple attendance records
biometric_data = [
    {
        'status': 300,
        'datetime': '2025-09-15T12:40:00Z',
        'employeeIDNumber': 'W00065',
        'biometricName': 'Gate 7/8',
        'scanId': 'SCAN-ID-493'
    },
    {
        'status': 300,
        'datetime': '2025-09-15T12:45:00Z',
        'employeeIDNumber': 'W00062',
        'biometricName': 'Gate 7/8',
        'scanId': 'SCAN-ID-473'
    }
]

response = requests.post(
    'https://api.clms.co.tz/api/submit-attendance',
    headers={
        'Content-Type': 'application/json'
    },
    json={'biometricData': biometric_data}
)

result = response.json()
print(f"Processed: {result['data']['processed']}")
print(f"Successful: {result['data']['successful']}")
print(f"Failed: {result['data']['failed']}")

curl -X POST https://api.clms.co.tz/api/submit-attendance \
  -H "Content-Type: application/json" \
  -d '{
    "biometricData": [
        {
            "status": 300,
            "datetime": "2025-09-15T12:40:00Z",
            "employeeIDNumber": "W00065",
            "biometricName": "Gate 7/8",
            "scanId": "SCAN-ID-493"
        },
        {
            "status": 300,
            "datetime": "2025-09-15T12:45:00Z",
            "employeeIDNumber": "W00062",
            "biometricName": "Gate 7/8",
            "scanId": "SCAN-ID-473"
        }
    ]
}'

<?php
// Submit single attendance record
$data = [
    'worker_id' => 'WRK20253975',
    'check_in' => '2025-10-10 08:30:00',
    'biometric_device_id' => 'DEVICE_001',
    'check_in_location' => 'Main Entrance',
    'status' => 'present'
];

$ch = curl_init('https://api.clms.co.tz/api/submit-attendance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

// Submit single attendance record
const submitAttendance = async () => {
    const data = {
        worker_id: 'WRK20253975',
        check_in: '2025-10-10 08:30:00',
        biometric_device_id: 'DEVICE_001',
        check_in_location: 'Main Entrance',
        status: 'present'
    };

    const response = await fetch('https://api.clms.co.tz/api/submit-attendance', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify(data)
    });

    const result = await response.json();
    console.log(result);
};

submitAttendance();

import requests
import json
from datetime import datetime

# Submit single attendance record
url = 'https://api.clms.co.tz/api/submit-attendance'
headers = {
    'Content-Type': 'application/json'
}
data = {
    'worker_id': 'WRK20253975',
    'check_in': datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
    'biometric_device_id': 'DEVICE_001',
    'check_in_location': 'Main Entrance',
    'status': 'present'
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(json.dumps(result, indent=2))

curl -X POST https://api.clms.co.tz/api/submit-attendance \
  -H "Content-Type: application/json" \
  -d '{
    "worker_id": "WRK20253975",
    "check_in": "2025-10-10 08:30:00",
    "biometric_device_id": "DEVICE_001",
    "check_in_location": "Main Entrance",
    "status": "present"
  }'

{
    "success": false,
    "error": "Error message describing what went wrong",
    "timestamp": "2025-10-10 14:30:00",
    "api_version": "1.0",
    "details": {
        "field_name": "Specific validation error"
    }
}

{
    "success": false,
    "error": "Validation failed",
    "timestamp": "2025-10-10 14:30:00",
    "api_version": "1.0",
    "details": {
        "worker_id": "Worker ID or ID Number is required",
        "check_in": "Invalid datetime format. Use: Y-m-d H:i:s"
    }
}

{
    "success": false,
    "error": "Worker not found",
    "timestamp": "2025-10-10 14:30:00",
    "api_version": "1.0",
    "details": {
        "identifier": "WRK99999999",
        "message": "No worker found with the provided worker_id or id_number"
    }
}

{
    "success": false,
    "error": "Attendance already recorded for this date",
    "timestamp": "2025-10-10 14:30:00",
    "api_version": "1.0",
    "details": {
        "worker_id": "WRK20253975",
        "date": "2025-10-10",
        "suggestion": "Include check_out to update existing record"
    }
}

// Development mode - shows detailed errors
error_reporting(E_ALL);
ini_set('display_errors', 1);

// Production mode - logs errors, doesn't display
error_reporting(E_ALL);
ini_set('display_errors', 0);
ini_set('log_errors', 1);