מהו endpoint הבסיסי של ה-API?

https://live.timeclock365.com/api/v1/json-rpc — כל הקריאות הן POST עם Content-Type: application/json.

איך מאמתים קריאות API?

כל קריאה חייבת לכלול Authorization: Bearer YOUR_API_TOKEN בכותרת ה-HTTP.

אילו endpoints זמינים?

sessions, lunches, timesheet, extended-sessions, groups-create, users-create, users-deactivation.

Developer API

מדריך API — TimeClock 365

חבר את המערכות הארגוניות שלך ישירות ל-TimeClock 365. JSON-RPC API עם Bearer Token — נוכחות, הפסקות, גיליונות שעות, ניהול עובדים וקבוצות.

בקש גישה ל-API צפה ב-Endpoints

פרטי חיבור

BASE URL

https://live.timeclock365.com/api/v1/json-rpc

HTTP METHOD

POST

CONTENT TYPE

application/json

פרמטר groupIds — כל endpoints של שליפת נתונים תומכים בפרמטר אופציונלי groupIds (מערך של מזהי קבוצות מהמערכת). כאשר לא מצוין, הנתונים מוחזרים עבור כל עובדי החברה.

Endpoints

אימות — דוגמת CURL

כל בקשה חייבת לכלול את ה-Bearer Token בכותרת Authorization. ניתן ליצור מפתח API תחת הגדרות ← אינטגרציות ← מפתחות API.

CURL Request

curl -X POST "https://live.timeclock365.com/api/v1/json-rpc" \
    -H "Authorization: Bearer ZTI1YWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXkNzUzZA" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "method": "timesheet",
      "params": {
        "startDate": "2026-01-01",
        "endDate": "2026-01-31"
      },
      "id": 123
    }'

יצירת קבוצות groups-create

יצירת קבוצות עובדים במערכת. ניתן ליצור מספר קבוצות בקריאה אחת.

פרמטר	סוג	תיאור
`list`	array	רשימת קבוצות ליצירה
`list[].name`	string	שם הקבוצה
`list[].externalId`	string	מזהה חיצוני (מהמערכת שלך)

בקשה

{
  "jsonrpc": "2.0",
  "method": "groups-create",
  "params": {
    "list": [
      {
        "name": "Group 001",
        "externalId": "gr-001"
      },
      {
        "name": "Group 002",
        "externalId": "gr-002"
      },
      {
        "name": "Group 003",
        "externalId": "gr-003"
      }
    ]
  },
  "id": 123
}

יצירת עובדים users-create

יצירת עובדים חדשים במערכת. ניתן ליצור מספר עובדים בקריאה אחת ולשייך אותם לקבוצות לפי externalId.

פרמטר	סוג	תיאור
`firstName`	string	שם פרטי
`lastName`	string	שם משפחה (אופציונלי)
`email`	string	כתובת אימייל
`phone`	string	מספר טלפון (אופציונלי)
`passportNumber`	string	מספר דרכון / ת.ז. (אופציונלי)
`numberForPayroll`	string	מספר עובד לשכר (אופציונלי)
`startWorkDate`	string	תאריך תחילת עבודה (YYYY-MM-DD)
`externalGroupIds`	array	רשימת externalId של קבוצות לשיוך

בקשה

{
  "jsonrpc": "2.0",
  "method": "users-create",
  "params": {
    "list": [
      {
        "firstName": "ישראל",
        "lastName": "ישראלי",
        "email": "israel.israeli@example.com",
        "phone": "+972501234567",
        "passportNumber": "4510 123456",
        "numberForPayroll": "EMP-001",
        "startWorkDate": "2026-01-15",
        "externalGroupIds": ["gr-001"]
      },
      {
        "firstName": "שרה",
        "lastName": "כהן",
        "email": "sara.cohen@example.com",
        "phone": "+972507654321",
        "startWorkDate": "2026-03-01",
        "externalGroupIds": ["gr-001", "gr-002"]
      },
      {
        "firstName": "Alex",
        "email": "alex.johnson@example.com",
        "numberForPayroll": "EMP-003",
        "startWorkDate": "2026-06-03",
        "externalGroupIds": []
      }
    ]
  },
  "id": 123
}

ביטול עובדים users-deactivation

