API Name:
api_v2/users/get_today_status
We use this API to get status of iFlow users with today's attendance data.
Quick info:
Full url
Method: GET
https://app.iflow.ro/api/api_v2/users/get_today_status
CURL request
Method: GET
curl -X GET -H "Authorization: Bearer {ACCESS TOKEN}" https://app.iflow.ro/api/api_v2/users/get_today_status
Parameters:
Access token
The API access token is generated from Iflow, with a label name of your choosing and is assigned to an administrator from the company.
Language
Method: POST With api_language key and ro_RO value you can translate the status to romanian.
Attendance type
Method: POST For the attendance_type key with the values set to work_schedule or live_attendance you can get the status by live attendance or by work schedule. Default status is set by live_attendance. With live_attendance value you can also get data for live attendance like check in and check out hours, time worked between live intervals and also a total time worked on all live intervals (example on below "Returns" section).
CURL request
Method: POST curl -X POST -H "Authorization: Bearer {ACCESS TOKEN}" -d "api_language={ro_RO/en_US}&attendance_type={live_attendance/work_schedule}" https://app.iflow.ro/api/api_v2/users/get_today_status
Returns:
Ok response:
If everything is ok, you get a list of attendances with no errors.
[ { "status": "Missing, Sick Leave", "at_work": false, "full_name": "Miclea Dorian", "cnp": "2222222222222", "user_id": "3", "mark_number": "111111", "events": [ { "event_id": "485247", "user_id": "3", "event_type": "other_leave", "event_type_name": "Sick Leave", "position": 0, "consecutive_days_position": "solo", "event_type_color": "#FA28FF", "approve_status": "", "partial_approved_by_user_id": null, "other_leave_type_name": "01 - Common illness", "event_meta": { "user_id": "3", "days": 1, "start_date": "30/09/2022", "end_date": "30/09/2022", "reason_message": "" } } ] }, { "status": "At work", "at_work": true, "full_name": "Abrudan Alexandru", "cnp": "3333333333333", "user_id": "2" "mark_number": "77777", }, { "status": "At work", "at_work": true, "full_name": "Ban Alina", "cnp": "5555555555555", "user_id": "50456" "mark_number": "33333", } ]
Example of return without errors and with live_attendance value for attendance_type key.
[ { "status": "At work", "at_work": true, "full_name": "Abrudan Alexandru", "cnp": "3333333333333", "user_id": "2" "mark_number": "77777", "live_attendance": [ { "check_in": "07:00:00", "check_out": "09:33:00", "worked": "02:33:00" }, { "check_in": "10:30:00", "check_out": "10:38:00", "worked": "00:08:00" }, { "check_in": "10:40:00", "check_out": "", "worked": "00:00:00" }, { "current_time": "11:07:33", "total_worked": "02:41:00" } ] }, ]
Error response:
If an error ocurs on an attendance, you will get the text of the error on one of the error_ keys
{ "error": "Key is invalid!" }