Web Analytics
Intră în cont
Cont nou

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!"
}