حضور و غیاب
مدیریت زمانهای ورود و خروج کاربران.
endpointهای موجود
| Method |
Path |
توضیح |
| GET |
/api/attendance |
لیست حضور و غیاب |
| GET |
/api/attendance/summary |
خلاصه حضور و غیاب |
| GET |
/api/attendance/clocked-in |
کاربران حاضر در محل |
| GET |
/api/attendance/clock-in-out |
وضعیت ورود/خروج کاربر جاری |
| POST |
/api/attendance |
ثبت حضور جدید |
| POST |
/api/attendance/log-time/{user_id} |
ثبت ساعت کاری برای کاربر |
| GET |
/api/attendance/{id} |
جزئیات یک رکورد |
| PUT/PATCH |
/api/attendance/{id} |
بروزرسانی رکورد |
| DELETE |
/api/attendance/{id} |
حذف رکورد |
| POST |
/api/attendance/{id}/note |
ثبت یادداشت برای رکورد |
مثال دریافت لیست
curl -X GET "https://example.com/api/attendance" \
-H "Authorization: Bearer {token}"
پاسخ موفق (200)
{
"records": [
{
"id": 1,
"user_id": 1,
"clock_in": "08:30:00",
"clock_out": "17:00:00",
"date": "1403-05-15",
"status": "present"
}
],
"meta": {
"total": 22,
"current_page": 1,
"per_page": 20
}
}
خطاها
| کد |
توضیح |
| 401 |
توکن معتبر نیست |
| 403 |
دسترسی غیرمجاز |