WFShift REST API v2 – Használati dokumentáció

1) get_employee

Dolgozók listázása vagy egy dolgozó lekérése.

Összes dolgozó

{
  "action": "get_employee"
}

{
  "success": true,
  "data": [
    {
      "ID": 5,
      "CompanyID": 3,
      "LocationID": 1,
      "Name": "Fejlesztő Atti",
      "Email": "atti@ceg.hu",
      "Phone": "+36...",
      "CardSN": "ABC123",
      "Position": "Fejlesztő",
      "Activated": 1
    }
  ]
}

Egy dolgozó (id alapján)

{
  "action": "get_employee",
  "id": 5
}

{
  "success": true,
  "data": {
    "ID": 5,
    "CompanyID": 3,
    "LocationID": 1,
    "Name": "Fejlesztő Atti",
    "Email": "atti@ceg.hu",
    "Phone": "+36...",
    "CardSN": "ABC123",
    "Position": "Fejlesztő",
    "Activated": 1
  }
}

2) get_shift

Beosztások lekérdezése több, kombinálható szűrővel.

Összes shift

{
  "action": "get_shift"
}

User + dátum + típus kombinálva

{
  "action": "get_shift",
  "id": 5,
  "date": "2026-01-10 10:00:00",
  "stid": 2
}

Példa válasz (rövidítve)

{
  "success": true,
  "data": [
    {
      "ID": 123,
      "UserID": 5,
      "Name": "Fejlesztő Atti",
      "ShiftDate": "2026-01-10",
      "Shift_Start": "2026-01-10 09:00:00",
      "Shift_End": "2026-01-10 18:00:00",
      "Registrated_WorkTime": 480,
      "Planed_WorkTime": 480,
      "Work_Event_ID": 2,
      "WorkEventName": "Fejlesztés",
      "Fizetett": 1,
      "Aktiv": 1,
      "Approved": 0,
      "GPS": "..."
    }
  ]
}

3) get_freedays

Szabadság összesítő (User tábla + Shifts alapján számolt mezők). Ha kapsz id-t, akkor 1 user; ha nem, akkor minden user.

Egy user szabadság összesítő

{
  "action": "get_freedays",
  "id": 5
}

Összes user összesítő

{
  "action": "get_freedays"
}

Válasz mezők

{
  "UserID": 5,
  "Name": "Fejlesztő Atti",
  "SocialSecurityNumber": "...",
  "Position": "Fejlesztő",
  "FreeDays": 27,
  "Available_FreeDays": 25,
  "UsedDays": 2,
  "PendingPaidFreeDays": 1,
  "UnpaidInactiveDays": 0
}

PendingPaidFreeDays = fizetett + nem aktív + nem jóváhagyott, aktuális évben.
UnpaidInactiveDays = nem fizetett + nem aktív, aktuális évben.

4) orgchart

Org chart generálás. Az API válasza SVG (Content-Type: image/svg+xml).

Kérés

{
  "action": "orgchart"
}

Válasz

<svg xmlns="http://www.w3.org/2000/svg" ...>...</svg>

Postmanben a “Visualize/Preview” nézetben megjelenik. Frontendben <img src="data:image/svg+xml;..."> vagy sima fetch + DOM-ba illesztés.

5) employee (CRUD egy végponton)

action="employee" és employee-action vezérli a műveletet: add | update | disabled | delete.

ADD (random jelszó + email küldés)

{
  "action": "employee",
  "employee-action": "add",
  "name": "Teszt Béla",
  "email": "teszt@ceg.hu",
  "position": "Junior fejlesztő",
  "manager_id": 3
}

{
  "success": true,
  "employee_action": "add",
  "user_id": 101
}

UPDATE

{
  "action": "employee",
  "employee-action": "update",
  "id": 101,
  "position": "Medior fejlesztő"
}

DISABLED

{
  "action": "employee",
  "employee-action": "disabled",
  "id": 101
}

DELETE

{
  "action": "employee",
  "employee-action": "delete",
  "id": 101
}

6) positions (CRUD)

position-action: add | update | delete

ADD

{
  "action": "positions",
  "position-action": "add",
  "location_id": 2,
  "name": "Senior fejlesztő",
  "description": "Backend senior pozíció",
  "min_count": 1,
  "max_count": 3,
  "wage_bruto": 1200000,
  "wage_neto": 800000,
  "wage_type": "monthly"
}

UPDATE

{
  "action": "positions",
  "position-action": "update",
  "id": 7,
  "max_count": 4
}

DELETE

{
  "action": "positions",
  "position-action": "delete",
  "id": 7
}

7) work-event-types (CRUD)

work-event-action: add | update | delete

ADD

{
  "action": "work-event-types",
  "work-event-action": "add",
  "name": "Szabadság",
  "code": "HOLIDAY",
  "color_code": "#4CAF50",
  "ActiveWork": 0,
  "is_paid": 1,
  "is_absence": 1,
  "CountsAgainstHoliday": 1,
  "multiplier": 1.0
}

UPDATE

{
  "action": "work-event-types",
  "work-event-action": "update",
  "id": 4,
  "color_code": "#FF9800",
  "multiplier": 1.25
}

DELETE

{
  "action": "work-event-types",
  "work-event-action": "delete",
  "id": 4
}

8) benefits (CRUD)

benefit-action: add | update | delete

ADD

{
  "action": "benefits",
  "benefit-action": "add",
  "location_id": 1,
  "benefit_name": "Cafeteria",
  "benefit_type": "monthly",
  "benefit_brutto": 50000,
  "benefit_neto": 35000
}

UPDATE

{
  "action": "benefits",
  "benefit-action": "update",
  "id": 6,
  "benefit_brutto": 60000
}

DELETE

{
  "action": "benefits",
  "benefit-action": "delete",
  "id": 6
}

9) card-records (lekérdezés, kombinálható szűrők)

CardRecords lekérdezése: összesen / szűrve user_id, from, to, reader_id, card_sn, location_id alapján (szabadon kombinálható).

Összes rekord

{
  "action": "card-records"
}

User + időintervallum + location

{
  "action": "card-records",
  "user_id": 5,
  "from": "2026-01-01 00:00:00",
  "to": "2026-01-31 23:59:59",
  "location_id": 2
}

ReaderID + CardSN

{
  "action": "card-records",
  "reader_id": "ENTRANCE_1",
  "card_sn": "ABC123"
}

Válasz (rövidítve)

{
  "success": true,
  "count": 2,
  "data": [
    {
      "ID": 9001,
      "UserID": 5,
      "UserName": "Fejlesztő Atti",
      "CardSN": "ABC123",
      "ReaderID": "ENTRANCE_1",
      "LocationID": 2,
      "Address": "Főbejárat",
      "ReadDateTime": "2026-01-10 08:58:12"
    }
  ]
}