ברוכים הבאים למדריך ה-API של TimeClock 365
ממשק ה-API שלנו נועד לאפשר לחברות, לקוחות ומפתחים לחבר את המערכות הארגוניות שלהם ישירות ל-TimeClock 365. באמצעות הממשק תוכלו למשוך נתוני נוכחות, דיווחי כניסה ויציאה, הפסקות צהריים וגיליונות שעות מלאים באופן אוטומטי, מותאם אישית ומדויק.
פרטי התחברות טכניים:
כתובת ה-Base URL
https://live.timeclock365.com/api/v1/json-rpc
מתודת HTTP (HTTP Method)
POST
אימות (Authentication)
כל הבקשות חייבות לכלול טוקן מסוג Bearer בכותרת (Header) של ה-Authorization. ניתן להפיק ולנהל את מפתחות ה-API בלשונית Integrations בלוח הבקרה של TimeClock 365.
Headers Example
Content-Type: application/json
Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
sessions
דיווח כניסה ויציאה (Sessions)
שליפת רשימה של דיווחי נוכחות של עובדים בטווח תאריכים מוגדר.
דוגמת בקשה (Request)
{
"jsonrpc": "2.0",
"method": "sessions",
"params": {
"startDate": "2025-10-08",
"endDate": "2025-10-15"
},
"id": 121
}דוגמת תגובה (Response)
{
"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
רשימת ארוחות צהריים (Lunches)
שליפת רשומות של הפסקות צהריים עבור עובדים במהלך התקופה שצוינה.
דוגמת בקשה (Request)
{
"jsonrpc": "2.0",
"method": "lunches",
"params": {
"startDate": "2025-10-08",
"endDate": "2025-10-15"
},
"id": 122
}דוגמת תגובה (Response)
{
"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)
דוח מקיף הכולל דיווחי כניסה ויציאה, ארוחות צהריים ולוגי עבודה אישיים (משימות) המשויכים לדיווחי נוכחות ספציפיים.
דוגמת בקשה (Request)
{
"jsonrpc": "2.0",
"method": "timesheet",
"params": {
"startDate": "2025-10-08",
"endDate": "2025-10-15"
},
"id": 123
}דוגמת תגובה (Response)
{
"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
דיווח נוכחות מורחב
שליפת נתוני דיווח נוכחות מפורטים הכוללים מטא-דאטה של עובדים כמו סך שעות עבודה, מגדר, יום הולדת וקבוצות.
דוגמת בקשה (Request)
{
"jsonrpc": "2.0",
"method": "extended-sessions",
"params": {
"startDate": "2025-01-24",
"endDate": "2025-01-24"
},
"id": 124
}דוגמת תגובה (Response)
{
"jsonrpc": "2.0",
"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,
"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
}
]
}
],
"id": 124
}