השבתת עובדים קיימים לפי מספר דרכון/ת.ז. ותאריך סיום.

פרמטר	סוג	תיאור
`list[].passportNumber`	string	מספר דרכון / ת.ז. של העובד
`list[].date`	string	תאריך סיום עבודה (YYYY-MM-DD)

בקשה

{
  "jsonrpc": "2.0",
  "method": "users-deactivation",
  "params": {
    "list": [
      { "passportNumber": "pswd-64231", "date": "2026-06-25" },
      { "passportNumber": "pswd-64232", "date": "2026-06-25" },
      { "passportNumber": "pswd-64233", "date": "2026-06-25" }
    ]
  },
  "id": 123
}

רשימת סשנים sessions

שליפת רשומות כניסה/יציאה לטווח תאריכים. הפרמטר groupIds אופציונלי — בהיעדרו מוחזרים נתוני כל עובדי החברה.

פרמטר	סוג	תיאור
`startDate`	string	תאריך התחלה (YYYY-MM-DD)
`endDate`	string	תאריך סיום (YYYY-MM-DD)
`groupIds`	array	אופציונלי — מסנן לפי מזהי קבוצות

בקשה

{
  "jsonrpc": "2.0",
  "method": "sessions",
  "params": {
    "startDate": "2025-10-08",
    "endDate": "2025-10-15",
    "groupIds": [2067, 3426]
  },
  "id": 121
}

תגובה

{
  "jsonrpc": "2.0",
  "id": 121,
  "result": [
    {
      "employeeNumber": 1265,
      "email": "email@mail.com",
      "sessions": [
        {
          "startDate": "2024-10-09 08:12:34",
          "endDate": "2024-10-09 17:18:34",
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "phone"
        },
        {
          "startDate": "2024-10-10 08:12:34",
          "endDate": "2024-10-10 17:18:34",
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "phone"
        }
      ]
    },
    {
      "employeeNumber": 1267,
      "email": "example@mail.com",
      "sessions": [
        {
          "startDate": "2024-10-09 08:12:34",
          "endDate": "2024-10-09 17:18:34",
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "phone"
        },
        {
          "startDate": "2024-10-10 08:12:34",
          "endDate": "2024-10-10 17:18:34",
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "phone"
        }
      ]
    }
  ]
}

רשימת הפסקות lunches

שליפת רשומות הפסקות צהריים לפי טווח תאריכים.

פרמטר	סוג	תיאור
`startDate`	string	תאריך התחלה (YYYY-MM-DD)
`endDate`	string	תאריך סיום (YYYY-MM-DD)
`groupIds`	array	אופציונלי — מסנן לפי מזהי קבוצות

בקשה

{
  "jsonrpc": "2.0",
  "method": "lunches",
  "params": {
    "startDate": "2025-10-08",
    "endDate": "2025-10-15"
  },
  "id": 122
}

תגובה

{
  "jsonrpc": "2.0",
  "id": 122,
  "result": [
    {
      "employeeNumber": 1265,
      "email": "email@mail.com",
      "sessions": [
        {
          "startDate": "2024-10-09 12:12:34",
          "endDate": "2024-10-09 12:48:34",
          "timezone": "Asia/Jerusalem",
          "startSourceType": "web",
          "endSourceType": "phone"
        },
        {
          "startDate": "2024-10-10 12:12:34",
          "endDate": "2024-10-10 12:51:34",
          "timezone": "Asia/Jerusalem",
          "startSourceType": "web",
          "endSourceType": "phone"
        }
      ]
    },
    {
      "employeeNumber": 1267,
      "email": "example@mail.com",
      "sessions": [
        {
          "startDate": "2024-10-09 12:12:34",
          "endDate": "2024-10-09 13:10:34",
          "timezone": "Asia/Jerusalem",
          "startSourceType": "web",
          "endSourceType": "phone"
        },
        {
          "startDate": "2024-10-10 12:12:34",
          "endDate": "2024-10-10 12:28:34",
          "timezone": "Asia/Jerusalem",
          "startSourceType": "web",
          "endSourceType": "phone"
        }
      ]
    }
  ]
}

Timesheet timesheet

שליפת גיליון נוכחות מורחב — כולל סשנים, הפסקות ורשומות עבודה (workLogs) מקוננים.

פרמטר	סוג	תיאור
`startDate`	string	תאריך התחלה (YYYY-MM-DD)
`endDate`	string	תאריך סיום (YYYY-MM-DD)
`groupIds`	array	אופציונלי — מסנן לפי מזהי קבוצות

בקשה

{
  "jsonrpc": "2.0",
  "method": "timesheet",
  "params": {
    "startDate": "2025-10-08",
    "endDate": "2025-10-15"
  },
  "id": 123
}

תגובה

{
  "jsonrpc": "2.0",
  "id": 123,
  "result": [
    {
      "employeeNumber": 1265,
      "email": "email@mail.com",
      "sessions": [
        {
          "startDate": "2024-10-09 08:12:34",
          "endDate": "2024-10-09 17:18:34",
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "phone",
          "lunches": [
            {
              "startDate": "2024-10-09 12:12:34",
              "endDate": "2024-10-09 12:48:34",
              "startSourceType": "web",
              "endSourceType": "phone"
            }
          ],
          "workLogs": [
            {
              "name": "task",
              "externalId": "DR-4258",
              "startDate": "2024-10-09 08:15:34",
              "endDate": "2024-10-09 12:10:34",
              "startSourceType": "web",
              "endSourceType": "phone"
            },
            {
              "name": "task 1",
              "externalId": "DR-4259",
              "startDate": "2024-10-09 12:55:34",
              "endDate": "2024-10-09 17:10:34",
              "startSourceType": "web",
              "endSourceType": "phone"
            }
          ]
        }
      ]
    }
  ]
}

סשנים מורחבים extended-sessions

שליפת נתוני נוכחות מפורטים כולל מידע על העובד, שעות צפויות, היעדרויות ופירוט כל סשן.

פרמטר	סוג	תיאור
`startDate`	string	תאריך התחלה (YYYY-MM-DD)
`endDate`	string	תאריך סיום (YYYY-MM-DD)
`groupIds`	array	אופציונלי — מסנן לפי מזהי קבוצות

בקשה

{
  "jsonrpc": "2.0",
  "method": "extended-sessions",
  "params": {
    "startDate": "2025-01-24",
    "endDate": "2025-01-24"
  },
  "id": 123
}

תגובה

{
  "jsonrpc": "2.0",
  "id": 123,
  "result": [
    {
      "id": 21814,
      "employeeNumber": "31394",
      "email": "s7654321@mail.ru",
      "passport": "Elena21814",
      "groups": [],
      "workStartedAt": "2010-01-03",
      "workEndedAt": null,
      "birthday": "1990-12-13",
      "gender": "female",
      "totalWorkedSeconds": 10956,
      "totalLeaveSeconds": 0,
      "expectedSeconds": 0,
      "expectedHoursPerDay": [
        {
          "date": "2026-01-24",
          "hours": 9
        }
      ],
      "sessions": [
        {
          "startDate": "2025-01-24 12:35:50",
          "startDateSentAt": "2025-01-24 12:35:50",
          "startNote": null,
          "endDate": "2025-01-24 15:38:12",
          "endDateSentAt": "2025-01-24 15:38:12",
          "endNote": null,
          "duration": 10942,
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "web",
          "isAbsence": false,
          "absenceName": null,
          "absenceNote": null,
          "absenceApprovedDate": null,
          "absenceApprovedManager": null,
          "absenceCodeDays": null,
          "absenceCodeHors": null
        },
        {
          "startDate": "2025-01-24 15:38:38",
          "startDateSentAt": "2025-01-24 15:38:38",
          "startNote": null,
          "endDate": "2025-01-24 15:38:52",
          "endDateSentAt": "2025-01-24 15:38:52",
          "endNote": null,
          "duration": 14,
          "timezone": "Asia/Jerusalem",
          "locationType": "office",
          "startSourceType": "web",
          "endSourceType": "web",
          "isAbsence": false,
          "absenceName": null,
          "absenceNote": null,
          "absenceApprovedDate": null,
          "absenceApprovedManager": null,
          "absenceCodeDays": null,
          "absenceCodeHors": null
        }
      ]
    }
  ]
}

מוכנים לחבר?

גישה ל-API זמינה בתוכניות Business ו-Enterprise. הצוות הטכני שלנו ילווה אתכם בתהליך.

בקשת גישה ל-API כל האינטגרציות